csacms(1M)csacms(1M)NAMEcsacms - 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''.
Page 1
csacms(1M)csacms(1M)-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 ALSOcsa(1M), csacom(1), csarun(1M).
Page 2
