acctcms(1M)

NAME

     acctcms - command summary from process accounting records

SYNOPSIS

     /usr/lib/acct/acctcms [ -a [-o] [-p]] [-c]  [-j]  [-n]  [-s]
     [-t] filename...

DESCRIPTION

     acctcms reads one or more filenames, normally  in  the  form
     described  in acct(3HEAD). It adds all records for processes
     that executed identically named commands,  sorts  them,  and
     writes them to the standard output, normally using an inter-
     nal summary format.

OPTIONS

     -a    Print output in ASCII rather than in the internal sum-
           mary  format. The output includes command name, number
           of times  executed,  total  kcore-minutes,  total  CPU
           minutes,  total  real  minutes, mean size (in K), mean
           CPU minutes per invocation, "hog  factor,"  characters
           transferred,  and  blocks  read  and  written,  as  in
           acctcom(1). Output is normally sorted by total  kcore-
           minutes.

           Use the following options only with the -a option:

     -o    Output a (non-prime) offshift-time-only  command  sum-
           mary.

     -p    Output a prime-time-only command summary.

     When -o and -p are used together, a  combination  prime-time
     and  non-prime-time report is produced.  All the output sum-
     maries are total usage except number of times executed,  CPU
     minutes,  and  real  minutes, which are split into prime and
     non-prime.

     -c    Sort by total  CPU  time,  rather  than  total  kcore-
           minutes.

     -j    Combine  all  commands   invoked   only   once   under
           "***other".

     -n    Sort by number of command invocations.

     -s    Any file names encountered hereafter  are  already  in
           internal summary format.

     -t    Process all records as total accounting  records.  The
           default internal summary format splits each field into
           prime and non-prime-time parts. This  option  combines
           the prime and non-prime time parts into a single field
           that is the total of both, and provides upward  compa-
           tibility  with old style acctcms internal summary for-
           mat records.

EXAMPLES

     Example 1: Using the acctcms command.

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

     example% acctcms filename ... > today
     example% cp total previoustotal
     example% acctcms -s today previoustotal > total
     example% acctcms -a -s today

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWaccu                    |
    |_____________________________|_____________________________|

SEE ALSO

     acctcom(1),     acct(1M),     acctcon(1M),     acctmerg(1M),
     acctprc(1M),  acctsh(1M),  fwtmp(1M),  runacct(1M), acct(2),
     acct(3HEAD), utmpx(4), attributes(5)

NOTES

     Unpredictable output results if -t  is  used  on  new  style
     internal summary format files, or if it is not used with old
     style internal summary format files.