z/OS MVS JCL Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Parameters on STEPLIB DD statements

z/OS MVS JCL Reference
SA23-1385-00

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.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014