acctcms(8)                          CLIX                          acctcms(8)



  NAME

    acctcms - Displays a command summary from process accounting records

  SYNOPSIS

    /usr/lib/acct/acctcms [-cjnst] [-a [-po]] file

  FLAGS

    -a   Displays output in ASCII rather than in the internal summary format.
         The output includes the command name, number of times executed, total
         kcore-minutes, total CPU minutes, total real minutes, mean size (in
         1024 byte blocks), mean CPU minutes per invocation, hog factor,
         characters transferred, and blocks read and written, as in the
         acctcom command.  The output is normally sorted by total kcore-
         minutes.  A kcore minute is the average (mean) number of kilobytes of
         memory used, multiplied by the number of minutes the program ran.

    -c   Sorts by total CPU time rather than total core-minutes.

    -j   Combines the statistical output for all commands invoked only one
         time.  This output will appear under the heading of *** other.

    -n   Sorts by number of command invocations.

    -s   Puts any filenames specified after this flag in internal summary
         format.

    -t   Processes all records as total accounting records.  The default
         internal summary format splits each field into prime-time and non-
         prime-time usage.  This flag combines the prime-time and non-prime-
         time usage into a single field that contains the total of both.  It
         also provides upward compatibility with old-style (UNIX System V)
         acctcms internal summary format records.

    The following flags may be used only with the -a flag:

    -p   Produces a prime-time only command summary.

    -o   Produces a non-prime-time only (offshift) command summary.

         Produces a combination prime-time and non-prime-time report when -p
         and -o are used together.  The number of times executed, CPU minutes,
         and real minutes will be summarized into prime-time and non-prime-
         time usage.  All other output summaries will be a combination of the
         prime-time and non-prime-time usage.

  DESCRIPTION

    The acctcms command reads one or more files in the format described in the



  2/94 - Intergraph Corporation                                              1

  acctcms(8)                          CLIX                          acctcms(8)



    acct file.  It counts all occurrences of processes that executed
    identically named commands.  The acctcms command sorts the occurrences,
    and writes them to stdout using an internal summary format.

  EXAMPLES

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

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


  CAUTIONS

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

  DIAGNOSTICS

    The acctcms command will display messages if it cannot open a file or
    allocate enough memory to run.  If you see this message:

    hash table overflow-- increase CSIZE

    you should call support.  This message means that acctcms needs to be
    compiled with a larger CSIZE in order to process this accounting data.

  EXIT VALUES

    The acctcms command returns with a value of 0 if successful.  If
    unsuccessful, acctcms will return one of the following values:

    6   cannot allocate enough memory.

    5   cannot allocate enough memory.

    1   the command line arguments are bad.

  RELATED INFORMATION

    Commands: acct(8), acctcon(8), acctmerg(8), acctprc(8), acctsh(8),
    fwtmp(8), runacct(8), acctcom(8)

    Files: acct(4), utmp(4)

    Calls: acct(2)




  2                                              Intergraph Corporation - 2/94