Application interface summary

For Record Processing, if the UIM makes any changes to the presented record (assuming it can validly do so), return code 16 must be returned or the changes are ignored. If the record is to be replaced in total, return code 4 must be returned or the original record is used. If a record is to be inserted before the current record, return code 8 must be returned or the record is ignored. If the current record is to be deleted, return code 12 must be returned or the current record is processed. If the exit is no longer interested in processing any records appearing at the current DFSMSdss exit point, return code 20 must be returned or the exit is called at the next visitation of DFSMSdss to the exit point. The current record is still processed in either event. If you want to receive only user statistical records at any specific exit, return code 24 must be returned. If you want to process a WTOR within the UIM, the response must be returned to DFSMSdss with a return code 28.

If a record is being returned that is longer than the original record, the exit must either replace the record in the area pointed to by the original record pointer (as long as it does not exceed the length in EIRECALN) or supply another area and store the address to the record in the original record pointer field. In either case, the length must be stored in the original record length field and a return code of 4 must be used.

If a record is being returned that is shorter than the original record, the exit can supply an area and store the address to the record in the original record pointer field or, if allowed, can replace the original record with the shorter one. In either case, the length of the new record must be placed in the original record length field. If the new area option was used, return code 4 must be used. If the new record overlaid the original, return code 16 must be used. Table 1 describes the data area corresponding to the DFSMSdss exit identification block.

For Data Set Processing, Eioptions 21, 22, and 23 are three exits that give you added control over data set processing during a logical data set copy, dump, and restore operations. These exits are called immediately before and immediately after processing each data set, on a data set by data set basis, and allow you to make a number of processing changes.

Eioptions 21 and 22 are called, consecutively, at the start of processing of each data set. DFSMSdss passes the name of the data set being processed to each exit. Based on that name, each exit permits the following:

End processing of that one data set (return code 36).
End processing of the entire functional task (return code 32).
Disconnect the exit so that it will not be called before subsequent data sets task processing (return code 20).
Perform nothing (return code 0).
Eioption 22 only: Modify how the data set will be processed (return code 16). See Bypass verification exit (Eioption 22) for details.

Eioption 23 is called immediately after a data set is processed. Eioption 23 lets you end processing of both the data set and the task, disconnect the exit, or do nothing.