DFDSSOPTION: Pass optional parameters to DFSMSdss

Explanation: DFDSSOPTION(RETRY | VOLCOUNT) is an optional parameter that causes DFSMShsm to pass optional parameters to DFSMSdss when recalling certain types of data sets or to specify the number of volumes a data set can extend to.

RETRY is applicable to the recalling of the following types of data sets and is ignored by DFSMShsm if specified for other types of data sets:

Partitioned data set: When the initial recall of the data set fails and a DFSMSdss message requests the use of the NOPACKING option. RETRY specifies for DFSMShsm to pass this NOPACKING option to DFSMSdss.
Keyed VSAM data set: When the initial recall of the data set fails and a DFSMSdss message requests the use of the FREESPACE(0 0) option, to retry the restore to a like device, or both. If the data set is not SMS-managed, also specify VOLUME(volser) UNIT(unittype) parameter on the recall command. RETRY specifies for DFSMShsm to pass this FREESPACE option to DFSMSdss.

Note: If the RETRY parameter is specified, then the ACS routine that indicates a RECALL environment will always be invoked, even if one or more class transitions were missed while the data set was migrated or if the data set was transitioned before migration.

VOLCOUNT(ANY | N(nn)) allows an SMS data set to extend to additional volumes within the same storage group, when space is available. The VOLCOUNT parameter is limited to SMS data set types supported as multivolume data sets. Refer to z/OS DFSMSdss Storage Administration for more information regarding restrictions and limitations of the VOLCOUNT parameter.

VOLCOUNT(ANY) results in the allocation of the target data set on as many volumes as required, to a maximum of 59.

VOLCOUNT(N(nn)) allows users to specify the number of volumes to be used for SMS data set allocation. nn can be any value from 0 to 59. When you specify the number of volumes the data set is allocated to, the allocation of the data set will be limited to that number of volumes or will be extended to that number of volumes.

The VOLCOUNT(N(nn)) parameter is ignored if specified with the DFSMShsm VOLUME parameter. If a volume count VOLCOUNT(N(nn)) is specified and the VOLUME parameter is also specified, the resulting volume count for the data set will be one (1). If inadequate space exists on the specified volume, the allocation fails.

Defaults: None.

Note: If you specify the RECALL command with the VOLCOUNT parameter, it overrides any option used on the SETSYS VOLCOUNT command.