TXSeries CICS support

WebSphere MQ on HP-UX supports TXSeries(R) CICS(R) using the XA interface. Ensure that CICS applications are linked to the threaded version of the MQ libraries.

CICS C sample transaction

Sample C source for a CICS WebSphere MQ transaction is provided by AMQSCIC0.CCS. The transaction reads messages from the transmission queue SYSTEM.SAMPLE.CICS.WORKQUEUE on the default queue manager and places them onto the local queue whose name is contained in the transmission header of the message. Any failures are sent to the queue SYSTEM.SAMPLE.CICS.DLQ. Use the sample MQSC script AMQSCIC0.TST to create these queues and sample input queues.

Preparing CICS COBOL programs using Micro Focus COBOL

Note to users

DCE is no longer supported on WebSphere MQ products at Version 6.0. The following examples apply to products prior to Version 6.0.

To use Micro Focus COBOL, follow these steps:

  1. Add the WebSphere MQ COBOL run-time library module to the run-time library using the following command:
      cicsmkcobol -L/usr/lib/dce -L/usr/mqm/lib  \
                  /usr/mqm/lib/ libmqmcbrt.o -lmqz_r
    Note:
    With cicsmkcobol, WebSphere MQ does not allow you to make MQI calls in the C programming language from your COBOL application.

    If your existing applications have any such calls, you are strongly recommended to move these functions from the COBOL applications to your own library, for example, myMQ.so. After you have done this, do not include the WebSphere MQ library libmqmcbrt.o when building the COBOL application for CICS.

    Additionally, if your COBOL application does not make any COBOL MQI call , do not link libmqmz_r with cicsmkcobol.

    This creates the Micro Focus COBOL language method file and enables the CICS run-time COBOL library to call WebSphere MQ on UNIX(R) systems.

    Note:
    Run cicsmkcobol only when you install one of the following:
    • New version or release of Micro Focus COBOL
    • New version or release of CICS for HP-UX
    • New version or release of any supported database product (for COBOL transactions only)
    • New version or release of WebSphere MQ
  2. Export the following environment variable:
      COBCPY=/usr/mqm/inc  export COBCPY
     
  3. Translate, compile, and link the program by typing:
      cicstcl -l COBOL -e <yourprog>.ccp