acctcms(1M)                                           acctcms(1M)



     NAME
          acctcms  -  command  summary  from  per-process   accounting
          records

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

     DESCRIPTION
          acctcms reads one or more files, normally in the form
          described in acct(4).  It adds records for processes that
          executed identically-named commands, sorts them, and writes
          them to the standard output, normally using an internal sum-
          mary format.  The flag options are:

          -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).  Normally, output is sorted by total
               kcore-minutes.

               You can use the following options only with the -a flag
               option.

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

               -o   Output a nonprime (offshift) time-only command
                    summary.

          Using -p and -o together produces a combination prime and
          non-prime-time report.  The output summaries are total
          usage, except number of times executed, CPU minutes, and
          real minutes; these are split into prime and nonprime.

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

          -j   Combine commands invoked only once under ``***other''.

          -n   Sort by number of command invocations.

          -s   File names encountered hereafter are in internal sum-
               mary format.

          -t   Process all records as total accounting records.  The
               default internal summary format splits each field into
               prime and nonprime-time parts.  This option combines
               the prime and nonprime-time parts into a single field
               that totals both, and is compatible with System V style



     April, 1990                                                     1

     acctcms(1M)                                           acctcms(1M)



               acctcms internal summary format records.

     EXAMPLE
          A typical sequence for daily command accounting and main-
          taining a running total is:

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

     FILES
          /usr/lib/acct/acctcms
          /usr/lib/acct/holidays

     SEE ALSO
          acctcom(1), acct(1M), acctcon(1M), acctmerg(1M),
          acctprc(1M), acctsh(1M), fwtmp(1M), runacct(1M), acct(2),
          acct(4), utmp(4).

     BUGS
          You get unpredictable output if you use -t on new style
          internal summary format files, or if you don't use it with
          old style internal summary format files.































     2                                                     April, 1990