JCL that you need

The examples in this manual are shown with the necessary JCL. You may need the following JCL to use DFSMSdss:

Statement

Usage

JOB (required)

Initiates your job.

EXEC (required)

Specifies the program name (PGM=ADRDSSU) or, if the job control statements reside in a procedure library, the procedure name. See How to control DFSMSdss through PARM information in the EXEC statement for additional information that can be entered in the PARM parameter of the EXEC statement.

SYSPRINT DD (required)

Defines a sequential message data set. The data set can be written to a system output device, a tape volume, or a direct-access device. If the DCB keyword LRECL is specified on the DD statement, it must be from 84 to 137 inclusive. If the BLKSIZE keyword is specified, it must be at least four greater than LRECL. If LRECL is less than 84, the return code is 8, and an error message is issued. If the specified LRECL is greater than 137, the LRECL and BLKSIZE are set to 137 and 141, respectively.

Note: If the SYSPRINT DD or a temporary message data set resides on a volume that is being processed by DFSMSdss and a secondary allocation is needed for it, the job may result in an S138 abend. This is because the DADSM EXTEND function attempts to enqueue on the volume’s VTOC while DFSMSdss holds the enqueue on that VTOC. To avoid this situation, define the SYSPRINT DD to another volume or use the WORKUNIT or WORKVOL parameters, or both.

SYSIN DD (required)

Defines a command data set containing your DFSMSdss commands. It usually resides in the input stream. However, it can be defined as a blocked or unblocked sequential data set or as a member of a partitioned data set. Records must be fixed format, LRECL=80.

input DD (optional)

Defines the input (also called the source). The ddname, input, is supplied by you and is referred to by your DFSMSdss commands. This DD statement is not required for some operations. Do not specify the BUFNO keyword.

The following example shows an input DD statement that specifies a DASD volume:

//DASD DD UNIT=3380,VOLUME=(PRIVATE,SER=111111),DISP=OLD

See the reference under the INDDNAME, INDYNAM, DDNAME and DYNAM keywords of the various commands (for example, COPY or DUMP) for additional information.

output DD (optional)

Defines the output (also called the target). The ddname, output, is supplied by you and is referred to by your DFSMSdss commands. This DD statement is not required for some DFSMSdss operations. Do not specify the BUFNO keyword. Code a volume count when a new data set will reside on six or more volumes.

Note:

DISP=MOD is not supported for an output DD statement.
For dump operations, the output DD statement describes a sequential data set that DFSMSdss dumps the data to. If this dump data set resides on a DASD volume that is being processed by DFSMSdss and a secondary allocation is needed for it, the job may result in a S138 abend. This is because the DADSM EXTEND function attempts to enqueue on the volume’s VTOC while DFSMSdss holds the enqueue on that VTOC.
For dump operations, the output DD statement can be directed to DUMMY. If you specify DD DUMMY, DFSMSdss does not perform data sets I/O. If you specify DELETE keyword with DD DUMMY, DFSMSdss deletes the input data sets as requested.
If multiple dumps are done in the same step, each dump command should have an output DD statement that refers to a unique JCL DD statement.
The output data set must be a standard format sequential data set and cannot use any extended-format features, such as compression.

The following example shows an output DD statement that specifies a tape volume:

//TAPE DD UNIT=3480,VOLUME=SER=TAPE01,LABEL=(1,SL),
//  DISP=(NEW,CATLG),DSNAME=USER2.DUMP

See the reference under the OUTDDNAME and OUTDYNAM keywords of the various commands (for example, COPY or DUMP) for additional information.

filter DD (optional)

Defines a data set consisting of cards or card-image records that contains the filtering criteria (INCLUDE, EXCLUDE, and BY) to be used in a data set command. The ddname, filter, is supplied by you and is referred to by your DFSMSdss commands.

password DD (optional)

Defines a data set consisting of card-image records that contains data set names and their passwords. The ddname, password, is supplied by you and is referred to by your DFSMSdss commands.

For more information on coding JCL, refer to z/OS MVS JCL Reference.