acctcms man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

acctcms(8)							    acctcms(8)

NAME
       acctcms - Produces command usage summaries from accounting records

SYNOPSIS
       acctcms [-acjnspot] file...

OPTIONS
       Displays	 output in ASCII summary format rather than the default binary
       format. The acctcms  command  sorts  its	 output	 in  descending	 order
       according  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 option 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 options together, the
       acctcms command produces a summary report that combines	commands  pro‐
       cessed  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
       total 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.

SEE ALSO
       Commands: acct(8), runacct(8)

       Functions: acct(2)

								    acctcms(8)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net