acctcms

PURPOSE

     Produces command usage summaries from accounting records.

SYNOPSIS
     /usr/lib/acct/acctcms [ flags ] [ file ]

DESCRIPTION

     The acctcms  command reads the specified  files.  It adds
     together  all records  for  identically named  processes,
     sorts  them, and  writes  them to  standard  output in  a
     binary format.  Files are usually in the acct file format
     described in AIX Operating System Technical Reference.

     When  you  use the  -o  and  -p flags  together,  acctcms
     produces a report that combines prime- and nonprime-time.
     All the  output summaries are  of total usage  except for
     number of times run, CPU minutes, and real minutes, which
     are split into prime and nonprime minutes.

     A   typical  sequence   for   performing  daily   command
     accounting and for maintaining a running total is:

       acctcms  file . . .   > today
       cp  total  previoustotal
       acctcms  -s  today  previoustotal  > total
       acctcms  -a  -s  today

FLAGS

     -a    Displays output in ASCII summary format rather than
           binary summary  format.  Each output  line contains
           the command  name, the number of  times the command
           was run, its total  kcore-time, its total CPU time,
           its total  real time,  its mean  memory size  (in K
           bytes),  its mean  CPU time  per invocation  of the
           command,  and its  CPU  usage  factor.  The  listed
           times are  all in minutes.  acctcms  normally sorts
           its output by total kcore-minutes.  The unit kcore-
           minutes  measures the  amount of  storage used  (in
           K-bytes) multiplied by the amount of time it was in
           use.
     -c    Sorts by  total CPU  time rather than  total kcore-
           minutes.
     -j    Combines under the  heading "***other" all commands
           called only once.
     -n    Sorts  by the  number  of times  the commands  were
           called.
     -o    Displays  a command  summary of  nonprime-time com-
           mands only.  You can use this flag with only the -a
           flag.
     -p    Displays a  command summary of  prime-time commands
           only.  You can use this flag with only the -a flag.
     -s    Assumes that any named  files that follow this flag
           are already in binary format.
     -t    Processes all records  as total accounting records.
           The default  binary format  splits each  field into
           prime and nonprime time sections.

RELATED INFORMATION

     The following commands:   "acct,"  "acctcom," "acctcon,"
     "acctmerg,"  "acctprc," "fwtmp," and  "runacct."

     The acct system  call and the acct and utmp  files in AIX
     Operating System Technical Reference.

     "Running System Accounting" in Managing the AIX Operating
     System.