TOVOLUME: Specifying the volume to receive the recovered data set

Explanation: If you are recovering a data set, TOVOLUME(volser) is an optional parameter specifying which volume should receive the recovered data set. For volser, substitute the serial number of the volume that is to receive one or more recovered data sets.

If you are recovering a volume, TOVOLUME(volser) is a required parameter specifying which volume you want to recover. For volser, substitute the serial number of the volume that is to be recovered. The volser that is to be recovered must be the same as the source volser of the volume that was backed up or dumped.

If you specify TOVOLUME when recovering an SMS-managed data set, the volser will be passed to the automatic class selection (ACS) routines; ACS, however, ultimately determines to which volume the data set is recovered. The TOVOLUME parameter is ignored if an existing SMS data set is recovered as SMS.

Defaults: If you are recovering from a backup version of a cataloged data set and do not specify TOVOLUME, DFSMShsm recovers the backup version to the volume where the catalog entry shows the data set currently exists. If no catalog entry exists, DFSMShsm recovers the backup version to the volume where the data set resided when it was backed up unless the backup version was created from a data set on a migration volume. If the data set was backed up while residing on a migration volume and you do not specify the TOVOLUME parameter, DFSMShsm recovers the backup version to the volume from which the data set last migrated.

If you are recovering from a backup version of an uncataloged data set and do not specify TOVOLUME, DFSMShsm recovers the backup version to the volume where the data set resided when it was backed up, unless it is recovered as SMS.

Note:

If you specify TOVOLUME, you must also specify the UNIT parameter.
If DFSMShsm is recovering a VSAM data set not cataloged in an integrated catalog facility catalog, TOVOLUME can only specify a volume owned by the catalog where the data set being recovered is cataloged or will be cataloged.
The TOVOLUME parameter is passed to the ACS routines when processing a data set that will be recovered to an SMS-managed volume.
If a data set that was SMS-managed when backed up has been deleted, and if ACS determines that data set is now non-SMS, TOVOLUME is required to recover that data set to a non-SMS-managed volume. If TOVOLUME is not specified, the recovery will fail with message ARC1170I and reason code 13.
If both TOVOLUME and the VOLCOUNT(N(nn)) parameters are specified, the resulting volume count for the data set will be one (1). If space does not exists on the specified volume, the allocation fails.

Attention

If you specify TOVOLUME for a data set that was backed up with DFSMSdss and you direct it to a volume that has an uncataloged data set with the same name, DFSMSdss tries to restore the cataloged data set on top of the uncataloged data set; as a result, your attempt fails. DFSMShsm scratches the uncataloged data set because DFSMSdss fails to restore the cataloged data set.