Utilities › TMSMERGE Utility—Merge TMC Data › Merge Procedure (without using AIVS or foreign control statements) › Job Control Statements

Job Control Statements

//stepname EXEC PGM=TMSMERGE
//             [,PARM='[DATEFMT=(fmt)][,TEST][,RESTART][,DEFAULT][,FAST]']
//STEPLIB  DD  DSN=CAI.CTAPLINK,DISP=SHR
//TMSRPT   DD  SYSOUT=A
//IMPORT   DD  DSN=CAI.CA1.EXPORT,DISP=(OLD,KEEP),UNIT=TAPE
//PURGE    DD  DSN=CAI.CA1.PURGE,DISP=(NEW,KEEP),UNIT=TAPE,
//             DCB=BLKSIZE=n*366                                *NOTE
//SYSIN    DD  *
(control statements here)
/*

Note: The BLKSIZE may be any multiple of the LRECL, 366. If no BLKSIZE is specified, the BLKSIZE for PURGE defaults to 32574 for tape or 8784 for DASD devices.

Parameter Definitions

DATEFMT=(fmt)

Specifies the date format to be printed on TMS Report 51. 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

TEST

Prevents actual updating of the receiving TMC.

RESTART

Compares receiving TMC records with sending records until the first discrepancy. Begins updating at this point.

DEFAULT

Turns on the 'eligible for RDS override' (Flag1=x’01’) bit for new TMC records being merged into the TMC. If there is a matching RDS rule, this flag allows MSEXPDT to override the EXPDT currently on the tape. Review your RDS rules to verify that the new EXPDT is applied to the tape files that are merged into the existing TMC. Because the RDS override indicator is turned on for all merged files, you must define all file rules in the RDS.

FAST

Eliminates the first pass of the import data set and significantly reduces processing time. However, you must ensure that enough free DSNB and Audit records exist for TMSMERGE to process both import TMC record and target TMC record updates. Without this PARM, TMSMERGE determines if enough DSNB and Audit records exist in the first pass before the actual updates are made in the second pass. This PARM is not valid with PARM=TEST.

JCL Considerations

TMSRPT DD

Refers to the merge report.

PURGE DD

Refers to the before image of the TMC records updated on the receiving TMC. If the restart is in progress, the disposition should be changed to MOD and the volume serial number added.