RUNACCT(1M)         RISC/os Reference Manual          RUNACCT(1M)



NAME
     runacct - run daily accounting

SYNOPSIS
     /usr/lib/acct/runacct [mmdd [state]]

DESCRIPTION
     runacct is the main daily accounting shell procedure. It is
     normally initiated via cron(1M).  runacct processes connect,
     fee, disk, and process accounting files. It also prepares
     summary files for prdaily or billing purposes. runacct is
     distributed only to source code licensees.

     runacct takes care not to damage active accounting files or
     summary files in the event of errors. It records its pro-
     gress by writing descriptive diagnostic messages into
     active.  When an error is detected, a message is written to
     /dev/console, mail (see mail(1)) is sent to root and adm,
     and runacct terminates. runacct uses a series of lock files
     to protect against re-invocation. The files lock and lockl
     are used to prevent simultaneous invocation, and lastdate is
     used to prevent more than one invocation per day.

     runacct breaks its processing into separate, restartable
     states using statefile to remember the last state completed.
     It accomplishes this by writing the state name into sta-
     tefile.  runacct then looks in statefile to see what it has
     done and to determine what to process next. states are exe-
     cuted in the following order:

     SETUP     Move active accounting files into working files.

     WTMPFIX   Verify integrity of wtmp file, correcting date
               changes if necessary.

     CONNECT1  Produce connect session records in ctmp.h format.

     CONNECT2  Convert ctmp.h records into tacct.h format.

     PROCESS   Convert process accounting records into tacct.h
               format.

     MERGE     Merge the connect and process accounting records.

     FEES      Convert output of chargefee into tacct.h format
               and merge with connect and process accounting
               records.

     DISK      Merge disk accounting records with connect, pro-
               cess, and fee accounting records.

     MERGETACCT



                        Printed 11/19/92                   Page 1

RUNACCT(1M)         RISC/os Reference Manual          RUNACCT(1M)



               Merge the daily total accounting records in day-
               tacct with the summary total accounting records in
               /usr/adm/acct/sum/tacct.

     CMS       Produce command summaries.

     USEREXIT  Any installation-dependent accounting programs can
               be included here.

     CLEANUP   Cleanup temporary files and exit.

     To restart runacct after a failure, first check the active
     file for diagnostics, then fix up any corrupted data files
     such as pacct or wtmp.  The lock files and lastdate file
     must be removed before runacct can be restarted. The argu-
     ment mmdd is necessary if runacct is being restarted, and
     specifies the month and day for which runacct will rerun the
     accounting. Entry point for processing is based on the con-
     tents of statefile; to override this, include the desired
     state on the command line to designate where processing
     should begin.

EXAMPLES
     To start runacct.

          nohup runacct 2> /usr/adm/acct/nite/fd2log &

     To restart runacct.

          nohup runacct 0601 2>> /usr/adm/acct/nite/fd2log &

     To restart runacct at a specific state.

          nohup runacct 0601 MERGE 2>> /usr/adm/acct/nite/fd2log
          &

FILES
     /etc/wtmp
     /usr/adm/pacct*
     /usr/src/cmd/acct/tacct.h
     /usr/src/cmd/acct/ctmp.h
     /usr/adm/acct/nite/active
     /usr/adm/acct/nite/daytacct
     /usr/adm/acct/nite/lock
     /usr/adm/acct/nite/lockl
     /usr/adm/acct/nite/lastdate
     /usr/adm/acct/nite/statefile
     /usr/adm/acct/nite/ptacct*.mmdd

SEE ALSO
     acct(1M), acctcms(1M), acctcon(1M), acctmerg(1M),
     acctprc(1M), acctsh(1M), cron(1M), fwtmp(1M).



 Page 2                 Printed 11/19/92

RUNACCT(1M)         RISC/os Reference Manual          RUNACCT(1M)



     acctcom(1), mail(1) in the User's Reference Manual.
     acct(2), acct(4), utmp(4) in the Programmer's Reference
     Manual.

BUGS
     Normally it is not a good idea to restart runacct in the
     SETUP state. Run manually and restart via:

          runacct mmdd WTMPFIX

     If runacct failed in the PROCESS state, remove the last
     ptacct file because it will not be complete.











































                        Printed 11/19/92                   Page 3