runacct(1M)         UNIX System V(Job Accounting Utilities)         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.  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 progress 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 lock1 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 statefile.  runacct then looks in statefile
      to see what it has done and to determine what to process next.  states
      are executed in the following order:

     SETUP  Move active accounting files into working files.

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

     CONNECT
             Produce connect session records in 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, process, and fee
             accounting records.

     MERGETACCT
             Merge the daily total accounting records in daytacct with the
             summary total accounting records in /var/adm/acct/sum/tacct.




10/89                                                                    Page 1

runacct(1M)         UNIX System V(Job Accounting Utilities)         runacct(1M)


     CMS    Produce command summaries.

     USEREXIT
             Any installation dependent accounting programs can be included
             here.

     CLEANUP
             Clean up temporary files and exit.

      To restart runacct after a failure, first check the active file for
      diagnostics, then fix any corrupted data files, such as pacct or wtmp.
      The lock, lock1, and lastdate files must be removed before runacct can be
      restarted.  The argument mmdd is necessary if runacct is being restarted,
      and specifies the month and day for which runacct will rerun the
      accounting.  The entry point for processing is based on the contents 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> /var/adm/acct/nite/fd2log &

      To restart runacct:
           nohup runacct 0601 2>> /var/adm/acct/nite/fd2log &

      To restart runacct at a specific state:
           nohup runacct 0601 MERGE 2>> /var/adm/acct/nite/fd2log &

FILES
      /var/adm/wtmp
      /var/adm/pacctincr
      /usr/src/cmd/acct/tacct.h
      /usr/src/cmd/acct/ctmp.h
      /var/adm/acct/nite/active
      /var/adm/acct/nite/daytacct
      /var/adm/acct/nite/lock
      /var/adm/acct/nite/lock1
      /var/adm/acct/nite/lastdate
      /var/adm/acct/nite/statefile

SEE ALSO
      acct(1M), acctcms(1M), acctcon(1M), acctmerg(1M), acctprc(1M),
      acctsh(1M), cron(1M), fwtmp(1M), acct(4), utmp(4)
      acctcom(1), mail(1) in the User's Reference Manual
      acct(2) in the Programmer's Reference Manual

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





Page 2                                                                    10/89

runacct(1M)         UNIX System V(Job Accounting Utilities)         runacct(1M)


           runacct mmdd WTMPFIX

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


















































10/89                                                                    Page 3