Defining, enabling, and disabling an exit program

When you have written an exit program, you must define it to CICS®. You can enable your exit program using an exit point or the EXEC CICS ENABLE command. You can disable your exit program using the EXEC CICS DISABLE command.

Procedure

  1. Define the exit program using the CEDA DEFINE PROGRAM command, specifying RELOAD(NO).
  2. Install the exit program.
  3. Enable the exit program using one of the following methods:
    • If your exit program is using an exit point in the user log record recovery program or the file control recovery control program, you can use the TBEXITS system initialization parameter.
    • Otherwise, use the EXEC CICS ENABLE command to enable the user exit program.
    If you enable a global user exit program before it has been installed and LPA=YES is specified as a system initialization parameter, CICS scans the LPA for the program. If message DFHLD0109I is issued, it means that CICS was unable to find the program in the LPA and is using the version in DFHRPL or a dynamic LIBRARY.
  4. When you have finished using the exit program, you can disable it using the EXEC CICS DISABLE command.

Example

For examples of how to enable and disable global user exit programs, see Global user exit foundation samples and Specific exit program samples.