csacms(1M)                                                          csacms(1M)


NAME
     csacms - summarizes command usage from per-process accounting records

SYNOPSIS
     /usr/lib/acct/csacms [-a [[-p] [-o] [-e]]] [-c] [-j] [-n] [-s] [-S [-A]]
     files

DESCRIPTION
     The csacms command reads the pacct file, sorted pacct files, or files
     that are already in internal summary format depending upon the input
     option.  It adds all records for processes that executed identically
     named commands, and it sorts and writes them to the standard output,
     usually using an internal summary format.

     csacms accepts the following options:

     -a   Prints output in ASCII rather than in the internal summary format.
          You can use the following options only with the -a option:

          -p   Outputs a prime-time-only command summary.

          -o   Outputs a nonprime-time-only (offshift) command summary.

          -e   Outputs an extended report, printing additional fields.

          The default output produced with the -a option includes command
          name, number of times executed, total kcore-minutes, total
          kvirtual-minutes, total CPU minutes, total real minutes, mean core
          size (in K), mean virtual size (in K), mean CPU minutes per
          invocation, the amount of CPU resources (proportional to other
          processes) used, and k-characters read and written, and blocks read
          and written.  Read and written values are printed separately.  The
          output is sorted by total kcore-minutes, unless you specify a sort
          option.

          The high-water usage values for core and virtual memory are
          presented as both a prime-time value and nonprime-time value.

          When you specify both -p and -o with -a, csacms produces a
          combination prime or nonprime time report.

          The extended report prints the following:  high-water core memory
          usage value, high-water virtual memory usage value, the number of
          read and write system calls (printed separately), system time, block
          I/O wait time, raw I/O wait time, and run queue wait time.

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

     -j   Combines all commands invoked only once under ``***other''.


     -n   Sorts by number of command invocations.

     -s   Indicates that any filenames encountered hereafter are already in
          internal summary format.

     -S   Indicates that the sorted pacct file format is used on input.

     -A   Causes all jobs (even nonterminated jobs) to be considered.  You
          must use this option with the -S option.

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

          csacms file ... > today

          cp total previoustotal

          csacms -s today previoustotal > total

          csacms -a -s today

SEE ALSO
     csa(1M), csacom(1), csarun(1M).


                                                                        Page 2