$L Job

Function

To display the number of held or non-held data sets for one or more specified jobs.

Syntax


>>-$L--+-Job--+--+--------------------------------------+------->
       +-JOBQ-+  +-nn--+------------+-------------------+   
       +-JQ---+  |     '- ---+-mm-+-'                   |   
       +-Stc--+  |           '-*--'                     |   
       '-Tsu--'  +-'--job--'----------------------------+   
                 |    .-,--------------------------.    |   
                 |    V                            |    |   
                 '-(----+-+-nn-+--+------------+-+-+--)-'   
                        | '-*--'  '- ---+-mm-+-' |          
                        |               '-*--'   |          
                        +-output-----------------+          
                        '-'--job--'--------------'          

>--+---------------------------------+-------------------------->
   '-| Selection limiting keywords |-'   

>--+-------------------------------+---------------------------><
   '-| Display limiting keywords |-'   

Display limiting keywords

|--+------------+--+---------+---------------------------------->
   '-,--CMDauth-'  '-,--Held-'   

>--+-----------------------------------------------+------------>
   '-,--+-+---+--JC------+--+-=--+--job correlator-'   
        | '-/-'          |  +-^=-+                     
        '-+---+--JOBCORR-'  +->--+                     
          '-/-'             '-<--'                     

>--+----------------+--+---------+--+------------+-------------->
   '-,--+-JM------+-'  '-,--LONG-'  '-,--OUTGRPS-'   
        '-JOBMASK-'                                  

>--+----------+--+----------+--+------------+-------------------|
   '-,--PAGES-'  '-,--Ready-'  '-,--RECORDS-'   

Selection limiting keywords

|--+--------------------------------------------------------+--->
   '-,--+---+--CMDauth--+-=--+--+-cmdauth-----------------+-'   
        '-/-'           '-^=-'  |    .-,-------------.    |     
                                |    V  (1)          |    |     
                                '-(----------cmdauth-+--)-'     

>--+---------+-------------------------------------------------->
   '-,--Held-'   

>--+-----------------------------------------------+------------>
   '-,--+-+---+--JC------+--+-=--+--job correlator-'   
        | '-/-'          |  +-^=-+                     
        '-+---+--JOBCORR-'  +->--+                     
          '-/-'             '-<--'                     

>--+----------------------------------------+--+---------+------>
   '-,--+-+---+--JM------+--+-=--+--jobmask-'  '-,--LONG-'   
        | '-/-'          |  +-^=-+                           
        '-+---+--JOBMASK-'  +->--+                           
          '-/-'             '-<--'                           

>--+------------+--+----------+--+----------+--+------------+---|
   '-,--OUTGRPS-'  '-,--PAGES-'  '-,--Ready-'  '-,--RECORDS-'

Notes:

cmdauth can be coded up to 2 times

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

‘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, SA32-0991.

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&gt;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.