Concurrent copy initialization complete (Eioption 24)

This section contains intended programming interfaces.

DFSMSdss calls the UIM with option code 24 to inform it that the initialization of the concurrent copy session for a given data set or volume has completed. For full-volume or tracks operation, there is only one call (because there is only one input volume). For a physical data set operation, there is one call for each input volume. For a logical data set operation, there is one call for every data set. DFSMSdss does not call the UIM with this option code if the CONCURRENT keyword is not specified. DFSMSdss provides the UIM with information through the EIREC24 structure within the Exit Identification Block, ADREIB (in the ADREID0 macro).

DFSMSdss provides the UIM with the following information:

A return code indicating whether or not the concurrent copy session initialization succeeded:
0

Concurrent copy session initialization was successful and any serialization on the data has been released.

4

Concurrent copy session initialization failed. If this is a logical data set operation, this data set is not processed using concurrent copy, but other data sets may be. If this is a full-volume, tracks, or physical data set operation, concurrent copy is not used. In either case, serialization is obtained and released as if CONCURRENT were not specified. When this exit is called, DFSMSdss may not be holding any serialization.
A reason code providing further details about the status of the concurrent copy session initialization (always valid, even for a zero return code):
0

The concurrent copy operation is logically complete at this time (data movement has not been done yet).

4

All parts of the data being dumped or copied were not on hardware supporting concurrent copy.

8

Hardware limits exceeded.

12

System data mover failed.

16

Host limits exceeded.

20

System data mover not available.

24

Other host error.

28

Data set type not supported for concurrent copy.

32

The concurrent copy operation is logically and physically complete at this time (data movement has been done).

36

The data being processed requires the use of SnapShot, but the SnapShot software support is not available on the system.
The volume serial of the volume on which the concurrent copy initialization was attempted (valid only if the reason code is not 16).
The name of the data set on which the concurrent copy initialization was attempted (valid only if a logical data set operation is being performed).
A flag indicating whether or not DFSMSdss has reset the data-set-changed flag in the VTOC for the data set (valid only if a logical data set dump operation is being performed).

The UIM returns to DFSMSdss with a return code in the Exit Identification Block. DFSMSdss continues to process based on that return code, as follows:

00: Continue normal processing
20: Disconnect this exit
32: The DFSMSdss function is ended (not valid for a physical data set dump or logical data set copy)
36: End data set (not valid for full or tracks operations)

Error handling is the same as described under User Return Code.