$D SUBMITLIB(xxxxxxxx) - Display a $SUBMIT concatenation

Function

To display SUBMITLIB concatenations. SUBMITLIB is the source of JCL that can be processed by the $SUBMIT command.

Syntax

Display limiting keywords

Selection limiting keywords

Data Set Selection Criteria

Parameters

(xxxxxxxx): Specifies the 1- to 8- character SUBMITLIB DD name being displayed. You can also specify wild cards on this parameter. See Using wildcards for additional information.
CREATED: Displays the date and time this SUBMITLIB was created.
DDNAME=xxxxxxxx: Displays the real DD name that is associated with this SUBMITLIB concatenation.
DEBUG: Displays additional information about SUBMITLIB concatenations including concatenations that have been logically deleted.
Note: Because DEBUG automatically triggers a "long" display, you cannot add additional display-limiting parameters on this command, however, you can add selection-limiting parameters.
USEcount=nnn: Displays the current use count for a SUBMITLIB concatenation. A SUBMITLIB is considered in use if a $SUBMIT command is currently submitting a job from the concatenation
DD(nnn)=: Specifies the data sets in the concatenation to be displayed (1-255 or ‘*’).
DSName=jxxx...x: Specifies a 1-44 character data set that is to be matched for filtering.
UNIT=hhhh|/hhhh|nnnn|cccccccc: If the SUBMITLIB data set is not cataloged, specifies the unit value be matched for filtering.
VOLser=xxxxxx: Specifies a 1-6 character volume serial number to be matched for filtering.
PATH=’xxxxxxxx’: Specifies a 1-88 character file system PATH to be matched for filtering.

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.

Scope

Single member. The response to this command will be a display of information about this member only.

Messages

The $HASP736 message displays the current SUBMITLIB concatenation.

The $HASP003 RC=52 indicates that no SUBMITLIBs exist matching the filters specified.

Examples

 1 
$dsubmitlib(prod)                                   
$HASP736 SUBMITLIB(PROD)                          
$HASP736 SUBMITLIB(PROD)                                    
$HASP736                     DD(1)=(DSNAME=IBMUSER.TEST.JCL,
$HASP736                     VOLSER=J2SHR2),                
$HASP736                     DD(2)=(PATH=/u/ibmuser/jcl)

Display SUBMITLIB named PROD.

 2 
$dsublib(prod),debug                                  
$HASP736 SUBMITLIB(PROD)                               
$HASP736 SUBMITLIB(PROD)     USECOUNT=0,DDNAME=$SB00005,        
$HASP736                     CREATED=(2019.078,10:17:33.787307), 
$HASP736                     DD(1)=(DSNAME=IBMUSER.TEST.JCL,     
$HASP736                     VOLSER=J2SHR2),                     
$HASP736                     DD(2)=(PATH=/u/ibmuser/jcl)

Display SUBMITLIB named PROD with additional debug information.

 3         
$dsubmitlib(*),dd(*)=dsn=IBMUSER*                     
          $HASP736 SUBMITLIB(ERROR)                         
$HASP736 SUBMITLIB(ERROR)                                   
$HASP736                     DD(1)=(DSNAME=IBMUSER.TEST.JCL,
$HASP736                     VOLSER=J2SHR2)                 
          $HASP736 SUBMITLIB(PROD)                          
$HASP736 SUBMITLIB(PROD)                                    
$HASP736                     DD(1)=(DSNAME=IBMUSER.TEST.JCL,
$HASP736                     VOLSER=J2SHR2)                 
          $HASP736 SUBMITLIB(TEST)                          
$HASP736 SUBMITLIB(TEST)                                    
$HASP736                     DD(2)=(DSNAME=IBMUSER.TEST.JCL,
$HASP736                     VOLSER=J2SHR2)

Display all SUBMITLIBs that have data set names that start with IBMUSER.