$ADD PROCLIB(xxxxxxxx)

Function

To define a dynamic PROCLIB concatenation to be used during conversion processing for jobs on this member. Dynamic PROCLIB can override PROCxx DDs in the JES2 start PROC but cannot alter nor delete them.

Syntax


>>-$ADD--PROClib--+-'--proclib--'-------------------+----------->
                  |    .-,---------------------.    |   
                  |    V                       |    |   
                  '-(------+-proclib-------+---+--)-'   
                           '-'--proclib--'-'            

>--+---------------------------+-------------------------------><
   '-| Modification keywords |-'   

Modification keywords

|--+-------------------------------------------------------------------------------------+-->
   |                                                        .-,---------------------.    |   
   |                                                        V                       |    |   
   '-,--DD--+-nn--+------------+-------------------+--=--( ---+-DSName--=--dsname-+-+--)-'   
            |     '- ---+-mm-+-'                   |          +-UNIT--=--unit-----+          
            |           '-*--'                     |          '-VOLser--=--volser-'          
            |    .-,--------------------------.    |                                         
            |    V                            |    |                                         
            '-(------+-nn-+--+------------+---+--)-'                                         
                     '-*--'  '- ---+-mm-+-'                                                  
                                   '-*--'                                                    

>--+---+--------------------------------------------------------|
   '-,-'

Parameters

(proclib)

Specifies the 1-8 character PROCLIB DD name being defined. If a dynamic PROCLIB already exists with this name, the command will fail. DD names of the form PROCxx can be referenced by the JOBCLASS PROCLIB= statement. DD names of any format can be referenced on the JECL /*JOBPARM PROCLIB=ddname statement. If this name matches a DD name in the JES2 start PROC, then this PROCLIB concatenation will be used instead of the one in the JES2 start PROC.

DD(nnn)=

Specifies up to 255 data sets to be concatenated to this PROCLIB DD name. Data sets in this list are compacted after the $ADD command is processed. If you specify DD(1), DD(20), and DD(100) for a new PROCLIB concatenation, the resulting concatenation will have DD(1), DD(2) and DD(3). Though up to 255 data sets can be specified, MVS™ rules limit any data set concatenation to 255 extents. If any data set has more than one extent, then the total number of data sets that can be supported will be reduced.

DSName=jxxx...x

Specifies a 1-44 character data set name which JES2 will include in this PROCLIB concatenation. This must specify a partitioned data set (PDS).

UNIT=hhhh|/hhhh|nnnn|cccccccc

If the PROCLIB data set to be used is not cataloged, then the unit information for the device containing the data set must be specified in one of the following ways:

hhhh | /hhhh

specifies a 3 or 4 digit hexadecimal device number. Device numbers can be specified by any of the following formats:

UNIT=hhh
UNIT=/hhh
UNIT=/hhhh

where hhh and hhhh represent the device numbers. A slash (/) must precede a 4 digit device number.

nnnn

Specifies a device name.

cccccccc

Specifies a 1 to 8 character group name assigned to the device or group of devices that contained the non-cataloged PROCLIB data set to be used.

VOLser=xxxxxx

If the PROCLIB data set to be used is not cataloged, then this specifies a 1 to 6 character volume serial number on which the data set resides.

UNCONDitional

Specifies what action should be taken if one of the data sets cannot be allocated. If UNCONDitional is not specified then if any data set cannot be allocated, the $ADD command is failed. If UNCONDitional is specified, then an error allocating a singe data set is ignored. The data set is not added to the concatenation but it remains assigned to the DD(nnn). If the concatenation is displayed, failed DD(nnn) will display the text 'ALLOCATION FAILED' before the data set name. If all the data sets in a concatenation fail to allocate, then the $ADD command fails regardless of whether UNCONDitional was specified.

Authority Required

This command requires system 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 control security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Processing Considerations

$ADD PROCLIB command processing only ensures that the data sets specified can be allocated. It does not ensure that they actually exist or can be opened and used as a PROCLIB data set. That processing occurs when the PROCLIB is used by a job during conversion processing.

Scope

Single member. The values supplied for this command will be in effect for this member only.

Depending on your installation's setup. however, you might want this command to be applied to all members of the MAS (to ensure a consistent environment across the MAS). If so, you can use the MVS ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

The $HASP319 message displays the current PROCLIB concatenation.

The $HASP003 RC=56 indicates that you are trying to add a PROCLIB concatenation but it already exists.

The $HASP003 RC=91 indicates that the command failed because there was an allocation failure. In this case, additional IKJ message will be issued to describe the allocation error.

Examples

 1 
$add proclib(proc01),dd1=dsn=sys1.proclib,dd2=dsn=test.proclib 
$HASP319 PROCLIB(PROC01)    DD(1)=(DSNAME=SYS1.PROCLIB),       
$HASP319                    DD(2)=(DSNAME=TEST.PROCLIB)

Add a new PROCLIB concatenation PROC01 with 2 data set SYS1.PROCLIB and TEST.PROCLIB

 2 
$add proclib(proc02),dd1=dsn=sys1.proclib,dd2=dsn=junk.proclib,uncond        
IKJ56228I DATA SET JUNK.PROCLIB NOT IN CATALOG OR CATALOG CAN NOT BE ACCESSED
$HASP319 PROCLIB(PROC02)    DD(1)=(DSNAME=SYS1.PROCLIB),                     
$HASP319                    DD(2)=(ALLOCATION FAILED,                        
$HASP319                    DSNAME=JUNK.PROCLIB)

Add a new PROCLIB concatenation with one data set, JUNK.PROCLIB, that does not exist but UNCOND was specified. In this case, the PROC02 DD is an available PROCLIB with only one active data set

 3 
$add proclib(proc99),dd100=dsn=sys1.proclib,dd200=dsn=test.proclib 
$HASP319 PROCLIB(PROC99)    DD(1)=(DSNAME=SYS1.PROCLIB),           
$HASP319                    DD(2)=(DSNAME=TEST.PROCLIB)

This example shows how DD(nnn) is compressed to form a dense list.