Implementing IMS user exits

This release of the OMEGAMON® for IMS on z/OS® product provides four types of IMS user exits. To implement the exits, you define them to IMS and update the JCL for the IMS control region procedure to concatenate the rtehilev.RKANMODR load library to the STEPLIB DD statement.

The OMEGAMON for IMS on z/OS product uses the following types of IMS user exits:

AOIE: The Type-2 Automated Operator user exit is called continuously for system messages that are destined for the mater terminal, for type-1 commands that are entered from APPC or OTMA connections, and for the responses to those type-1 commands. The exit routine is also called for internal commands and commands from the ICMD call but not for their responses.
LOGWRT: Logger user exit, which is used by the Response Time Analysis component and applies to all IMS releases.
PPUE: Partner Product user exit, which is used by IMS type-1 command support in the OMEGAMON enhanced 3270 user interface and applies to all IMS releases. This user exit also installs the OMEGAMON ILOG logging support that is used by the Application Trace Facility (ATF) component to write application summary log records to the IMS log. This user exit applies to all IMS releases.
IMSMON: IMS Monitor user exit, which is used by the ATF component and applies to IMS V14.1 and above.
FASTMON: IMS Fast Monitor User Exit, which is used by the ATF component as a high-performance alternative to the IMSMON type and applies to IMS V15.1 and above.

To implement the user exits that OMEGAMON for IMS on z/OS provides, you must update the JCL for your IMS control region procedure as part of your post-configuration tasks. You must concatenate the rtehilev.RKANMODR data set to the STEPLIB DD statement in your IMS control region procedure.

For example, assume that your rtehilev is OMIMS.V550 so the RKANMODR data set is named OMIMS.V550.RKANMODR, and that your IMS control region JCL includes the following STEPLIB DD statement:

//STEPLIB DD DISP=SHR,
          DSN=DFS.V14R0M0.SDFSRESL

Concatenate the OMIMS.V550.RKANMODR data set to the STEPLIB as shown in the following example:

//STEPLIB DD DISP=SHR,
          DSN=OMIMS.V550.RKANMODR
          DD DISP=SHR,
          DSN=DFS.V14R0M0.SDFSRESL