Previous Topic: Restoring the TMC and Audit Data SetNext Topic: Restoring the TMC with a Noncurrent Backup


Restoring the TMC with the Current Backup

When TMSCOPY is used to restore the TMC, an additional DD statement called RESTART is required. Should the program abend, the data set referenced by RESTART is cataloged and referenced again in any subsequent attempts to execute the TMSCOPY restore operation.

If the TMC has been completely destroyed (all tape jobs abend or CA 1 initialization abends), execute all three steps defined in the job control statements after requesting that the CTS address space release the TMC.

Note: For more information, see the Administration Guide.

In STEP 1, reply to the IEFTMS0 WTOR with the CA 1 system password to deactivate CA 1. In STEP 3, activate CA 1 by replying U.

If the TMC contains invalid data (for example, a DASD restore has restored an old TMC), respond to the IEFTMS0 WTOR to batch activate CA 1. CA 1 must be batch active or inactive to perform the restore. If CA 1 is batch active during a restore, the restore tape is sequence checked and the volume serial number and data set name are compared to the current backup volume serial number and data set name stored in the Control Record on the Audit data set. A return code of 12 is issued if the backup tape is not the most current, primary backup.

//* STEP1 WILL DEACTIVATE OR BATCH ACTIVATE CA 1
//STEP1    EXEC PGM=TMSINIT
//STEPLIB  DD  DSN=CAI.CTAPLINK,DISP=SHR
//TMSRPT   DD  SYSOUT=A
//TEMPAUDT DD  UNIT=SYSDA,
//             SPACE=(TRK,(10,1)),DCB=BLKSIZE=n*96              *NOTES
//TMSPARM  DD  DSN=hlq.CTAPOPTN,DISP=SHR
//* STEP 2 WILL RESTORE THE TMC
//STEP2    EXEC PGM=TMSCOPY,
//             PARM='[DATEFMT=(fmt),]RESTORE'
//STEPLIB  DD  DSN=CAI.CTAPLINK,DISP=SHR
//TMSRPT   DD  SYSOUT=A
//DUMPDD   DD  DSN=latest.backup(either.copy).of.TMC,DISP=OLD
//TMC      DD  DSN=CAI.CA1.TMC,DISP=SHR
//AUDITDD  DD  DSN=CAI.CA1.AUDIT,DISP=SHR
//RESTART  DD  DSN=dsname,DISP=(MOD,DELETE,CATLG),
//             UNIT=SYSDA,SPACE=(TRK,1),
//             DCB=(RECFM=FB,BLKSIZE=n*370)                     *NOTES
//* STEP3 WILL REACTIVATE CA 1
//STEP3    EXEC PGM=TMSINIT
//STEPLIB  DD  DSN=CAI.CTAPLINK,DISP=SHR
//TMSRPT   DD  SYSOUT=A
//TEMPAUDT DD  UNIT=SYSDA,
//             SPACE=(TRK,(10,1)),DCB=BLKSIZE=n*96              *NOTES
//TMSPARM  DD  DSN=hlq.CTAPOPTN,DISP=SHR

Notes:

Parameter Definitions

DATEFMT=(fmt)

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

RESTORE

Indicates the TMC is to be restored and the Audit data set is to be used to post all entries which were made since the last backup was taken.

RESTORE,NOAUDIT

Indicates the TMC is to be restored but the Audit data set is not to be used to update the TMC. Even though Audit records will not be applied, the AUDIT DD statement in the restore JCL must reference a validly formatted Audit data set. This option should not be used without a thorough understanding of the Audit file. You may wish to contact CA 1 Technical Support before using this PARM.

JCL Considerations

RESTART DD

The RESTART DD defines a data set that is to be cataloged if an abend occurs during RESTORE processing. This DD is required for RESTORE operations. If the abend is a system abend such as S813, simply perform the required adjustments, such as a data set name correction, and resubmit TMSCOPY.

A commonly encountered CA 1 abend in RESTORE processing is a U0010. This abend occurs when TMSCOPY encounters a Type 5 Audit record, which is created whenever the TMC has been structurally modified by TMSFORMT or TMSREMOV.

If the reason for the RESTORE is that a TMSFORMT extend operation or TMSREMOV purge operation was invalid, the U0010 abend can be considered normal. Delete the RESTART data set, and execute TMSCOPY to back up the restored TMC image.

In some instances, it may be necessary to capture Audit data written subsequent to the TMSFORMT or TMSREMOV operation. You are advised to contact CA 1 Technical Support in this instance.