File control quiesce receive exit, XFCVSDS

The XFCVSDS exit is invoked when VSAM RLS notifies CICS® that processing is required as a result of some data set-related events occurring in the sysplex.

XFCVSDS is invoked before CICS processing takes place, and only if a data set name block (DSNB) exists for the data set. The actions that cause XFCVSDS to be invoked are:
  • A data set is being quiesced throughout the sysplex.

    CICS is informed about this action only if it has files open in RLS mode against the data set.

    If CICS is notified about a quiesce action, the XFCVSDS global user exit program can cancel the data set quiesce, in which case it cancels the quiesce throughout the sysplex, and the data set remains in the unquiesced state.

  • A data set is being unquiesced throughout the sysplex.

    All CICS regions in the sysplex that are registered with a VSAM RLS control ACB are informed about unquiesce actions.

  • DFSMSdss wants to start a non-BWO backup of a data set.

    CICS is notified about a non-BWO backup start action only if it has files open in RLS mode against the data set.

    If CICS is notified about a non-BWO backup start action, XFCVSDS can be used to cancel the backup.

  • DFSMS has completed a non-BWO backup of a data set.

    All CICS regions in the sysplex that are registered with a VSAM RLS control ACB are informed about non-BWO backup complete actions.

  • DFSMS wants to start a BWO backup of a data set.

    CICS is notified about a BWO backup start action only if it has files open in RLS mode against the data set.

    If CICS is notified about a BWO backup start action, XFCVSDS can be used to cancel the backup.

  • DFSMS has completed a BWO backup of a data set.

    All CICS regions in the sysplex that are registered with a VSAM RLS control ACB are informed about BWO backup complete actions.