acctcms(1M)               (Accounting Utilities)                acctcms(1M)


   NAME
         acctcms - command summary from per-process accounting records

   SYNOPSIS
         /usr/lib/acct/acctcms [-a [-p] [-o]] [-c] [-j] [-n] [-s] [-t] 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 internal summary format.  The
         options are:

         -a    Print output in ASCII rather than in the internal summary
               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 compatibility with old (i.e., prior to UNIX
               System V, 4.0) 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 summary.

         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:

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



   8/91                                                                 Page 1

   acctcms(1M)               (Accounting Utilities)                acctcms(1M)


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

   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.











































   Page 2                                                                 8/91