Starting a connection automatically during CICS initialization

If you want the adapter to connect to WebSphere MQ automatically during CICS initialization, the CSQCCODF program should be included in a CICS PLTPI program. CSQCCODF must execute during the third stage of CICS initialization and must therefore be added after the entry for DFHDELIM. If there is no entry for DFHDELIM in your current PLTPI, add one.

Alternatively, if your version of CICS supports it, we can use the MQCONN SIT parameter to connect to WebSphere MQ automatically. See the CICS System Definition Guide for information about this parameter.

Instead of using CSQCCODF, we can write your own program; see Writing a PLTPI program to start the connection.

  1. Use the CICS DFHPLT macro to add your program to the list of programs executed by CICS during the third stage initialization. Figure 10 shows how to code the entry for CSQCCODF in a CICS PLT program called DFHPLT41. For information about coding PLT entries, see the CICS Resource Definition Guide.
    Figure 10. Sample PLT for use with the CICS adapter. This sample assumes that you are using the supplied PLTPI program, CSQCCODF, to start the adapter.

    DFHPLT41 DFHPLT TYPE=INITIAL,SUFFIX=41
             DFHPLT TYPE=ENTRY,PROGRAM=DFHDELIM
             DFHPLT TYPE=ENTRY,PROGRAM=CSQCCODF
             DFHPLT TYPE=FINAL
             END

  2. Specify the particular list of programs to be run at initialization by naming the suffix of your PLT on the PLTPI system initialization parameter. In Figure 10, the PLT suffix is 41.

Note:
We can use the CICS adapter in a CICS system that has interregion communication (IRC) to remote CICS systems. If you are using IRC, you should ensure that the IRC facility is OPEN before you start the adapter. This is essential if the IRC access method is defined as cross memory, that is, ACCESSMETHOD(XM).