Specifying DFHMQCOD or your own program in the PLTPI list

If you use DFHMQCOD or your own program to start the connection to WebSphere® MQ automatically during CICS® initialization, follow these instructions to add the program to the CICS PLTPI list.

About this task

The PLTPI list is the program list table (PLT) with the suffix that you specify on the PLTPI system initialization parameter. If you specify the CICS system initialization parameter MQCONN=YES, you do not need to add DFHMQCOD or your own program to your CICS PLTPI list. The MQCONN parameter always uses program DFHMQCOD to start the CICS-WebSphere MQ connection, and it cannot be customized to use a user-supplied attach program of a different name. If you prefer not to use the MQCONN parameter, continue with these steps.

Procedure

  1. If your current PLTPI list contains no entry for DFHDELIM, add one. DFHMQCOD or your own equivalent program must run during the third stage of CICS initialization and must therefore be added after the entry for DFHDELIM.
  2. Use the CICS DFHPLT macro to add DFHMQCOD or your program to the PLTPI list. See Figure 1.
  3. Verify that you have specified the suffix of your PLTPI list correctly on the PLTPI system initialization parameter.
  4. Verify that an MQCONN resource is present in one of the groups named in the list or lists named by the GRPLIST system initialization parameter. The MQCONN resource is required to start the connection to WebSphere MQ.

Results

Start of changeIf you are using MQ monitors, when the MQ connection is started, the MQ monitors are started automatically provided that the MQMONITOR resources have been installed with attributes AUTOSTART(YES) and STATUS(ENABLED).End of change

Example

This example shows you how to code the entry for DFHMQCOD after the entry for DFHDELIM in a CICS PLT called DFHPLT41:

Figure 1. Sample PLT for use with the CICS-WebSphere MQ adapter
DFHPLT41 DFHPLT TYPE=INITIAL,SUFFIX=41
         DFHPLT TYPE=ENTRY,PROGRAM=DFHDELIM
         DFHPLT TYPE=ENTRY,PROGRAM=DFHMQCOD
         DFHPLT TYPE=FINAL
         END

To use this sample PLT, you specify the suffix 41 on the PLTPI system initialization parameter. For more information about coding PLT entries, see Program list table (PLT).



zs11320_.html | Timestamp icon Last updated: Sunday, 4 June 2017