Data set processed notification exit (Eioption 23)

This exit indicates to the UIM whether or not the logical copy, dump, or restore processing for individual data sets was successful. This exit is given control through the UIM at the conclusion of logical copy, dump, and restore processing for each data set. DFSMSdss provides the UIM with information through the EIREC23 structure within the exit identification block, ADREID0. EIREC23 is shown in Table 1.

DFSMSdss provides the UIM with the following information at the conclusion of processing for logical dump of each data set:

The data set name that was dumped
The RLS time stamps associated with the dump
A flag indicating whether or not the data set is marked "recovery required"
A return code for the data set that indicates whether processing was successful:

0: Data set completely successful (informational)
4: Data set partially successful (warning)
8: Data set unsuccessful (error)
12: Ending error
16: Ending error

The source SMS flag (DS1SMSFG) from the Format 1 DSCB
The source data set organization (DS1DSORG) from the Format 1 DSCB for a non-VSAM data set
Flags to indicate data set type for a VSAM data set

DFSMSdss provides the UIM with the following information at the conclusion of processing for a logical copy and a logical restore of each data set:

The original data set name that was copied or restored. This is the data set name prior to rename processing, if any.
The new data set name being copied or restored if rename processing was performed.
A return code for the data set that indicates whether processing succeeded:
0

Data set completely successful (informational)

4

Data set partially successful (warning)

8

Data set unsuccessful (error)

12

Ending error

16

Ending error

The source and target SMS flags (DS1SMSFG) from the Format 1 DSCB.
The source and target data set organization (DS1DSORG) from the Format 1 DSCB for a non-VSAM data set.

Flags to indicate data set type for a VSAM data set.
A count of the volumes that the data set was copied or restored to.
A list of the volume serial numbers (VOLSERs) that the data set was copied or restored to.

The UIM returns to DFSMSdss with a return code in the exit identification block. The valid return codes are:

0: Continue normal processing
20: Disconnect exit
32: End function
36: End data set
It does not undo any successful processing, but deletes the data set from the successfully-processed message list (if applicable) and includes it in the unsuccessfully-processed message list. It is the responsibility of the user of this interface to delete the copied, dumped, or restored data set from the target volumes. DFSMSdss continues processing with the next data set, if any. Refer to EIRC36 in Data set verification (Eioption 21) for details on ending spheres.

Note for Eioptions 21, 22, and 23

If Eioptions 21, 22, and 23 end the function (UIM passes back a return code 32 to DFSMSdss) during a data set copy operation, DFSMSdss can be processing more than one data set at the time. This can happen if utilities are needed to process some of the data sets. DFSMSdss does the following before ending:

No unprocessed data sets are scheduled for processing.
All data sets in utility processing are allowed to complete normally.
No new calls are made to exits 21, 22, or 23. This includes data sets in utility processing that are allowed to complete.
Spheres that are being processed because of the SPHERE keyword and that are not complete at the end of the function have the target parts deleted to preserve sphere integrity. Preallocated spheres are left partially copied.
Spheres being processed without the SPHERE keyword or individual sphere components being copied are left partially completed.