ACCTCMS(1M-SysV)    RISC/os Reference Manual     ACCTCMS(1M-SysV)



NAME
     acctcms - command summary from per-process accounting
     records

SYNOPSIS
     /usr/lib/acct/acctcms [options] files

DESCRIPTION
     acctcms reads one or more files, normally in the form
     described in acct(4).  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. The 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).  Output is normally sorted by total kcore-
          minutes.
     -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 filenames 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 compati-
          bility with old (i.e., UNIX System V) style acctcms
          internal summary format records.

     The following options may be used only with the -a option.

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

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

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




                         Printed 1/15/91                   Page 1

ACCTCMS(1M-SysV)    RISC/os Reference Manual     ACCTCMS(1M-SysV)




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

SEE ALSO
     acct(1M), acctcon(1M), acctmerg(1M), acctprc(1M),
     acctsh(1M), fwtmp(1M), runacct(1M).
     acctcom(1) in the User's Reference Manual.
     acct(2), acct(4), utmp(4) in the Programmer's Reference
     Manual.

BUGS
     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.






































 Page 2                  Printed 1/15/91