Utilities › TMSPTRS Utility—Maintain Multivolume, Multi-Data Set Chains › Report Description › Job Control Statements

Job Control Statements

//stepname EXEC PGM=TMSPTRS[,PARM='parm']
//STEPLIB  DD  DSN=CAI.CTAPLINK,DISP=SHR
//TMSRPT   DD  SYSOUT=A
//SYSPRINT DD  SYSOUT=A
//SYSUT3   DD  UNIT=SYSDA,SPACE=(same as TMC)        *NOTES
//SYSOUT   DD  SYSOUT=A
//SORTLIB  DD  DSN=SYS1.SORTLIB,DISP=SHR
//SORTWK01 DD  UNIT=SYSDA,SPACE=(CYL,(2,2),,CONTIG)
//SORTWK02 DD  UNIT=SYSDA,SPACE=(CYL,(2,2),,CONTIG)
//SORTWK03 DD  UNIT=SYSDA,SPACE=(CYL,(2,2),,CONTIG)
//SORTWK04 DD  UNIT=SYSDA,SPACE=(CYL,(2,2),,CONTIG)
//SORTWK05 DD  UNIT=SYSDA,SPACE=(CYL,(2,2),,CONTIG)
//SORTWK06 DD  UNIT=SYSDA,SPACE=(CYL,(2,2),,CONTIG)
//TMSUPDTE DD  DSN=tmsupdte.control.statements,
//             DISP=(NEW,CATLG,DELETE),
//             UNIT=unit,SPACE=(space),DCB=BLKSIZE=n*80    *NOTES
//TMSUDSNB DD  DSN=tmsudsnb.control.statements,
//             DISP=(NEW,CATLG,DELETE),
//             UNIT=unit,SPACE=(space),DCB=BLKSIZE=n*80    *NOTES

Notes:

• The BLKSIZE can be any multiple of the LRECL, which is 80. If no BLKSIZE is specified and the release of the operating system supports system determined blocksize, the operating system selects the blocksize. Otherwise the BLKSIZE defaults to 32640 for tape or 8840 for DASD devices.
• The SYSUT3 data set holds a copy of the TMC. It can be blocked, regardless of whether the TMC is blocked or not. The BLKSIZE can be any multiple of the LRECL, which is 340.

Parameter Definitions

If no parameter is specified, all multivolume and multi-data set pointers are analyzed.

ONLYTMC *note

Directs TMSPTRS to analyze only multivolume pointers.

ONLYDSNB *note

Directs TMSPTRS to analyze only multi-data set pointers.

Note: While ONLYTMC and ONLYDSNB will each run faster than without any parameter, the results are not as complete. Some types of errors can only be found when neither parameter is used, which is the recommended way to run TMSPTRS.

ENQ

Reserves the TMC for the length of the copy operation.

Note: If ENQ is used, you must shutdown HSM on all systems that share this TMC.

JCL Considerations

TMSUPDTE DD

Optional DD statement. If present, a sequential data set is created which contains control statements for utility TMSUPDTE, used for initialization or correction of DSN17 and FLAG3 bit TMULTIF (err79 or err83).

TMSUDSNB DD

Optional DD statement. If present, a sequential data set is created which contains control statements for utility TMSUDSNB, used for initialization of field DSNBFVSN (err78).

Note: No output is written to either TMSUPDTE or TMSUDSNB if a parameter of ONLYTMC or ONLYDSNB is used.