csajrep(1M)csajrep(1M)NAMEcsajrep - prints a job report from the sorted pacct file
SYNOPSIS
/usr/lib/acct/csajrep [-s file] [-b] [-c] [-h] [-q] [-t] [-w] [-x] [-A] [-B] [-F] [-J] [-L] [-S] [-T] [-Z]
/usr/lib/acct/csajrep [-s file] [-j jid] [-n seqno] [-p prid] [-u uid] [-b] [-c] [-e]
[-h] [-q] [-t] [-w] [-x] [-A] [-B] [-J] [-L] [-S] [-T] [-Z]
/usr/lib/acct/csajrep [-s file] -N [-A]
DESCRIPTION
The csajrep command reports job accounting information from the sorted
pacct file, which is created by the csabuild(1M) command.
The csajrep command accepts the following three types of options: input,
selection, and printing. If you omit the options, input is read from
/var/adm/acct/work/spacct and all records from each completed job are
reported. You can select a subset of jobs by specifying the user ID,
project ID, job ID, Network Queuing System (NQS) sequence number, or
workload management request ID for which you seek accounting information.
Input Options
The following option specifies an input file for the job accounting
report:
-s file Specifies the name of the sorted pacct file created by
csabuild(1M). The default file is /var/adm/acct/work/spacct.
Selection Options
By default, the -j, -n, -p, and -u selection options report entire jobs.
The -e option limits the report to records that match the selection
criteria. The -e option must be used with at least one of the following
options: -j, -n, -p, or -u. You cannot specify the -F option in
combination with any of the following options: -j, -n, -p, or -u.
Otherwise, the csajrep command accepts the following selection options:
-e Selects only the records that meet the selection criteria as
defined by the -j, -n, -p, and -u options. The -e option must
be used with at least one of these four options. By default,
csajrep outputs all of the records from jobs that contain at
least one record that meets the selection criteria.
-j jid Specifies a (numeric) job ID. The job ID must be specified in
hexadecimal. The "0x" prefix or "0X" prefix are optional.
-n seqno Specifies an NQS sequence number or workload management request
ID.
Page 1
csajrep(1M)csajrep(1M)-p projid Specifies a numeric project ID or project name.
-u uid Specifies a numeric user ID or a user login name.
-F By default, -F displays all records for completed jobs. This
option cannot be used with any of the following options: -e,
-j, -n, -p, and -u. When -F is used with the -A option, all
records for both active and completed jobs are reported. When
-F is used with the -Z option, all records are reported except
those with a job ID (jid) of 0.
-N Selects only NQS or workload management requests. Information
about each segment of a request is reported by jobid, user_id,
and project_id combination. This option can only be used with
the -A and -s options.
-Z Ignores records for which the job ID is equal to 0.
Printing Options
The csajrep command accepts the following printing options:
-b Reports system billing unit (SBU) usage.
-c Reports system and user CPU usage.
-h Suppresses report headings.
-q Reports the run queue wait time; for NQS and workload
management records, reports the queue wait time and queue type.
-t Prints summary information.
-w Reports the block I/O wait time, raw I/O wait time, high-water
core memory usage value, and high-water virtual memory usage
value.
-x Reports the number of k-characters read and written, the number
of blocks read and written, and the number of read and write
system calls. The read and written values are printed
separately.
-A Reports both active and completed jobs. By default, only
completed jobs are reported.
-B Reports process and job starting times.
-J Reports job ID.
-L Puts form feeds at the end of each job.
Page 2
csajrep(1M)csajrep(1M)-S Reports the array session handle.
-T Prints only summary information for each job.
NOTES
A job may contain multiple user IDs and project IDs, because the user may
have executed commands such as su(1) or newproj(1). Also, NQS and
workload management jobs have multiple job IDs when the request is rerun.
The start-of-job and end-of-job records do not contain project IDs.
Thus, when the -e and -p options are used together, no start-of-job or
end-of-job information is reported.
Only NQS or workload management information is reported when the -e and
-n options are used together, because only NQS accounting records contain
the sequence number and workload management accounting records contain
the request ID.
Accounting records sometimes have a job ID of 0 when Comprehensive System
Accounting (CSA) cannot determine the correct job ID.
When the -u option is used without the -e option, all records for jobs
containing at least one accounting record for the specified user are
displayed.
For example, if user1 executes the command rsh sgi who from a remote
host, then the command /usr/lib/acct/csajrep -u user1 -JBc -s spacct
would produce output similar to:
JOB PROJECT LOGIN COMMAND START USER-TIM SYS-TIM
ID NAME NAME NAME TIME [SECS] [SECS]
============= ======== ======== ======== ==================== ======== ========
0x146 Xydev user1 who Jan 7 13:28:02 2000 0.004 0.008
0x146 System root rshd Jan 7 13:28:02 2000 0.004 0.014
The rshd(1M) command was executed by root on behalf of user user1; thus
it is reported by the csajrep-u option.
When used with -u, the -e option suppresses the printing of all
accounting records which are not for the specified user. In the previous
example, the command /usr/lib/acct/csajrep -eu user1 -JBc -s spacct would
produce output similar to:
JOB PROJECT LOGIN COMMAND START USER-TIM SYS-TIM
ID NAME NAME NAME TIME [SECS] [SECS]
============= ======== ======== ======== ==================== ======== ========
0x146 Xydev user1 who Jan 7 13:28:02 2000 0.004 0.008
Page 3
csajrep(1M)csajrep(1M)EXAMPLES
Example 1: The following example generates a list of commands by job
that user jdoe executed. The list includes job ID, start time, and both
terminated and nonterminated jobs in the output:
csajrep-u jdoe -ABJ
Example 2: The following example prints information about NQS job 4140:
csajrep-n 4140 -BJcqtwx
SEE ALSOcsabuild(1M), csarun(1M).
Page 4
