Utilities › TMSEXPDT Utility—Reset Expiration Dates in the TMC › Report Description › Job Control Statements

Job Control Statements

//stepname EXEC PGM=TMSEXPDT
//             [,PARM='[DATEFMT=(fmt)][,DSNBS][,TEST][,NODFLT]
//             [,DEBUG][,TESTRDS][,LISTRDS]']
//STEPLIB  DD  DSN=CAI.CTAPLINK,DISP=SHR
//TMSRPT   DD  SYSOUT=A
//SYSPRINT DD  SYSOUT=A
//EARLOUT  DD  DSN=save.tmsexpdt.earlout,
//             DISP=(NEW,PASS,DELETE),
//             UNIT=SYSDA,
//             VOL=SER=VOLSER,
//             SPACE=(CYL,5),
//             DCB=(RECFM=FB,LRECL=376,BLKSIZE=15416)
//SYSIN    DD  *
 (RDS control statements here)
/*

Parameter Definitions

DATEFMT=(fmt)

Specifies the date format to be printed on TMS Report 82. The date pattern indicated by (fmt) is limited to 10 bytes and must be enclosed in parentheses. This parameter is optional. For more information on valid date formats, see Overriding the Preferred Date Pattern.

Note: If a date pattern is defined and then subsequently revised, it may be necessary to reflect the pattern change in the optional preferred date value for EXPDT. If a DATEFMT other than Julian is specified, then the DATEFMT used in the RDS data set must match the DATEFMT used on the PARM statement. Read the caution text on DSN Control Statement Format and then revise the preferred date pattern, as necessary.

DSNBS

Indicates that DSNBs (secondary data sets) that are eligible for RDS override are to be processed. This option causes the volume expiration date to be reset to the new DSNB expiration date if the new RDS date is numerically higher than the volume expiration date. This parameter is optional.

TEST

Process normally, but do not update any TMC records.The EARLOUT data set contains records used for the Batch Expiration Update Listing, but the TMC is not updated. This parameter is optional.

NODFLT

Indicates that the EARLOUT data set will list records with an RDS match only.This parameter is optional.

DEBUG

This parameter can be used to examine the internal entries created from the Retention Data Set (RDS).This parameter is optional.

LISTRDS

This parameter will cause all the RDS rules to be printed, not just with those errors.

TESTRDS

Check the syntax of RDS rules only. The TMC is not examined. No records are written to the EARLOUT ddname. May only be specified with DEBUG or DATEFMT parameter.

JCL Considerations

SYSIN

Defines the Retention Data Set (RDS). It must be composed of fixed-length, 80-byte records. It may be included in the job stream in statement form, stored as a sequential data set, or exist as a member of a partitioned data set. SYSIN DD DUMMY will generate an EARLOUT data set of all data sets which have the eligible for RDS override bit on in FLAG1.