IBM SC34-7012-01 manual Shutdown and restart, Data set backup and restore, Controlled shutdown

Shutdown and restart

The way CICS closes files is determined by whether the shutdown is controlled, immediate, or uncontrolled.

Controlled shutdown

During a controlled shutdown, CICS closes all open files defined in the FCT. This ensures that, for files that are open for update and eligible for BWO, the BWO attributes in the ICF catalog are set to a ‘BWO disabled’ state

If a failure occurs during shutdown so that CICS is unable to close a file, CICS issues warning message DFHFC5804. In this case, check the BWO attributes and, if necessary, either use DFSMSdfp IGWABWO callable service to set the attributes, or discard any BWO backups that are taken in the batch window that follows the shutdown.

Immediate or uncontrolled shutdown

During an immediate or uncontrolled shutdown, CICS does not close the files defined in the FCT, and so the BWO attributes in the ICF catalog are not updated.

Use the DFSMSdfp IGWABWO callable service to set the attributes (see “An assembler program that calls DFSMS callable services” on page 218 for an example of how to do this). Do not run any batch jobs before the next CICS restart. If you do, for releases prior to DFSMS 1.2, discard any BWO backups that are taken in the batch window.

For DFSMS 1.2 onward, the controls in DFSMS allow DFSMSdss to detect a backup that is invalidated if CICS applications are shut down (normally or abnormally) and if batch programs are executed that update the data set while the BWO backup is in progress. This allows DFSMSdss to discard the backup, which prevents DFSMShsm from erroneously discarding the oldest valid backup from the inventory maintained by DFSMShsm.

Restart

At the next CICS restart, the following BWO-dependent actions can occur when a data set is opened for update:

vIf the BWO attributes in the ICF catalog are set to the ‘BWO enabled’ state, CICS issues warning message DFHFC5808.

vIf the file has been redefined as BACKUPTYPE(STATIC), and:

–CICS has been cold started

–The original base cluster DSNB has been discarded

–The BWO attributes in the ICF catalog are set to the ‘BWO enabled’ state

CICS issues warning message DFHFC5809.

vIf the file has been redefined as BACKUPTYPE(STATIC), and:

–CICS has been warm or emergency restarted

–The original base cluster DSNB has been kept

CICS fails the file-open operation with message DFHFC5807.

Data set backup and restore

BWO backups are taken at the VSAM sphere level. You can use DFSMShsm or DFSMSdss to take the backup copy. You are recommended to use DFSMShsm because, without DFSMShsm installed, you must supply automatic class selection (ACS) routines to fulfil the SMS requirements for BWO support.

Chapter 18. Backup-while-open (BWO) 213