csaperiod - runs periodic accounting
SYNOPSIS
//uussrr//ssbbiinn//ccssaappeerriioodd [--ee MMDDhhmm] [--rr] [--ss MMDDhhmm]
DESCRIPTION
The ccssaappeerriioodd command directs the processing of the daily
consolidated accounting files, which are created by the
csarun(8) command. The csaaddc(8) command merges the
daily files into one file. The csacrep(8) command then
generates a report based on the merged file.
The progress of ccssaappeerriioodd is recorded in the ppddaacctt file.
When an error is detected, a message is written to the
//vvaarr//lloogg//mmeessssaaggeess file, and mail is sent to rroooott and aaddmm.
Further data processing is halted.
The cron(8) command usually initiates ccssaappeerriioodd.
The ccssaappeerriioodd command accepts the following options:
--ee MMDDhhmm
Selects consolidated accounting data generated at or
before the specified date, MMDDhhmm.
--rr Removes the daily data files after processing is
done. The default is to leave the daily data files
in the //vvaarr//ccssaa//ssuumm directory.
--ss MMDDhhmm
Selects consolidated accounting data generated at or
after the specified date, MMDDhhmm.
NOTES
By default, ccssaappeerriioodd processes all the //vvaarr//ccssaa//ssuumm
files. The mail recipients (rroooott and aaddmm) can be changed
by modifying the MMAAIILL_LLIISSTT and WWMMAAIILL_LLIISSTT parameters in
the //eettcc//ccssaa..ccoonnff file.
If the script //uussrr//ssbbiinn//ccssaa..ppuusseerr exists, ccssaappeerriioodd will
execute it via the shell "." command. A possible use of
this user exit would be to generate any site specific
report, which would be appended to the periodic report.
ccssaappeerriioodd will check the return status from "csa.puser".
If the return status is non-zero, execution of csaperiod
will be aborted.
For example, the script could contain:
/usr/bin/local/siterpt > siterpt
pr -h "${SITEHDR} ${SYSNAME} ${BTWMSG}" siterpt >> ${PDRPT}.${DTIME}
the site-generated user exit script. If ccssaappeerriioodd cannot
read the script, it does not handle the error graciously
as it does for other errors. This means the error will
not be logged in the system messages file and the ppddaacctt
file, and no notification email will be sent out.
FILES
//eettcc//ccssaa..ccoonnff CSA
con
fig
u
ra
tion
file
//vvaarr//ccssaa//ffiissccaall//ccmmss..MMMMDDDDhhhhmmmm Peri
odic
com
mand
usage
data
in
ccmmss
record
for
mat
//vvaarr//ccssaa//ffiissccaall//ppddaacccctt..MMMMDDDDhhhhmmmm Peri
odic
con
densed
data
files
//vvaarr//ccssaa//ffiissccaall//rrpprrtt..MMMMDDDDhhhhmmmm Peri
odic
report
files
//vvaarr//ccssaa//nniittee//ppddaacctt Log
file
//vvaarr//ccssaa//nniittee//EE**MMMMDDDDhhhhmmmm Error
mes
sages
files
//vvaarr//ccssaa//ssuumm//ccaaaacctt..MMMMDDDDhhhhmmmm Daily
con
densed
data
files
gen
er
ated
user
exit
script
for
ccssaappee
rriioodd.
SEE ALSO
csacms(8), cron(8), csaaddc(8), csacon(8), csacrep(8),
csarun(8).
Man(1) output converted with
man2html