Preparing C programs

Work in your normal environment; MQSeries for OS/2 Warp requires nothing special.

• You need to link your programs with the appropriate libraries provided by MQSeries for OS/2 Warp. Link program/exit type server for 32-bit C with library file MQM.LIB. Link program/exit type client for C with library file MQIC.LIB.

  The following command gives an example of compiling the sample program amqsget0:

  icc amqsget0.c /Gm /Gd /B "/pmtype:vio" /Fe"amqsget0.exe" mqm.lib
  

  Notes:

  1. If you are writing an installable service (see WebSphere MQ System Administration Guide for further information), link to the MQMZF.LIB library.

  2. If you are producing an XA switch load file for external coordination by an XA-compliant transaction manager such as IBM CICS, Transarc Encina, or Novell Tuxedo, use the MQRMIXASwitch structure and link to the MQMXA.LIB library.

  3. If you are writing a CICS exit for use with CICS for OS/2 Version 2.0.1, link to the MQMCICS.LIB library. If you are writing a CICS exit for use with CICS Transaction Server for OS/2, Version 4, link to the MQMCICS3.LIB library.
• For DOS only: Your application must also be linked with two of the following libraries, one for each protocol, indicating whether you do or do not require it. If you require TCP/IP you must also link to SOCKETL from the DOS TCP/IP product.
  

  Library file	Program/exit type
  MQICN.LIB	NetBIOS required
  MQICDN.LIB	NetBIOS not required
  MQICT.LIB	TCP/IP required
  MQICDT.LIB	TCP/IP not required

• You must ensure that you have specified adequate run-time stack and heap sizes:
  • You must link a trusted application with more stack than a normal application. Therefore, a stack size of 200 KB is the recommended minimum.
  • A heap size of 8 KB is the recommended minimum.
• The DLLs must be in the library path (LIBPATH) you have specified.
• If you use lowercase characters whenever possible, you can move from MQSeries for OS/2 Warp to WebSphere MQ on UNIX systems, where use of lowercase is necessary.

Preparing CICS and Transaction Server programs

Sample C source for a CICS MQSeries for OS/2 Warp transaction is provided by AMQSCIC0.CCS. You build it using the standard CICS facilities.

For CICS for OS/2 Version 2:

1. Add the following lines to the CICSENV.CMD file:

   UserWrk = 'c:\mqm\dll'
   UserInclude = 'c:\mqm\tools\c\include;c:\mqm\tools\c\samples'
   

   If necessary replace c:\mqm with the path on which you installed the sample code.

2. Compile using the command:

   CICS32TC AMQSCIC0.CCS LIBS(MQM)
   

This is described in the CICS for OS/2 V2.0.1 Application Programming Guide.

For CICS Transaction Server for OS/2, Version 4:

1. Add the following lines to the CICSENV.CMD file:

   UserWrk = 'c:\mqm\dll'
   UserInclude = 'c:\mqm\tools\c\include;c:\mqm\tools\c\samples'
   

   If necessary replace c:\mqm with the path on which you installed the sample code.

2. Compile using the command:

   CICSCTCL AMQSCIC0.CCS LIBS(MQM)
   

This is described in the Transaction Server for OS/2 Warp, V4 Application Programming Guide.

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