You can start a connection to WebSphere® MQ by linking to the CICS®-WebSphere MQ adapter connect program,
DFHMQQCN (or CSQCQCON, which is a previous name for the program), from a CICS application program. Although this method of starting the connection is
maintained for compatibility, using the EXEC CICS SET MQCONN command is the
preferred method of starting the connection from a CICS
application program.
About this task
Your CICS application program can be written in C, COBOL, PL/I, or assembler language.
Procedure
- Your program must pass a parameter list that specifies the connection values to be used. The parameter list is as follows:
- CKQC
- Four-character transaction ID; must be 'CKQC'.
- DISPMODE
- One-byte field; must contain a blank.
- CONNREQ
- Ten-character field; must contain 'START '.
- DELIM1
- One-byte delimiter field; must contain a blank.
- MQDEF
- One-character field that specifies whether this connection is to use the default
connection values from the installed MQCONN and
MQMONITOR
resource definitions
for the CICS region. Before CICS TS 4.1, this field was known as INITP. The possible values are: - Y
- Use the values for the queue manager name and default initiation queue from the installed MQCONN
and
MQMONITOR
resource definitions for the CICS region.
- N
- Do not use the default values. If you specify 'N', you must supply a queue manager name in the
CONNSSN field, and you may optionally specify a default initiation queue name in the CONNIQ field.
When you supply these values, the INITQNAME value of the installed MQCONN resource
definition and the QNAME value of the installed MQMONITOR resource definition are replaced with the
settings that you specify. To revert to the original settings, reinstall the resource
definitions.
- ' '
- Equivalent to 'Y'.
- DELIM2
- One-byte delimiter field; must contain a blank.
- CONNSSN
- Four-character field used to specify the z/OS®
subsystem name of the target WebSphere MQ queue
manager. You can specify either a single queue manager or a queue-sharing group.
- DELIM3
- Five-byte delimiter field; must contain blanks. Previous releases supported a trace point
override. This is now ignored.
- CONNIQ
- 48-character field that specifies the name of the default initiation queue.
- Your program must issue a command like this to link to the adapter connect program,
DFHMQQCN:
EXEC CICS LINK PROGRAM('DFHMQQCN')
COMMAREA(CONNPL) LENGTH(length of CONNPL)
In
this example, the name of the parameter list is CONNPL.
Results
Output messages from DFHMQQCN are displayed on the system console.