Forward recovery
CICS® VSAM Recovery for z/OS® fully supports BWO and the log of logs.
- Recognize whether a backup was made with BWO or not. The DFSMShsm ARCXTRCT macro can be used to determine this.
- Use the BWO attributes and recovery point in the ICF catalog. It should use the DFSMSdfp IGWABWO callable service to do this. See An assembler program that calls DFSMS callable services for a sample program.
- Recognize the additional tie-up records on the forward recovery logs and, optionally, recognize tie-up records on the log of logs. These are written so that the forward recovery utility can quickly find the correct position without having to scan the entire forward recovery log.
- Recognize after-images that have already been applied to the data set.
The forward recovery utility should ALLOCATE, with DISP=OLD, the data set that is to be recovered. This prevents other jobs accessing a back-level data set and ensures that data managers such as CICS are not still using the data set.
Before the data set is opened, the forward recovery utility should set the BWO attribute flags to the ‘Forward recovery started but not ended’ state. This prevents DFSMShsm taking BWO backups while forward recovery is in progress. To prevent CICS opening a back-level data set, the utility should perform this state change for all data sets in a system that supports BWO, even if some do not use BWO.
The forward recovery utility should use the BWO time stamp for the data set in the ICF catalog, set by DFSMSdss when the data set is restored, to determine the starting point in the forward recovery log to start the forward recovery.
If forward recovery completes successfully, the utility should set the BWO attributes to the ‘BWO disabled’ state before the data set is closed.
If forward recovery does not complete successfully, the utility should leave the BWO attributes in the ‘Forward recovery started but not ended’ state to ensure that CICS does not open a back-level data set.
- Determine and correct the reason for the failure
- Delete the partially-recovered data set
- Restore the backup copy
- Reattempt forward recovery
Alternatively, if you use a VSAM forward recovery utility that does not update the BWO attributes during forward recovery, you may use these commands to reset the backup-restored-by-DFSMShsm state before subsequent CICS file control access.