When retrieving a cataloged library: - Code the DSNAME parameter.
- Code the DISP parameter. The status subparameter must be OLD
or SHR. The disposition subparameters should indicate what you want
done with the private library after its use in the job step.
- Do not code VOLUME or UNIT.
When retrieving a library passed from a previous step: In the passing job step, code a DISP disposition subparameter
of PASS when a step library is to be used by subsequent steps in the
job.
In a receiving step:
- Code in the DSNAME parameter either the name of the step library
or a backward reference of the form *.stepname.STEPLIB. If the step
library is defined in a procedure, the backward reference must include
the procedure step name: *.stepname.procstepname.STEPLIB.
- Code the DISP parameter. The status subparameter must be OLD.
The disposition subparameters should indicate what you want done with
the private library after its use in the receiving step.
When retrieving a library that is neither cataloged nor passed:- Code the DSNAME parameter.
- Code the DISP parameter. The status subparameter must be OLD
or SHR. The disposition subparameters should indicate what you want
done with the private library after its use in the job step.
- Code the UNIT parameter.
- Code the VOLUME parameter.
When creating a library:- Code the DSNAME parameter to assign the library a name.
- Code the UNIT parameter. The library must be allocated to a direct
access device.
- Code a VOLUME parameter, unless a nonspecific request is to be
made for any volume.
- Code the SPACE parameter, allowing enough space for the entire
library on one direct access volume. Specify space for the PDS directory.
- Code a DISP parameter. The status is NEW. Code CATLG as the
disposition, if you intend to keep the library you are creating. Code
PASS as the disposition, if you wish the library to be available to
a following step. Note that you must code a disposition; otherwise,
the system assumes DELETE and deletes the library at the end of the
step.
Note: Do not use VSAM for a STEPLIB library.
When adding members to the library: - In the DSNAME parameter, follow the library name with the name
of the program being added to the library. For example, DSNAME=LIBRARY(PROGRAM).
- Code the status in the DISP parameter as MOD. If the library
is cataloged, do not code a disposition. Otherwise, code PASS or
CATLG.
- If the library is cataloged, do not code unit and volume information.
Otherwise, code UNIT and VOLUME.
- Do not code a SPACE parameter. The STEPLIB DD statement requests
space for the entire library.
Other parameters: Code the DCB parameter if complete
data control block information is not contained in the data set label.
Do not specify FREE=CLOSE; CLOSE is ignored.