WAIT


   .-WAIT(2,2)--------------------------.   
>>-+------------------------------------+----------------------><
   '-WAIT--(--numsecs--,--numretries--)-'

WAIT: Specifies to DFSMSdss the length of the wait in seconds, and the number of passes to be made through the list of selected data sets to obtain control of a data set for the COPY DATASET command.

numsecs: Specifies a decimal number (0–255) that designates the interval, in seconds, to wait before attempting another pass through the entire list of selected data sets.
numretries: Specifies a decimal number (0–99) that designates the number of passes to make through the list of selected data sets in an attempt to obtain control of a data set.

The default for numsecs,numretries is (2,2), which specifies two retries at 2-second intervals. If you do not want to wait for a resource, specify 0 for either numsecs or numretries.

For a data set copy operation the WAIT keyword has a different meaning when: (1) data sets are being serialized, (2) multiple data sets are being processed, and (3) WAIT(0,0) is not specified. In this case, DFSMSdss makes multiple passes through the list of data sets. On each pass, DFSMSdss processes the data sets that (1) can be serialized without waiting for the resource and (2) were not processed before. At the end of a pass, if none of the data sets can be processed without waiting for a resource, then, in the next pass, at the first occurrence of a data set that was not processed, a WAIT is issued. That data set and the remainder of the list are processed if possible.

The above procedure is repeated until all data sets are processed or the WAIT limits are reached. For example, if WAIT(3,10) is specified and five data sets are left to be processed, up to ten passes are made. On each pass, an unprocessed data set is waited upon for 3 seconds. Thus, only a 30-second maximum is ever waited, not 150 (5 times 3 times 10).

Note: The WAIT keyword does not control wait/retry attempts for system resources (such as the VTOC and the VVDS). For system resources, the default wait time is 3 seconds and the default retry count is 30. This results in a total wait time of 90 seconds. For information about controlling the wait/retry attempts for system resources, see Controlling the wait/retry time for serialization of system resources (PN11523).