LJ Command: List Job Status

To list the job status information from the job tracking data set (TRAKFILE), use the LJ command.

Type: General command

This command has the following format:

LJ job
   [ALL]
   [STEPS]
   [SUBMIT]
   [PNODE]
   [STATUS]
   [DUEOUT]
   [EXTENDED|X]
   [DUMP]

job

The job operand indicates a full name (job name), job number or both. The full name represents 64-character job names. For a complete definition, see the Full name in the Glossary.

You can specify a job name followed by a job number in parentheses. When the job operand is only numeric, it is considered a job number. Otherwise, it is considered a job name.

When you specify a JES job number that both a job and a started task share, the LJ command displays the most recently executed.

Specify a job name when you specify a JES job number because JES job numbers are reused. In particular, avoid using the job number that is obtained from the output of the LTJ command as the job number for the LJ command. The job number that is obtained from the output of the LTJ command may have been reused and assigned to a different job.

ALL

Displays all the information for the job. The ALL operand is the same as specifying STEPS, SUBMIT, PNODE, and INFODATA.

STEPS

Displays statistics for the job steps.

SUBMIT

Displays the job submission information, including the JCL source data set, Event name, and data set trigger name (if any). This information is available only if z/OS Agent submitted the job.

PNODE

Displays the pnodes for each job.

STATUS

Displays the status of the job.

DUEOUT

Displays pnode dueout times for the job.

EXTENDED or X

Displays detailed date and time information.

DUMP

Displays job records from the job tracking data set in hexadecimal format for diagnosing problems.

z/OS Agent can track the progress of all jobs or selected jobs, even jobs it did not schedule. Real-time information is provided for each job step, including stepname, completion code, CPU time, elapsed time, and number of tape mounts.

You can request z/OS Agent to track jobs, started tasks (STCs), TSO users (TSUs), and system messages.

The LJ command displays information from the tracking file (TRAKFILE). The amount of data that is stored in this file depends on its size. The TRAKFILE slots are reused as required.

Related Information

For information on displaying tracked jobs, see the LTJ Command.

For information on the job tracking, see the Installation and Configuration Guide.

Example: List a Specific Job

This example shows how to display the status of PAYJOB1.

LJ PAYJOB1 STATUS

Example: List a Job by the JES Number and Full Name

This example shows how to display the status of job PAYJOB2.SPECIALACCOUNTINGJOB, whose JES job number is 1234.

LJ PAYJOB2.SPECIALACCOUNTINGJOB(1234)

Example: List Step-Level Statistics

This example shows how to display step-level statistics.

LJ PAYJOB2 STEPS

Example: Display Job Status Information

This example shows how to display the date and time information for PAYJOB4 using the EXTENDED or X operand of the LJ command.

LJ PAYJOB4 X
PAYJOB4 J08324, IN OUTPUT QUEUE SINCE 16.01.03 28JAN, CC 0
SUBMITTED BY ESP AT 16.01.03 ON WED 28JAN, EVENT CATST.PAYROLL
JCL FROM CATST.JCL.CNTL(PAYJOB4)
PROGRAMMER USR01, ACCOUNT CAB3000
JOB IS IN APPL PAYROLL
STEPNAME-PROCSTEP-PROGNAME--EXCP-#T-S-N-CPU-TIME-SUNITS-REGION-CMPC
S1                IEFBR14      0  0 0 0  0:00.02    168     4K    0
PNODE----OUT------DATE--QTIME-POST_BY--SYS-
INPUT    16.01.02 28JAN     0          SYSA
EXEC     16.01.03 28JAN     1 SYSTEM   SYSA
OUTPUT     *            10M54