Preparing C programs

Work in your normal environment. Precompiled C programs are supplied in the /opt/mqm/samp/bin directory.

Preparing C programs on HP-UX V11.00

The following is an example of how to build the sample program amqsput0 in a non-threaded environment:

cc -Aa -D_HPUX_SOURCE -o amqsput0 amqsput0.c -lmqm

The following is an example of how to build the sample program amqsput0 in a POSIX draft 10 threaded environment:

cc -Aa -D_HPUX_SOURCE -o amqsput0 amqsput0.c -lmqm_r -lpthread

The following is an example of how to build the sample program amqsput0 in a POSIX draft 4 (DCE) threaded environment:

cc -Aa -D_HPUX_SOURCE -D_PTHREADS_DRAFT -o amqsput0  \
amqsput0.c -lmqm_d -ld4r -lcma

If you want to use the programs on a machine that has only the WebSphere MQ client for HP-UX installed, recompile the programs to link them with the client library instead. The following is an example of how to build a non-threaded client:

cc -Aa -D_HPUX_SOURCE -o amqsput0 amqsput0.c -lmqic

The following is an example of how to build a POSIX draft 10 threaded client:

cc -Aa -D_HPUX_SOURCE -o amqsput0 amqsput0.c -lmqic_r -lpthread

The following is an example of how to build a POSIX draft 4 (DCE) threaded client:

cc -Aa -D_HPUX_SOURCE -D_PTHREADS_DRAFT4 -0 amqsput0  \
amqsput0.c -lmqic_d -ld4r -lcma

Linking libraries

The following lists the libraries you will need.

• You need to link your programs with the appropriate library provided by WebSphere MQ.

  In a non-threaded environment, you must link to one of the following libraries:
  

  Library file	Program/exit type
  libmqm.sl	Server for C
  libmqic.sl	Client for C

  In a threaded environment, you must link to one of the following libraries:
  

  Library file	Program/exit type
  libmqm_r.sl	Server for C
  libmqic_r.sl	Client for C

  In a POSIX draft 10 threaded environment on HP-UX V11.00, you must link to one of the following libraries:
  

  Library file	Program/exit type
  libmqm_r.sl	Server for C
  libmqic_r.sl	Client for C

  In a POSIX draft 4 (DCE) threaded environment on HP-UX V11.00, you must link to one of the following libraries:
  

  Library file	Program/exit type
  libmqm_d.sl	Server for C
  libmqic_d.sl	Client for C

  Notes:

  1. If you are writing an installable service (see WebSphere MQ System Administration Guide for further information), you need to link to the libmqmzf.sl 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, you need to link to the libmqmxa.a library in a non-threaded application and to the libmqmxa_r.a library in a threaded application.

  3. You must link WebSphere MQ libraries before any other product libraries (in this case, DCE and Encina). This ensures that any operating system functions that have been redefined by DCE are also used by WebSphere MQ.