*** UNIX MANUAL PAGE BROWSER ***

acctcms(8) System Manager's Manual acctcms(8) NAME acctcms - Produces command usage summaries from accounting records SYNOPSIS acctcms [-acjnspot] file ... FLAGS Displays output in ASCII summary format rather than the default binary format. The acctcms command sorts its output in descending order ac- cording to total K-core minutes. The unit K-core minutes is the amount of storage used (in kilobytes) multiplied by the amount of time the buffer was in use. The hog factor is the total CPU time divided by the total real time. The ASCII summary output format has the following headings: The COMMAND NAME column specifies the name of the command. Because only object modules are reported by the accounting system, the sh command entry specifies the entry for all shell processes, regard- less of their actual names. The NUMBER CMDS column specifies the total number of command invocations during the accounting period. The TOTAL KCOREMIN column combines the amount of memory used and the length of time used. Memory is specified in kilobyte blocks, and time is speci- fied in minutes. The TOTAL CPU-MIN column specifies the total CPU time needed to process the command the number of times specified in the NUM- BER CMDS column. The TOTAL REAL-MIN column specifies the total number of real-time minutes needed to process the command the number of times specified in the NUMBER CMDS column. The MEAN SIZE-K column specifies the average amount of memory in kilobytes used to process the command the number of times specified in the NUMBER CMDS column. The MEAN CPU- MIN column specifies the average amount of CPU time that the command used each time it was processed. The mean CPU minutes are obtained by dividing the total CPU minutes by the total number of commands. The HOG FACTOR column specifies the CPU time needed to process the command the number of times specified in the NUMBER CMDS column with respect to the time required to process all commands. This value shows the ratio of system availability to system utilization. The CHARS TRANSFD column specifies the total number of characters that were read or written when the command was processed the number of times specified in the NUMBER CMDS column. The BLOCKS READ column specifies the number of file sys- tem blocks (1 block is equivalent to 1 kilobyte) that were read when the command was processed the number of times specified in the NUMBER CMDS column. The number of blocks read may not correspond with the number of characters transferred. Sorts in descending order according to total CPU time rather than total K-core minutes. Combines all com- mands called only once in the column specified by "***other" in the COMMAND NAME column. Sorts in descending order according to the number of times each command was called. Displays a command summary of non- prime-time commands. Displays a command summary of prime-time com- mands. Assumes that any file specified after this flag is in binary format. Processes all records as total accounting records. The default binary format splits each heading into prime-time and nonprime-time parts. DESCRIPTION The acctcms command outputs data in a format called TOTAL COMMAND SUM- MARY. This command reads each file specified, combines and sorts all records for identically named processes, and writes them in a binary format to the output device. Files are usually organized in the acct file format. When you specify the -o and -p flags together, the ac- ctcms command produces a summary report that combines commands processed during both prime and nonprime time. All the output summaries specify total usage, except for the number of times run, CPU minutes, and real minutes, which are split into prime-time and nonprime-time minutes. EXAMPLES To collect command accounting records from one or more source files into a command summary file called today and to maintain a running to- tal summary of commands in a file called cmtotal, add the following lines to an accounting shell script: acctcms [source File(s) ....] > today cp total prev_tot acctcms -s today prev_tot > cmtotal acctcms -a -s cmtotal First, the acctcms command is used to redirect command records in File(s) that you specify to a file called today. Next, the old total command summary file is renamed prev_tot. Then, the command summary records that are collected in the today and the prev_tot files are redirected to a new command summary file called cmtotal. These are all binary files. The last acctcms command outputs to the default output device the contents of the cmtotal file in the ASCII default command summary format previously described, so that the report may be dis- played. FILES Specifies the command path. This is where prime time is set. Account- ing header files that define formats for writing accounting files. RELATED INFORMATION Commands: acct(8), runacct(8) Functions: acct(2) delim off acctcms(8)