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