runacct(1M)       MISC. REFERENCE MANUAL PAGES        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 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  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  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.

     WTMPFIXVerify  integrity  of  wtmp  file,  correcting   date
            changes if necessary.

     CONNECTProduce connect session records in tacct.h format.

     PROCESSConvert process accounting records into tacct.h  for-
            mat.

     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.



              Last change: Job Accounting Utilities             1

runacct(1M)       MISC. REFERENCE MANUAL PAGES        runacct(1M)



     CMS    Produce command summaries.

     USEREXIT
            Any installation dependent accounting programs can be
            included here.

     CLEANUPClean 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 argu-
     ment 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:



              Last change: Job Accounting Utilities             2

runacct(1M)       MISC. REFERENCE MANUAL PAGES        runacct(1M)



          runacct mmdd WTMPFIX

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



















































              Last change: Job Accounting Utilities             3