TXSeries CICS support

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

You can run CICS programs using IBM(R) COBOL Set for AIX or Micro Focus COBOL. The following sections describe the difference between these.

Preparing CICS COBOL programs using IBM COBOL Set for AIX

To use IBM COBOL, follow these steps:

  1. Export the following environment variable:
      export LDFLAGS="-qLIB -bI:/usr/lpp/cics/lib/cicsprIBMCOB.exp  \
                      -I/usr/mqm/inc -I/usr/lpp/cics/include  \
                      -e _iwz_cobol_main  \
                      

    where LIB is a compiler directive.

  2. Translate, compile, and link the program by typing:
      cicstcl -l IBMCOB <yourprog>.ccp

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 AIX
    • 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

Preparing CICS C programs

Build CICS C programs using the standard CICS facilities:

  1. Export one of the following environment variables:
  2. Translate, compile, and link the program by typing:
      cicstcl -l C amqscic0.ccs
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.