Installing the partner program exit routine

You must install the partner program exit routine (CECPPUE0) to enable change data capture for IMS to identify and manage IMS subsystems start events that might occur during replication.

Before you begin

Customize the configuration table module.

Procedure

  • If you need to support multiple exits or multiple versions of the DFSPPUE0 exit, complete the following steps. If you did not, go to the next bullet.
    When linking the modules, you can link them directly into any authorized data set concatenated in the IMS STEPLIB DD statement.
    1. Edit the sample USERHLQ.USERSAMP(CECLRIL6) following the instructions in the file.
    2. Run the sample job USERHLQ.USERSAMP(CECLRIL6) to link the IMS partner program exit DFSPPUE0 with the appropriate CECE1OPT load module, and specify a unique name for the resulting load module.
    3. Update the DFSDFMxx PROCLIB member with the new exit names. For example, if you created two exits name DFSPPUE1 and DFSPPUE2 you would specify the following : 
      <SECTION=USER_EXITS>
 EXITDEF=(TYPE=PPUE,EXITS=(DFSPPUE1,DFSPPUE2))
  • If you did not implement your own IMS partner program exit and you are not using a different exit, use the provided DFSPPUE0 as is.

What to do next

Verify the correct exit installation by starting the DB/DC or DBCTL region where you installed the notification exit. You must also start the source server and start replication for at least one subscription. Look for the following operator messages in the SYSLOG (the CECZ0991I message is issued by the IMS log reader service so this example assumes that the source server is running on the same image as IMS):

CECZ0751I Subsystem start notification issued for <subsystem-id>
CECZ0757I TCP/IP connection established for subsystem <subsystem-id>
to IP address <ip-address> on port number <port-number>
CECZ0755I A start notification response was received from server <server-name> for <subsystem-id>  
CECZ0758I Disconnected from <ip-address> port: <port-number>
CECZ0991I The IMS change-capture interface received an IMS start notification for IMS subsystem <subsystem-id>.