OEXITRTN keyword

Use the OEXITRTN keyword to specify the name of the user exit routine to be invoked prior to the write process of a Change function.

When this keyword is specified, you must either specify the EXITLIB DD statement or the library that contains the user exit routine in JOBLIB or STEPLIB DD.

For each segment that is processed, the exit routine that is specified by the OEXITRTN=keyword parameter will be invoked with the specified function. If a segment is compressed by an IMS segment edit/compression routine, it will be expanded by the segment edit/compression routine before FPA calls a user exit routine. After returning from the user exit routine, the segment will be re-compressed by the segment edit/compression routine. Even if the segment is defined as fixed, the LL field of the segment is added and the record is passed to the user exit routine.

OEXITRTN is an optional keyword for the CHANGE command.

Related keywords:
Format:
Read syntax diagramSkip visual syntax diagramOEXITRTN=( exit_routine,EXPCMPEXC)
exit_routine
Specify a 1- to 8-character name of the user exit routine.

The second parameter specifies the function to be performed by the exit routine:

EXP
Expansion
CMP
Compression
EXC
Expansion then compression. This keyword value invokes the exit routine twice.
Default:
None.
Site default support:
Not supported.
Keyword abbreviation:
Supported.
Requirement:
All exit routines should be re-entrant so that they can be invoked by multiple subtasks. If the routine is not re-entrant, processing of the user exit routines for multiple subtasks is serialized, and the performance might be degraded. All exit routines must be capable of AMODE=31.

For the Interface of the exit routine, see the description of EXITRTN keyword.