Other quiesce interface functions
In addition to quiesce and unquiesce, there are some other data-set-related functions using the RLS quiesce interface that are not connected with quiescing or unquiescing activity on a data set.
These are functions initiated by DFSMSdss, CICS® VSAM Recovery for z/OS®, or VSAM RLS, and might require some processing in those CICS regions that are registered with SMSVSAM. These functions do not cause any change in the ICF catalog quiesced flag.
- Non-BWO data set backup start
- A quiesce interface function initiated by DFSMSdss in
readiness for non-BWO backup processing for a data set that is open
in RLS mode. This function prevents CICS file
control issuing RLS update requests against a sphere so that the VSAM
sphere can be backed up.
SMSVSAM invokes the CICS RLS quiesce exit program in each region that has an open RLS ACB for the data set.
If any in-flight units of work are using the data set when a QUICOPY notification is received, CICS allows them to complete (or be shunted). CICS then flags its data set name block (DSNB) for the data set to disable further updates. Any unit of work that attempts to update the data set thereafter is abended with an AFCK abend, and SMSVSAM prevents any new file opens for update.
Note: If enabled, the CICS XFCVSDS exit is invoked for this function, with the UEPVSACT parameter set to a value of UENBWST.With the new RLS quiesce mechanism, you do not have to close a data set to take a non-BWO backup. However, because this causes new transactions to be abended, you might prefer to quiesce your data sets before taking a non-BWO backup.
- Non-BWO data set backup end
- A quiesce interface function initiated by DFSMSdss at
the end of non-BWO backup processing (or to cancel a non-BWO backup
request). This function enables CICS file
control to permit RLS update requests against the data set now that
backup processing is complete.
SMSVSAM invokes the CICS RLS quiesce exit program in each region that is registered with an SMSVSAM control ACB.
In addition to permitting updates, CICS writes tie-up log records to the forward recovery log and the log of logs, and retries any shunted units of work for the data set.
Note: If enabled, the CICS XFCVSDS exit is invoked for this function, with the UEPVSACT parameter set to a value of UENBWCMP. - BWO backup start
- A quiesce interface function initiated by DFSMSdss in
readiness for BWO backup processing for a data set that is open in
RLS mode. This function enables CICS to ensure
that the data set is in a suitable state for a BWO backup to be taken.
SMSVSAM invokes the CICS RLS quiesce exit program in each region that has an open RLS ACB for the data set.
In response to this form of request, CICS writes tie-up records to the forward recovery log and log of logs, and waits for any in-flight units of work to complete (or be shunted). New units of work can then update the data set.
Note: If enabled, the CICS XFCVSDS exit is invoked for this function, with the UEPVSACT parameter set to a value of UEBWOST. - BWO backup end
- A quiesce interface function initiated by DFSMSdss at
the end of BWO backup processing (or to cancel a BWO backup request).
It notifies CICS that a BWO backup of a data set is complete.
SMSVSAM invokes the CICS RLS quiesce exit program in each region that is registered with an SMSVSAM control ACB.
CICS does not perform any processing for this form of request.
Note: If enabled, the CICS XFCVSDS exit is invoked for this function, with the UEPVSACT parameter set to a value of UEBWOCMP. - Forward recovery complete
- A quiesce interface function initiated by VSAM in response to
a request from CICS VSAM Recovery for z/OS.
VSAM takes action associated with a sphere having completed forward
recovery, which includes notifying CICS.
SMSVSAM invokes the CICS RLS quiesce exit program in each region that is registered with an SMSVSAM control ACB.
CICS retries any backout-failed shunted units of work for the data set.
- Lost locks recovery complete
- A quiesce interface function initiated by VSAM. VSAM takes action
associated with a sphere having completed lost locks recovery on all CICS regions
that were sharing the data set.
SMSVSAM invokes the CICS RLS quiesce exit program in each region that is registered with an SMSVSAM control ACB.
Until lost locks recovery is complete, CICS disallows any new requests to the data set (that is, only requests that are issued as part of the recovery processing are possible). When lost locks recovery is complete, CICS allows all requests to the data set.
- Quiesce coupling facility cache available
- A quiesce interface function initiated by VSAM. VSAM takes action
associated with an MVS™ coupling facility cache structure
being restored.
SMSVSAM invokes the CICS RLS quiesce exit program in each region that is registered with an SMSVSAM control ACB.
CICS retries any backout-failed shunted units of work for all data sets.