Why uakpacct and|or acctcom?

Last Update 2000-05-07 by kcarlson

Why `uakpacct` and|or `acctcom`?

(Comparison - Overview - uakpacct summary)

**Comparison of `uakpacct` and `acctcom` Options**
	uakpacct	Unicos	Irix	Digital Unix	Filtering\|Selection Options (and `uakpacct` differences)
*					indicates Unicos specific option
	-file	args	args	args	specify input files
	-user	-u	-u	-u	Allows multiple userids
	-uid				Allows multiple uids
	+user				Excludes userid(s)
	-group	-g	-g	-g	Allows mulitple groups
	-gid				Allows multiple uids
	+group				Excludes group(s)
	-time	-S	-S	-S	All: starting after
	+time	-e	-e	-e	All: starting before (existing before)
	-Time	-E	-E	-E	All: ending before
	+Time	-s	-s	-s	All: ending after (existing after)
	-at				Exact start\|end time (+/- seconds)
	-date				date starting at\|after
	-Date				date starting at\|before
	+date				date ending at\|before
	+Date				date ending at\|after
	-tty	-l	-l	-l	Allows multiple, specified differently
	+tty				Excludes ttys
	-command	-n	-n	-n	Allows multiple, simpler patterns
	+command				Excludes commands
	-aflag				Selects on accounting flag
	-signal				Selects on exit signal type
*	-jobid	-j			Allows multiple
*	-pid				Select by pid(s)
*	-seqno				Select by seqno(s)
	-cpu	-C	-C	-C	All: CPU exceeding
	-CPU	-O	-O	-O	All: System CPU exceeding
	-cio	-I	-I	-I	All: character I/O exceeding
	-brw				Block I/O exceeding
	-lapsed				Elapased time exceeding
	-or				'or' vs. 'and' filters
	-rate	-H	-H	-H	Expressed as pct.
*	-Record				Selects record types
	uakpacct	Unicos	Irix	Digital Unix	Display Options (and `uakpacct` differences)
	-binary	-o	-o	-o	All: specify binary output file
		-b	-b	-b	Read file backward
	-nolookup	-U			numeric uid (faster)
	-lookup	-G			Default is numeric w/uakpacct
	-output				Specify output file
	-mgmt	-h	-h	-h	Pct. vs Fractional "hog factor"
	-80				short report (defaults 132 columns)
	-verbose				verbose (file statistics, etc)
	-Start	-X			Display start date
		-Y			optional end date display
	-End				End time vs. elapsed time
	-event				Two records: start and end
*	-xcpu	-y			Connect and system call time
*	-mpp	-P			MPP detail
*	-mut	-B			Multi-tasking detail
		-a	-a	-a	show averages
	(default)	-c			optional print of logical io
	(default)	-f	-f	-f	optional print fork/exec flag
	(default)	-i	-i	-i	optional print of physical io
		-k	-k	-k	optional kcore-minutes vs. size
		-m	-m	-m	optional mean core (defulat)
*	(default)	-p			optional pid and ppid
		-q	-q	-q	optional averages only (no detail)
		-r	-r	-r	optional user/(sys+user) cpu time
	(default)	-t	-t	-t	optional cpu breakdown (sys\|user)
		-v	-v	-v	excludes column headings
*		-w			optional wait times
*		-A			optional acid display
*	(default)	-J			optional jobid display
*		-M			additional memory information
*		-N			optional nice field value
*		-T			end-of-job data

Overview (Comparison - `uakpacct` summary)

Both uakpacct and acctcom report from the pacct files, why would one want both?
The uakpacct was first written on a system with a very restrictive acctcom with almost no filtering (selection) options. In addition, the dates produced by acctcom are rather Anglified and very unfriendly for parsing in scripts. Under Unicos[/mk] there are numerous acctcom enhancements over other UNIX variants.

Why would one want to stay entirely with acctcom:

provided by vendor
more print display choices (specific columns)
uakpacct expects one to work with a 132 column screen by default

Why would one want to use uakpacct:

better filtering options (even than Unicos[/mk]):
- select by date
- select by multiple user, group, command criteria
- select by pid(s) or seqno(s)
- exclude by various criteria
better date formatting
ability to interpret and filter nqacctfiles
source provided to customize as needed

If one intended uakpacct to replace acctcom they would want to enhance the print options, allow date-time formats to be specified (like uals), and synchronize the options somewhat better with acctcom. However, there are better things to do with my time in my immediate future.

`uakpacct` Summary (Comparison - Overview)

Following is what displays with a "uakpacct -?", the Cray specific options are marked with an "*". The default file name is platform specific as well. For additional information see 'man uakpacct'.

uakpacct v2.9           Dump a /var/adm/pacct* file

  -file        String(2) file to report from (-1 to request)      Default:
        Default         -f /var/adm/pacct
        Example         -f "`ls -t /var/adm/Spacct*0308`"

  -nolookup      Flag(2) do not lookup uid->userid                Default:False
                              (*much* faster execution
  -lookup        Flag(3) lookup gid->group (default is faster)    Default:False

  -uid            Int(4) uid  (userid) to report on               Default:-1
  -gid            Int(4) gid  (group)  to report on               Default:-1
  -user        String(2) user (userid) to report on               Default:
                              comma separated for multiple (or'd)
  +user        String(2) user (userid) to exclude                 Default:
  -group       String(2) group (name)  to report on               Default:
                              comma separated for multiple (or'd)
  +group       String(2) group (name)  to exclude                 Default:
* -jobid       String(4) jobid(s) to report on                    Default:
* -pid         String(4)   pid(s) to report on                    Default:
* -seqno       String(4) seqno(s) to report on (NQS)              Default:
  -cpu            Int(4) cpu >Nseconds to report on               Default:-1
  -CPU            Int(4) sys >Nseconds to report on               Default:-1
  -cio            Int(4) io  >N m-char to report on               Default:-1
  -brw            Int(4) io  >N blocks to report on               Default:-1
  -lapsed         Int(2) min. elapsed  to report on               Default:-1
  -command     String(2) command name  to report on               Default:
                              comma separated for multiple (or'd)
  +command     String(2) command name  to exclude                 Default:
  -tty         String(3) tty (hex name) to report on              Default:
                              comma separated for multiple (or'd)
  +tty         String(3) tty (hex name) to exclude                Default:
  -aflag          Oct(3) acct'ing flag to report on (octal)       Default:o377
  -signal         Hex(3) termination signal to report (hex)       Default:xff
  -time        String(2) start time:  starting after              Default:
  -Time        String(2)   end time:  ending before               Default:
  -date        String(2) start date (default is first found)      Default:
  -Date        String(2)   end date (default is none)             Default:
  +time        String(2) start time:  starting before             Default:
  +Time        String(2)   end time:  ending after                Default:
  +date        String(2) start date (default is first found)      Default:
  +Date        String(2)   end date (default is none)             Default:
  -at             Int(3) exact start/end time (within value)      Default:-1
  -or            Flag(3) 'or' comparisons vs. 'and'               Default:False
  -rate           Int(2) cpu pct threshhold                       Default:-1
                              default for -mgmt is 1% (-rate 1)

* -Record      String(2) Record type selection where:             Default:pnto
*                             *(all)   p(pacct) c(confg) n(nqs)
*                             t(tape)  s(job_s) e(job_e) o(other)
*                             r(performance records)
*                             x(extra, non-interpreted for report)
* -xcpu          Flag(2) report connect and system call times     Default:False
* -mpp           Flag(4) display mpp detail (cpu & io per-pe)     Default:False
* -mut           Flag(4) display multi-tasking detail             Default:False

  -binary      String(4) binary output file specification         Default:
  -output      String(4) report output file specification         Default:
  -event         Flag(2) event reporting (write start & end)      Default:False
  -End           Flag(2) end time display (vs. elapsed time)      Default:False
  -mgmt          Flag(2) 'management style' report                Default:False
  -80            Flag(2) short (<80 columns) report               Default:False
  -Start         Flag(2) display start date even if = end date    Default:False
  -verbose       Flag(2) verbose option                           Default:False

In the above, the column with values like "Flag(2)" indicates the type of information the option requires and the number in parenthesis "(n)" indicates the minimum number of characters required to specify the option. For example, "-v" is a flag (flags have no values) for the "verbose" option. Each option is specified separately.