Explanation: VOLUME(volser) is an
optional parameter specifying the volume that is to receive the recalled
data set. This volume is called the target volume. The volume does
not have to be managed by DFSMShsm. For volser, substitute
the serial number of the target volume.
Defaults: If you do not specify the VOLUME
parameter, DFSMShsm recalls the non-SMS-managed data set to the eligible
primary volume with the most space available, unless the recalled
data set is associated with a recall pool.
Note: - If you specify VOLUME, you must also specify the UNIT parameter.
- In a JES3 environment, do not specify the volser of a
volume because JES3 preselects a set of volumes. If you specify a
volume that is not in that preselected list, DFSMShsm fails the recall.
- When you specify the VOLUME parameter, the target volume must
have enough space available for the data set. Otherwise, DFSMShsm
fails the recall.
- When you specify the VOLUME parameter, DFSMShsm passes that volume
serial number to the automatic class selection (ACS) routines to determine
whether the volume is managed by SMS before recalling the data set.
See Space management of SMS-managed storage for more information about
automatic class selection.
- If both VOLUME and the VOLCOUNT(N(nn)) parameters are
specified, the resulting volume count for the data set will be one
(1). If space does not exist on the specified volume, the allocation
fails.