Parameter description for PROCLIB
- xxxxxxxx
- Specifies the 1-8 character PROCLIB DD name being defined. 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.
If the PROCLIB DD name matches a static PROCLIB DD name from the JES2 PROC, the PROCLIB statement will logically alter the existing static PROCLIB, not replace it.
Modification: $T PROCLIB(xxxxxxxx) command, warm start or hot start.
- DD(nnn)=
- Specifies up to 255 data sets to be concatenated to this PROCLIB
DD name. Data sets in this list are compacted after each initialization
statement is processed. If you specify DD(1), DD(20), and DD(100)
for a new PROCLIB concatenation, the resulting concatenation will
be renamed to DD(1), DD(2,) and DD(3). If you then set the data set
name for DD(2) to null, JES2 will remove it from the concatenation
leaving just DD(1) and DD(2) where DD(2) has the old DD(3) data set
specification. 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.
Modification: $T PROCLIB(xxxxxxxx) command, warm start or hot start.
- DSName=jxxx...x
- Specifies
a 1-44 character data set name which JES2 will include in this PROCLIB
concatenation. This data set must be a partitioned data set (PDS).
If this value is coded as null (no operand specified), then the DD(nnn)
will be deleted from an existing concatenation.
Modification: $T PROCLIB(xxxxxxxx) command, warm start or hot start.
- UNIT=hhhh|/hhhh|nnnn|cccccccc
- If
the PROCLIB data set to be used is not cataloged, then you must specify
the unit information for the device containing the data set in one
of the following ways:
- hhhh | /hhhh
- specifies a 3 or 4 digit hexadecimal device number. Device numbers
can be specified in one of the following formats:
- UNIT=hhh
- UNIT=/hhh
- UNIT=/hhhh
- nnnn
- Specifies a device name.
- cccccccc
- Specifies a 1-8 character group name assigned to the device or
group of devices that contained the non-cataloged initialization data
set to be included.
Modification: $T PROCLIB(xxxxxxxx) command, warm start or hot start.
- VOLser=xxxxxx
- If
the PROCLIB data set to be used is not cataloged, then this specifies
a 1-6 character volume serial number on which the data set resides.
Modification: $T PROCLIB(xxxxxxxx) command, warm start or hot start.
- UNCONDitional|CONDitional
- Specifies
what action JES2 should take if one of the data sets cannot be allocated.
If CONDitional is specified (or defaulted) then if any data set cannot
be allocated, the entire statement fails. The system will go into
console mode to allow the operator to correct the statement. If UNCONDitional
is specified, then an error allocating a single 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
statement fails regardless of whether UNCONDitional was specified.
Modification: $T PROCLIB(xxxxxxxx) command, warm start or hot start.
- NAME=xxxxxxxx
- Intended
mostly for $T command, NAME= allows the name of a dynamic PROCLIB concatenation to be changed. For example,
specifying PROClib(TEST01) NAME=PROC01 renames the TEST01 PROCLIB
concatenation to PROC01.
You cannot rename a static PROCLIB. If a static PROCLIB is overridden by a dynamic PROCLIB, renaming the dynamic PROCLIB will restore the static PROCLIB. In the above example, if PROC01 started as a static PROCLIB, and TEST01 was renamed PROC01, then the statement PROCLIB(PROC01) NAME=TEST01 would rename the dynamic PROCLIB back to TEST01 and restore to active status the static PROC01 concatenation.
Modification: $T PROCLIB(xxxxxxxx) command, warm start or hot start.