Job Control Statements

Utilities › TMSCLEAN Utility—List Scratch, Clean and Scratch Inventory Volumes › Scratch and Clean Relist › Job Control Statements

Job Control Statements

//stepname EXEC PGM=TMSCLEAN,PARM='[TEST,][SCRATCHRELIST]'
//STEPLIB  DD  DSN=CAI.CTAPLINK,DISP=SHR
//TMSRPT   DD  SYSOUT=A
//EARLOUT  DD  DSN=scratch.list.earlout,
//             DISP=(NEW,PASS,DELETE),
//             UNIT=SYSDA,
//             SPACE=(CYL,5),
//             DCB=(RECFM=FB,LRECL=376,BLKSIZE=15416)      *NOTE
[//TMSRPT89    DD SYSOUT=A]
[//SYSIN       DD *]
[VOL=ssssss-eeeeee]
[EXCLUDE=ssssss-eeeeee]
[SCRPOOL=xxxxx]
[FILE1DSN=pattern]

Note: The BLKSIZE can be any multiple of 376.

Parameter Definitions

SCRATCHRELIST: Indicates that all available scratch tapes are to be output to the EARLOUT data set, and subsequently used to produce the Scratch and Clean Relist.

JCL Considerations

SYSIN DD: If the SYSIN DD is found, the TMC is processed based on the volumes specified in the range control statements. If no control statements are coded, the complete TMC is processed. A maximum of 20,000 range control statements is allowed. If the SYSIN DD is not found, then TMSCLEAN processes the complete TMC.
TMSRPT89 DD: If the SYSIN DD is used, this DD must be coded. The range control statements are printed to this DD and any errors that found in the control statements are printed to this DD.

Range Control Statements

VOL=ssssss-eeeeee

The VOL statement is used to select the volumes to be processed based on a starting and ending volume number. A single volume may be specified by only coding a start volume.

SCRPOOL=xxxxx

The SCRPOOL statement is used to select the volumes to be processed based on a scratch subpool name.

FILE1DSN=pattern

The FILE1DSN statement is used to select volumes based on the DSN of the first file on the volume, using standard CA 1 pattern masking. When the FILE1DSN statement is the only selection statement used, the complete TMC will be processed and only volumes that match the specified pattern are processed. If FILE1DSN= statement is used with VOL and/or SCRPOOL statements, then only volumes within the requested ranges that match the pattern are processed.

EXCLUDE=ssssss-eeeeee

The EXCLUDE statement selects the volumes you want to exclude from processing based on a starting and ending volume number. To specify a single volume, code only a start volume.

Start and end volumes must be six digit numbers. If the volume number has five or fewer digits, it must be padded with 0s.

EXCLUDE=001500-001575

The EXCLUDE control statement can be used without a VOL control statement.

Example: The control statement excludes the volser range of 001500-001550 from being processed by TMSCLEAN.

EXCLUDE=001500-001550

Note: If the volumes included match the volumes excluded, the exclude control statement overrides the include control statement.