Building the SoftWoehr C++ Class Library for IBM MQSeries**
Revision 1.0.5
SoftWoehr C++ Class Library for IBM MQSeries** and this documentation
are Copyright *C* 1999, 2000
Jack J. Woehr, P. O. Box 51, Golden, Colorado 80402-0051 USA
http://www.softwoehr.com
Table of Contents
Source distribution
The class library is distributed as source with some examples. Depending
on your platform, you must build a shared object (Unix/Linux) or DLL (Windows
NT) to use the class library. Since everything provided is standard C++
it should compile under any standard C++ system. Makefiles are provided
for Linux, Solaris and an IBM Visual Age for C++ project file is provided
for Windows NT**. You can easily write a makefile for other platforms,
as this code should be entirely Standard C++. Please email
the author if you notice any non-standard usage!
Building on GNU Linux
Supported is GCC 2.95.x and above. Type
gmake -f Makefile.linux [MQARCH=5.1_client|5.1_server|MA57]
[MULTITHREADED=yes|no]
to build the shared library and
gmake -f Makefile.samples.linux [MQARCH=5.1_client|5.1_server|MA57]
[MULTITHREADED=yes|no]
to build the samples.
The MQARCH macro indicates which version of MQSeries for Linux
development libraries should be linked with. If the MQARCH macro
is omitted, 5.1_server is assumed.
The MULTITHREADED macro indicates if the libraries and samples
should link with the multithreaded version of MQSeries for Linux libraries.
If the MULTITHREADED switch is omitted, no is assumed.
-
The Makefile assumes you have installed the appropriate IBM MQ product
or client SupportPac in /opt
-
Please modify Makefile.linux if your installation is different.
-
The Makefile will create the ../bin ../obj ../lib directories
automatically and output will be found there, not in the source directory
(which latter is the case if you build on Windows NT)..
-
Always compile for and link with the multithreaded version of the GCC
libraries.
Building IBM MQSeries Samples
on Linux
Incidentally, we have included a makefile Makefile.amqsamp.linux
which builds in a rather unsophisticated fashion the examples which were
distributed in the MQSeries
Client for Linux SupportPac.
Building on Sun Solaris
Supported is Sun CC 5.x.
Type
gmake -f Makefile.sun
to build everything. Yes, you do need GNU
gmake!
-
The makefile assumes you have installed the appropriate IBM
MQSeries product or client
SupportPac in /opt
-
Please modify Makefile.sun if your installation is different.
-
You may need to create ./bin ./obj ./lib directories by hand into
which the Makefile wants to put the output of the build.
-
Always compile for and link with the multithreaded version of the Sun
CC libraries.
Building on Microsoft Windows NT
Supported is IBM Visual
Age C++ 4.x. Load the jxmqdll.icc project and build it. Build
each of the other .icc projects to build the samples.
-
The path to the MQ includes and libs is hard-coded in the .icc files.
-
You will certainly have to change this yourself!
-
Everything gets built in the same directory as the sources.
-
Always compile for and link with the multithreaded version of the Visual
Age libraries.