Starting a CICS-WebSphere MQ connection by linking to DFHMQQCN from a CICS application program

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

  1. 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 Start of changeMQMONITOREnd of change 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 Start of changeMQMONITOREnd of change 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. Start of changeWhen 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.End of change
    ' '
    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.
  2. 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.


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