Preparing C programs in Linux

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

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

Work in your normal environment. For further information about programming 64 bit applications, see Coding standards on 64-bit platforms.


Linking libraries

The following tables lists the libraries that are needed when preparing C programs on Linux .

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

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

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

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

    Library file Program/exit type
    libmqm_r.so Server for C
    libmqic_r.so & libmqm_r.so Client for C
    Note:
    1. We cannot link to more than one library. That is, we cannot link to both a threaded and a non-threaded library at the same time.
    2. If you are writing an installable service (see the Administer for further information), you need to link to the libmqmzf.so library.
    3. If you are producing an application for external coordination by an XA-compliant transaction manager such as IBM TXSeries® Encina, or BEA Tuxedo, you need to link to the libmqmxa.so (or libmqmxa64.so if your transaction manager treats the 'long' type as 64 bit) and libmqz.so libraries in a non-threaded application and to the libmqmxa_r.so (or libmqmxa64_r.so ) and libmqz_r.so libraries in a threaded application.
    4. You must link IBM MQ libraries before any other product libraries.