acctcms(1M)						  System Administration Commands					       acctcms(1M)

NAME

       acctcms - command summary from process accounting records

SYNOPSIS

       /usr/lib/acct/acctcms [-a [-o] [-p]] [-c] [-j] [-n] [-s]
	    [-t] filename...

DESCRIPTION

       acctcms reads one or more filenames, normally in the form described in acct.h(3HEAD). It adds all records for processes that executed iden-
       tically named commands, sorts them, and writes them to the standard output, normally using an internal summary format.

OPTIONS

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

	     Use the following options only with the -a option:

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

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

	     When -o and -p are used together, a combination prime-time and non-prime-time report is produced.	All the output summaries are total
	     usage except number of times executed, CPU minutes, and real minutes, which are split into prime and non-prime.

       -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 file names 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 style acctcms internal summary format records.

EXAMPLES

       Example 1 Using the acctcms command.

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

	 example% acctcms filename ... > today
	 example% cp total previoustotal
	 example% acctcms -s today previoustotal > total
	 example% acctcms -a -s today

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWaccu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       acctcom(1),  acct(1M),  acctcon(1M),  acctmerg(1M),  acctprc(1M),  acctsh(1M),  fwtmp(1M),  runacct(1M),  acct(2), acct.h(3HEAD), utmpx(4),
       attributes(5)

NOTES

       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.

SunOS 5.11							    22 Feb 1999 						       acctcms(1M)