acctcms(1M)                                              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 (that is, pre-UNIX System V
                   Release 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.




                           Copyright 1994 Novell, Inc.               Page 1

      acctcms(1M)                                              acctcms(1M)


            -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

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

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























                          Copyright 1994 Novell, Inc.               Page 2