Enabling AOI exit routines

IMS gives control to AOI exit routines to do initialization and message processing. BMC does not supply an AOI exit routine to do initialization processing. If you have your own routine, specify its one- to eight-character load module name in the AOEINIT parameter in an imsidSYS member in the UBBPARM data set or an IMFSYS00 member in an ibbparm data set.

The DFSAOUE0 and DFSAOE00 routines capture MTO messages and IMS commands and pass them to BMC AMI Ops Automation for IMS. They also perform the following functions:

• Provide an interface with your AOI exit routines (if any)
• Automatically start the product monitors when IMS starts
• Provide an interface between the Event Collector and the BBI-SS PAS for workload data collection
• Initialize the Event Collector

On entry to DFSAOE00 with AOE0FUNC=1, the product loads and executes any user exit specified in AOEINIT=xxxxxxxx one time only. The DFSAOE00 exit does not forward control to your DFSAOE01 exit on the initialization call.

To enable AOI exit routines

1. Perform one of the following actions based on the number of DFSAOUE0 exits you have:
   • If you have one DFSAOUE0 exit, rename it DFSAOUE1 or choose a different name and use the control statements described for use when you have multiple DFSAOUE0 exits.

   • If you have multiple DFSAOUE0 exits in addition to the exit supplied by BMC, or one or more exits not named DFSAOUE1, add one or more AOIEXIT control statements to an imsidSYS member in UBBPARM or to an IMFSYS00 member in an ibbparm data set.

     For example:

     AOIEXIT=MYNAME

     AOIEXIT=DFSAOUE2

     In the example, both exits are loaded and executed by the BMC DFSAOUE0 exit. Program MYNAME executes first.

2. Perform one of the following actions based on the number of DFSAOE00 exits you have:
   • If you have one DFSAOE00 exit, rename it to DFSAOE01 or choose a different name and use the control statements described for use when you have multiple DFSAOE00 exits.

   • If you have multiple DFSAOE00 exits, in addition to the exit supplied by BMC, or one exit not named DFSAOE01, add one or more AOEEXIT control statements to an imsidSYS member in UBBPARM or to an IMFSYS00 member in an ibbparm data set.

     For example:

     AOEEXIT=MYNAME

     AOEEXIT=DFSAOE02

     In the example, both exits are loaded and executed by the BMC DFSAOE00 exit. Program MYNAME executes first.

• Flow-of-control By default, the BMC DFSAOE00 exit invokes the BMC AOI exit routine (IELOAD) before it invokes your user exits. The return code set by the last user exit processed is passed to IMS.
• Enhancement-to-the-IMS-DFSAOE00-interface BMC enhances the programming interface when your DFSAOE00 exit is invoked in the following ways:
• BMC AMI Ops Automation for IMS considerations Consider the following information when installing your user exit with a BMC exit: