System definition

Use the INITPARM parameter in the CICS system initialization table (SIT), or the SYSIN override, to set the default connection parameters. Figure 11 shows you how to do this.

Figure 11. Sample INITPARM statement to set the default connection values for CICS 

INITPARM=(CSQCPARM='SN=CSQ1,TN=001,IQ=CICS01.INITQ')

Where:

SN

The subsystem name. This must be the name of a queue manager, not a queue-sharing group.

TN

The trace number to identify the adapter in CICS trace entries. This must be in the range zero through 199.

IQ

The name of the default initiation queue. If this is blank, and you do not specify an initiation queue name by any other method, an instance of CKTI is not started when the CICS adapter connects to the queue manager.

The INITPARM statement does not accept a parameter string longer than 60 characters. If you specify a 4-character subsystem name and a 3-character trace number, the maximum allowable length of the initiation queue name is 42 characters. If we need a queue name longer than 42 characters, we cannot use the INITPARM statement to specify the default initiation queue.

At connect time, override the INITPARM setting, either by using the CKQC transaction, or in a PLTPI program.

  1. If you are using a PLTPI program to start the adapter, code the suffix of your PLT on the PLTPI system initialization parameter. See Figure 10 for an example of this.

  2. Add the following WebSphere MQ libraries to the STEPLIB concatenation in your CICS procedure in the following order:

    • thlqual.SCSQANLx

    • thlqual.SCSQAUTH

    Where x is the language letter for your national language.

  3. Add the following WebSphere MQ libraries to the DFHRPL concatenation in your CICS procedure in the following order, even if they are in the LPA or link list:

    • thlqual.SCSQANLx

    • thlqual.SCSQCICS

    • thlqual.SCSQAUTH

    Where x is the language letter for your national language.

    If you are using any CICS programs that dynamically call the WebSphere MQ CICS stub, CSQCSTUB, also add thlqual.SCSQLOAD to the DFHRPL concatenation.

    If you are using the API-crossing exit (CSQCAPX), also add the name of the library that contains the load module for the program.

  4. Update CSQINP2. We can use the sample CSQ4INYG, but you might need to change the initiation queue name to match your system definition.

For more information about: