RECYCLETAPEALLOCATION: Specifying whether to wait for the recycle tape to be allocated

Explanation: RECYCLETAPEALLOCATION (WAIT | NOWAIT) is an optional parameter specifying whether DFSMShsm should wait until the tape unit is allocated for the source and target tape volumes.

Subparameter Explanation
WAIT DFSMShsm waits until the recycle tape unit is allocated. All DFSMShsm functions requesting allocations stop until this allocation request is satisfied.

When using the WAIT option, you must exercise caution to limit the number of DFSMShsm tasks that require tape. If more tasks run than there are available tape devices, a deadlock condition occurs because of the exclusive enqueue that MVS™ allocation will put on the task input/output table (SYSZTIOT) while awaiting the tape device. This condition can be resolved only if another job (not DFSMShsm) releases a tape device, or if you cancel DFSMShsm.

NOWAIT DFSMShsm does not wait until the recycle tape unit is allocated. Instead, DFSMShsm reissues the request every 10 seconds up to six times. If the recycle tape unit is still not allocated after seven tries, DFSMShsm asks the operator whether to have DFSMShsm cancel the request or repeat the allocation sequence. With the NOWAIT option, dynamic allocation issues message IEF238D. Once answered, other DFSMShsm tasks can proceed with allocations.

SMS relationship: Parameter has the same meaning when applied to SMS-managed or non-SMS-managed DASD volumes or data sets.

SETSYS default: None.

DFSMShsm default: If you do not specify either subparameter on any SETSYS command, the DFSMShsm default is NOWAIT.