IBM SC34-7012-01 manual VARY SMS,CFVOLvolser,QUIESCE

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 VR 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 above, 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 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:

a.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 CICSVR.

b.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.

Chapter 17. Forward recovery procedures 191