File closing (non-RLS mode)
When the last file that is open for update is closed against a VSAM base cluster data set, CICS® uses the DFSMSdfp IGWABWO callable service to update the ICF catalog to indicate that the data set is no longer eligible for BWO and to reset the recovery point to the current time.
If a VSAM split has occurred while a file was open, CICS calls IGWABWO at file-close time to update the ICF catalog to prevent further BWO backups. If DFSMShsm is currently taking a BWO backup, it will discard the backup at the end of the backup operation.
The BWO attributes indicating that a split has occurred and that the data set is eligible for BWO are restored when the next file is opened for update against the data set. This ensures that DFSMShsm takes the correct action if a split occurs during backup processing, which spans CICS updating a file (causing a VSAM split), the file being closed, and then the file being reopened.
When CICS is terminated by a normal shutdown, all CICS files are closed. The ICF catalog is updated to suppress BWO activity during the batch window between CICS sessions. After an uncontrolled or immediate shutdown, or if there is a failure during file closing, the data set remains open and the BWO flags are not reset. See Shutdown and restart.
Restriction for VSAM upgrade set
- The sphere is opened for update via a VSAM path. This causes VSAM to open for update all upgrade clusters for this sphere.
- A file is opened for read-only against this sphere.
- The original VSAM path is closed.
The data set is now ineligible for BWO backups because CICS file control has reset the BWO attributes in the ICF catalog. But, until all open ACBs in the sphere are closed, VSAM will not close the internal ACBs that are open for update, and thus it is not possible to take non-BWO backups either.
- Close all ACBs for the sphere, or
- Open for update against the base cluster data set a file that is defined with BACKUPTYPE(DYNAMIC).