Preparing C programs in HP Integrity NonStop Server

This topic contains information to consider when you are preparing C programs in HP Integrity NonStop Server together with examples of the commands we use when you are building applications when you are using the OSS C compiler and when you are using the Guardian C compiler.

Precompiled C programs are supplied in the MQ_INSTALLATION_PATH/opt/mqm/samp/bin directory. To build a sample from source code, use the c89 compiler.

You must link your programs with the appropriate library provided by IBM MQ . The following table lists the libraries that you must link to when you are preparing C programs on HP Integrity NonStop Server.

Table 1. . HP Integrity NonStop Server link libraries
Library	Description
libmqic.so	OSS unthreaded
libmqic_r.so	OSS multi-threaded
mqic	Guardian

Multi-threaded native IBM MQ applications must use the Posix User Threads (PUT) feature. There is no support for Standard Posix Threads (SPT) in this product.

Building applications using the OSS C compiler

This section contains examples of the commands that are used to build programs that are targeted for either OSS or Guardian when you are using the OSS compiler.

MQ_INSTALLATION_PATH represents the high-level directory in which IBM MQ is installed.

The following example builds an unthreaded C client OSS application:

c89 -Wsystype=oss -o amqsputc amqsput0.c -IMQ_INSTALLATION_PATH/opt/mqm/inc
-LMQ_INSTALLATION_PATH/opt/mqm/lib -lmqic

The following example builds a multi-threaded C client OSS application:

c89 -Wsystype=oss -D_PUT_MODEL_ -o amqsputc amqsput0.c -IMQ_INSTALLATION_PATH/opt/mqm/inc
-LMQ_INSTALLATION_PATH/opt/mqm/lib -lmqic_r -lput

The following example builds a Guardian C client application:

c89 -Wsystype=guardian -o /G/vol/subvol/amqsputc amqsput0.c -IMQ_INSTALLATION_PATH/opt/mqm/inc
-LMQ_INSTALLATION_PATH/opt/mqm/lib/G -lmqic

Building applications using the Guardian C compiler

This section contains examples of the commands that are used to build programs that are targeted for Guardian when you are using the Guardian compiler.

MQ_INSTALLATION_PATH represents the Guardian volume and subvolume in which IBM MQ is installed.

The following example builds a Guardian C client application:

CCOMP /in AMQSPUT0/ AMQSPUTC;&
       runnable,systype guardian,nolist,&
       ssv0 "$system.system",&
       ssv1 "MQINSTALLATION_SUBVOL",&
       ld(-LMQINSTALLATION_SUBVOL -lmqic)