runacct(1M)      SYSTEM ADMINISTRATION COMMANDS       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.

          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.




                                                                1

runacct(1M)      SYSTEM ADMINISTRATION COMMANDS       runacct(1M)



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

          CMS         Produce command summaries.

          USEREXIT    Any installation dependent accounting  pro-
                      grams 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 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




                                                                2

runacct(1M)      SYSTEM ADMINISTRATION COMMANDS       runacct(1M)



NOTES
     Normally it is not a good idea to  restart  runacct  in  the
     SETUP state.  Run SETUP 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.















































                                                                3