$L Job - List job output information
Function
To display the number of held or non-held data sets for one or more specified jobs.
Syntax
Parameters
- CMDauth=(auth1{,auth2})
- Only
the jobs that can be affected from the specified remote(s) or node(s)
will be released. The valid specifications are:
- LOCAL|ANYLOCAL
- Only the local devices at the local node can affect the output.
- Nnnnn|nodename
- Only local devices at the specified node can affect the output.
- Rnnnn
- Only the specified remote device can affect the output.
- NnnnnRnnnn|nodename.Rnnnn
- Only the specified remote device at the specified remote node can affect the output.
- destid
- A destid corresponding to any of the above remote devices. Note: Specification of the CMDAUTH filter does not override the authority of the console from which the command is issued; both the authority of the console and the specified CMDAUTH filter must match for the job to be affected.
- HELD
- Specifies that the $HASP891 message displays all the held job output elements for the specified jobs. When specified as a filter, only jobs matching the specified count of held output elements, regardless of class, are displayed.
- Held
- Specifies that the $HASP891 message displays all the held job output elements for one or more specified jobs.
- JC|JOBCORR=job correlator
- Specifies a combination of 1-64 alphanumeric, special (colon, period or underscore) and wildcard characters that can be used to select a subset of jobs that have a matching job correlator. For a description of wildcard characters, refer to Using wildcards.
- JM|JOBMASK=jobmask
- Specifies 1 to 8 alphanumeric, special
($, #, or @) or wildcard characters (or a combination of them) that
can be used to select a subset of jobs whose job name matches this
combination of characters (mask). For a description of wild cards,
see Using wildcards. Note:
- This is a positional parameter. Specify this following the job_id (JOB, STC, or TSU) or JOBQ parameter.
- The JOBMASK parameter is not valid with the ‘jobname ' parameter.
- job
- Specifies 1 to 8 alphanumeric, special ($, #, or @) or wildcard characters (or a combination of them) that can be used to select a subset of jobs whose job name matches this combination of characters (mask).
- ‘job'
- The name of the job that is displayed. This name must appear as coded on the JOB statement and must be enclosed in apostrophes. If more than one job exists with this name, no action is taken.
- Job
- A batch job or range of batch jobs is to be displayed.
- JOBQ|JQ
- Specifies all jobs, STCs, and TSUs across the MAS for processing.
- LONG
- Displays all output information. Only HELD and READY output element counts are displayed if LONG is not specified.
- PAGES
-
- TOTAL
- Displays or filters the total number of records in all output elements.
- HELD
- Displays or filters the total number of records in all held output elements.
- READY
- Displays or filters the total number of records in all ready output elements.
- READY
- Specifies that the $HASP891 message displays all the ready job output elements for the specified jobs. When specified as a filter, only jobs matching the specified count of ready output elements, regardless of class, are displayed.
- Ready
- Specifies that the $HASP891 message displays all the ready job output elements for the specified job(s).
- RECORDS
-
- TOTAL
- Displays or filters the total number of records in all output elements.
- HELD
- Displays or filters the total number of records in all held output elements.
- READY
- Displays or filters the total number of records in all ready output elements.
- OUTGRPS
- Displays the total count of output elements associated with the job regardless of class or hold/ready status.
- Stc
- A started task or range of started tasks is to be displayed.
- Tsu
- A time-sharing user or range of time-sharing users is to be displayed.
Related Commands
To display a job's output data set, see the $DO Job command.
Authority Required
This command requires display authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.
This command requires read security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide.
Processing Considerations
Using the $L command to display output information for a large range of batch jobs, started tasks, or time-sharing users could result in a shortage of console message buffers (CMBS).
Scope
MAS-wide. This command displays information about the entire MAS.
Messages
The $HASP891 message displays the count of output groups.
Examples
1 $l j12
JOB00012 $HASP891 JOB(D15USERC) READY=(A=3),HELD=(NONE)
2 $l j11,h
JOB00011 $HASP891 JOB(D15USER) HELD=(C=1)
JES2 displays the count of held output groups for batch job 11.
3 $l j11,ready
JOB00011 $HASP891 JOB(D15USER) READY=(A=3,B=2,Z=1)
JES2 displays the count of ready output groups for batch job 11.
4 $l j12,long
JOB00012 $HASP891 OUTPUT(SMALLOUT)
$HASP891 OUTPUT(SMALLOUT) READY=(A=1),HELD=NONE
$HASP891 RECORDS=(READY=110,HELD=0),
$HASP891 PAGES=(READY=0,HELD=0)
JES2 displays the number of output groups by class, the number of records, and pages associated with output for job 12.
5 $Ljq,outgrps>1000
JOB00011 $HASP891 OUTPUT(BIGOUT) READY=(A=1257),HELD=NONE
JES2 displays all jobs that currently have over 1000 output groups associated with them.
6 $lj(*),jc=*:*ordernumber123456*
JOB00109 $HASP891 OUTPUT(WIDGETS) READY=(A=1),HELD=NONE
JOB00110 $HASP891 OUTPUT(GADGETS) READY=(A=1),HELD=NONE
JOB00111 $HASP891 OUTPUT(PARTS) READY=(A=1),HELD=NONE
JOB00112 $HASP891 OUTPUT(SUPPLIES) READY=(A=1),HELD=NONE
JES2 displays the count of ready and held output groups for any batch job with a job correlator user portion containing ORDERNUMBER123456.