ACCTCMS(8,C)                AIX Commands Reference                 ACCTCMS(8,C)



-------------------------------------------------------------------------------
acctcms



PURPOSE

Produces command usage summaries from accounting records.

SYNTAX

                        +-------------------------+   +------------+
/usr/lib/acct/acctcms---| +- -t ----------------+ |---|   +----+   |--->
                        +-|      +------------+ |-+   +---| -j |---+
                          +- -a -|   +----+   |-+       ^ | -s | |
                                 +---| -o |---+         | +----+ |
                                   ^ | -p | |           +--------+
                                   | +----+ |
                                   +--------+
                                                    +--------+
                                                >---| one of |--- file ---|
                                                    | +----+ | A        |
                                                    +-| -c |-+ +--------+
                                                      | -n |
                                                      +----+
DESCRIPTION

The acctcms command reads the specified files.  It adds all records for
identically named processes, sorts them, and writes them to standard output in
a binary format.  Files are usually in the acct file format described in AIX
Operating System Technical Reference.

When you use the -o and -p flags together, acctcms produces a report that
combines prime- and non-prime time.  All the output summaries are for total
usage except those given for number of times run, CPU minutes, and real
minutes, which are split into prime and non-prime minutes.

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











Processed November 8, 1990       ACCTCMS(8,C)                                 1

ACCTCMS(8,C)                AIX Commands Reference                 ACCTCMS(8,C)



FLAGS

-a      Displays output in ASCII summary format rather than binary summary
        format.  Each output line contains the command name, the number of
        times the command was run, its total kcore-time, its total CPU time,
        its total real time, its mean memory size (in K bytes), its mean CPU
        time per invocation of the command, and its CPU usage factor.  The
        listed times are all in minutes.  acctcms normally sorts its output by
        total kcore-minutes.  The unit kcore-minutes measures the amount of
        storage used (in K-bytes) multiplied by the amount of time it was in
        use.

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

-j      Combines all commands called only once under the heading "***other".

-n      Sorts by the number of times the commands were called.

-o      Displays a command summary of nonprime-time commands only.  You can use
        this flag only with the -a flag.

-p      Displays a command summary of prime-time commands only.  You can use
        this flag only with the -a flag.

-s      Assumes that any named files that follow this flag are already in
        binary format.

-t      Processes all records as total accounting records.  The default binary
        format splits each field into prime and non-prime time sections.

RELATED INFORMATION

See the following commands:  "acct/*,"  "acctcom,"  "acctcon1, acctcon2,"
"acctmerg" and "runacct."

See the acct system call and the acct and utmp files in AIX Operating System
Technical Reference.

See "Running System Accounting" in Managing the AIX Operating System.
















Processed November 8, 1990       ACCTCMS(8,C)                                 2