csajrep(1M) csajrep(1M) NAME csajrep - 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. -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. -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 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 ALSO csabuild(1M), csarun(1M). Page 4