Activating user exits for data tables

To activate the data table user exits, complete these steps.

Procedure

  1. Decide which user exits you want to use.
    For a description of each user exit, see Customizing data tables using user exits.
  2. Write the user exit programs.
    Examples are included in Customizing data tables using user exits.
  3. Define the user exit programs to CICS, using the CEDA DEFINE PROGRAM command, as described in PROGRAM resources.
  4. Activate the user exits using the EXEC CICS ENABLE command.
    If required, you can later deactivate the user exits using the EXEC CICS DISABLE command.

Unless you control the opening of a data table explicitly, with a CEMT or EXEC CICS command, you should probably activate the user exits during CICS startup. Otherwise the loading of the data table might begin before the user exits are activated. To activate the user exits during startup:

  1. Write one or more program list table post-initialization (PLTPI) programs that include the EXEC CICS ENABLE commands to activate the user exits.
    For programming information about PLTPI programs, see Writing initialization and shutdown programs.
  2. Define a program list table (PLT) with an entry for each of those PLTPI programs, as described in Program list table (PLT).
  3. Specify the PLTPI=suffix parameter for system initialization, as described in PLTPI system initialization parameter. Use the suffix of the PLT that was defined in the previous step. This causes the PLTPI programs to be executed in the second stage of initialization, before any files are opened.

What to do next

You can use PLT shutdown (PLTSD) programs in a similar way to disable the user exits during CICS shutdown.