Preparing CICS programs

XA switch modules are provided to enable you to link CICS with WebSphere MQ:

Table 28. Essential Code for CICS applications (Solaris)

Always link your transactions with the thread safe WebSphere MQ library libmqm_so.

You can find more information about supporting CICS transactions in WebSphere MQ System Administration Guide.

CICS on Open Systems support

WebSphere MQ on UNIX systems supports CICS on Open Systems via the XA interface.

You must ensure that CICS COBOL applications are linked to the threaded version of the library. CICS on Open Systems WebSphere MQ transactions must link with libmqm_r, except on Solaris, where you must link with lmqmcs_d.

Preparing CICS COBOL programs using Micro Focus COBOL

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 /opt/mqm/lib/libmqmcbrt.o -lmqmcs_d
   

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

   Note:

   cicsmkcobol must be run only when one of the following is installed:

   New version or release of Micro Focus COBOL

   New version or release of TXSeries for Solaris

   New version or release of any supported database product (for COBOL transactions only)

   TXSeries for Solaris

2. Export the following environment variables:

     COBCPY=/opt/mqm/inc  export COBCPY
     LDFLAGS="-L/usr/mqm/lib -lmqmcs_d"  export LDFLAGS
   

3. Translate, compile, and link the program by typing:

     cicstcl -l COBOL -e <yourprog>.ccp
   

Preparing CICS C programs

You build CICS C programs using the standard CICS facilities:

1. Export one of the following environment variables:
   • LDFLAGS = "-L/opt/mqm/lib -L/opt/cics/lib -lmqmcs_d -lmqm -lmqmzse -lsocket -lnsl -ldl"
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. The sample MQSC script AMQSCIC0.TST may be used to create these queues and sample input queues.