Volume recovery procedure using CFVOL QUIESCE

If a volume is lost and you logically recover the data sets using CICS® VSAM Recovery for z/OS®, you do not need to use the CFVOL QUIESCE command (step 1 in the procedure described here).

This is because CICS cannot run the lost locks recovery process until the data sets are available, and the data sets are made available only after the CICS VSAM Recovery for z/OS recovery jobs are finished.

If you physically restore the volume, however, the data sets that need to be forward recovered are immediately available for backout. In this case you must use CFVOL QUIESCE before the volume restore to prevent access to the restored volume until that protection can be transferred to CICS (by using the CICS SET DSNAME(…) QUIESCED command). When all the data sets that need to be forward recovered have been successfully quiesced, you can enable the volume again (CFVOL ENABLE). The volume is then usable for other SMSVSAM data sets.

Use the command D SMS,CFVOL(volser) to display the CFVOL state of the indicated volume.

CICS must not perform backouts until forward recovery is completed. The following outline procedure, which includes the three VARY SMS commands described in the parent topic, prevents CICS opening for backout a data set on a restored volume until it is safe to do so. In this procedure volser is the volume serial of the lost volume:
  1. VARY SMS,CFVOL(volser),QUIESCE

    Perform this step before volume restore. Quiescing the volume ensures that the volume remains unavailable, even after the restore, so that attempts to open data sets on the volume in RLS mode will fail with RC=8, ACBERFLG=198(X'C6'). Quiescing the volume also ensures CICS can't perform backouts for data sets after the volume is restored until it is re-enabled.

  2. ROUTE *ALL,VARY SMS,SMSVSAM,TERMINATESERVER
  3. VARY SMS,SMSVSAM,FORCEDELETELOCKSTRUCTURE
  4. ROUTE *ALL,VARY SMS,SMSVSAM,ACTIVE

    Note at this point, as soon as they receive the SMSVSAM available event notification (ENF), CICS regions are able to run backouts for the data sets that are available. RLS-mode data sets on the lost volume, however, remain unavailable until a later ENABLE command.

  5. At this point the procedure assumes that the volume has been restored. This step transfers the responsibility of inhibiting backouts for those data sets to be forward recovered from SMSVSAM to CICS. Quiescing the data sets that need to be forward recovered is a first step to allowing the restored volume to be used for recovery work for other data sets:
    1. SET DSNAME(…) QUIESCED

      Use this command for all of the data sets on the lost volume that are to be eventually forward recovered. Issue the command before performing any of the forward recoveries.

      Note: A later SET DSNAME(…) UNQUIESCED command is not needed if you are using CICS VSAM Recovery for z/OS.
    2. VARY SMS,CFVOL(volser),ENABLE

      Issue this command when CICS regions have successfully completed the data set QUIESCE function. You can verify that data sets are successfully quiesced by inquiring on the quiesced state of each data set using the CEMT INQUIRE DSNAME(…) command. If a data set is still quiescing, CICS displays the words BEING QUIESCED.

      This clears the SMSVSAM CFVOL-QUIESCED state and allows SMSVSAM RLS access to the volume. CICS ensures that access is not allowed to the data sets that will eventually be forward recovered, but the volume is available for other data sets.

  6. Run data set forward recovery jobs.

The following two examples show forward recovery after the loss of a volume, based on the previously outlined procedure: