REFRESH: Requesting that the BVRs be recreated and reorganized

Explanation: REFRESH(ON | OFF) is an optional parameter that manipulates DFSMShsm flags to indicate that the BVRs need or do not need to be recreated and reorganized. An ON request indicates that the BVRs should be refreshed during the next DFSMShsm CDS backup, an OFF indicates the BVRs should not be refreshed during the next CDS backup. The REFRESH is done during the next successful DFSMShsm CDS backup.

Abbreviations: None.

Defaults: If you do not specify one of the optional parameters of FIXCDS, the default is DISPLAY. If you do not specify one of the optional REFRESH parameters (ON or OFF), the command fails. If you just specify FIXCDS, the command also fails.

Note:

The REFRESH parameter is only valid if you specify the record type as R, and the three letters of the record key are BVR. Do not use BVRSP, BVRUN, or BVRnn where nn is a backup cycle day.
After requesting a REFRESH of the BVRs, the BVRs are recreated and reorganized when DFSMShsm next performs CDS backup and when the CDS backup on this HSMPlex is successful.
The REFRESH(OFF) command only turns off a REFRESH request if a REFRESH(ON) command was previously issued but has not yet occurred because the CDS backup has not successfully completed.