TARGETVOLUME: Specifying the volume to receive the restored data sets

Explanation: TARGETVOLUME(volser) is an optional parameter specifying that volume restore should use the volume specified by volser and change this volser to the volser of the TOVOLUME parameter during the restore operation.

Defaults: None
Note:
  1. TARGETVOLUME is only valid when the TOVOLUME and FROMDUMP parameters are specified. If you specify TARGETVOLUME when it does not apply, an error message will be issued.
  2. If you do not specify TARGETVOLUME, a volume with the volser specified in the TOVOLUME parameter must exist and be online.
  3. If an SMS-managed volume is being restored and APPLYINCREMENTAL is specified, either the TARGETVOLUME or another SMS-managed volume must be available to be selected as directed by your ACS routines in order for the APPLYINCREMENTAL portion to recover later backup versions. Note that even if the TARGETVOLUME is SMS and selectable, APPLYINCREMENTAL processing may select a different SMS volume if available.
  4. If APPLYINCREMENTAL and TARGETVOLUME are specified, the TOVOLUME must be varied OFFLINE before issuing the RECOVER command. If the TOVOLUME is ONLINE, the command will fail and new message ARC0256I will be issued. This new message is documented below.
  5. After the RECOVER command completes, additional steps may be required to complete the volume change and to establish access to the restored volume. Check all DFSMShsm, DFSMSdss, and system messages issued during the Volume Restore. Since the TARGETVOLUME must be online, if the TOVOLUME is also ONLINE, check for DFSMSdss message ADR344I indicating that a duplicate volume will be varied offline. ADR344I includes the unit to be varied offline. Following this, check for messages like IEF281I 0E19 NOW OFFLINE indicating the volume is offline. If this is the unit for TARGETVOLUME, after the command completes, you will need to vary the TOVOLUME unit OFFLINE and then vary the TARGETVOLUME unit ONLINE. You should display the units before issuing the command, and note the units and associated volsers for both the TOVOLUME and TARGETVOLUME.