Invoking user exit programs

To get CICSĀ® Configuration Manager to invoke your exit programs, you need to:

  1. Specify the programs to be invoked at the chosen exit points.
  2. Activate the chosen exit points.
  3. Activate the system option for exit point processing. By default, this system option is inactive, and CICS Configuration Manager ignores all exit programs, regardless of whether their exit points are active or not.

To perform the steps above, use the CICS Configuration Manager ISPF dialog:

  1. On the primary menu, select option 1.6 Exit Points.
  2. Specify the name of your exit program next to the appropriate exit point.

    The CICS Configuration Manager server does not define resource definitions for user exit programs. You must define these resources yourself, or have CICS autoinstall them for you.

    Before proceeding, you should confirm that CICS can define and load the exit program:

    • The Program Defined column indicates whether CICS can define the program. For example, you have defined a PROGRAM resource definition for the program, or you have implemented program autoinstall.
    • The Program Loadable column indicates whether CICS can load the program from the DFHRPL load library concatenation.

    To refresh these column values for the program name that you have just specified, you must exit and then re-enter the panel:

  3. Press the Exit key (F3) to exit the panel. Then re-enter the panel.
  4. Check the Program Defined and Program Loadable columns: both should show Y ("Yes").

    Do not proceed to the next step until both of these columns show Y. For details on making programs available to CICS, see the CICS Transaction Server for z/OSĀ® documentation.

  5. Enter / next to the exit point.

    This activates the exit point. However, CICS Configuration Manager only performs exit point processing if the associated system option is active.

  6. Press the Exit key (F3) to exit the panel.
  7. Go to primary menu option 1.1 System Options.
  8. Activate exit point processing.

    If the system option for exit point processing is active, then for any active exit points, CICS Configuration Manager invokes the nominated exit program at the appropriate point.