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.

The other functions provided on the RLS quiesce interface for data-set-related activities are as follows:
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.



dfht2c00213.html | Timestamp icon Last updated: Monday, 5 June 2017