Building the server environment for HP-UX (32-bit)

How to build the server environment for IBM MQ for HP-UX (32-bit).

Note: The 32-bit TUXEDO server environment can only be built on the Itanium platform.

Procedure

1. Create a directory (for example, APPDIR) in which the server environment is built and execute all commands in this directory.
2. Export the following environment variables, where TUXDIR is the root directory for TUXEDO:

   $ export CFLAGS="-Aa -D_HPUX_SOURCE"
   $ export FIELDTBLS= MQ_INSTALLATION_PATH/samp/amqstxvx.flds
   $ export VIEWFILES=$APPDIR/amqstxvx.V
   $ export TUXCONFIG=$APPDIR/tuxconfig
   $ export PATH=$TUXDIR/bin:/usr/bin:/sbin: MQ_INSTALLATION_PATH/bin:$PATH
   $ export SHLIB_PATH=$TUXDIR/lib: MQ_INSTALLATION_PATH/lib:/lib
   $ export FLDTBLDIR=$APPDIR:$TUXDIR/udataobj
   

3. Add the following line to the TUXEDO file udataobj/RM:

   MQSeries_XA_RMI:MQRMIXASwitchDynamic: \
   MQ_INSTALLATION_PATH/lib/libmqmxa.so MQ_INSTALLATION_PATH/lib/libmqm.so \
   /opt/tuxedo/lib/libtux.sl
   

4. Run the commands:

   $ mkfldhdr MQ_INSTALLATION_PATH/samp/amqstxvx.flds
   $ viewc    MQ_INSTALLATION_PATH/samp/amqstxvx.v
   

   After running the mkfldhdr and viewc commands, the amqstxvx.h header file is created in the TUXEDO application directory. Copy this file from the TUXEDO application directory into the TUXEDO include directory, and then run the following commands.

   $ buildtms    -o MQXA -r MQSERIES_XA_RMI
   $ buildserver -o MQSERV1 -f MQ_INSTALLATION_PATH/samp/amqstxsx.c \
          -f MQ_INSTALLATION_PATH/lib/libmqm.so \
          -r MQSERIES_XA_RMI -s MPUT1:MPUT \
          -s MGET1:MGET \
          -v -bshm
   $ buildserver -o MQSERV2 -f MQ_INSTALLATION_PATH/samp/amqstxsx.c \
          -f MQ_INSTALLATION_PATH/lib/libmqm.so \
          -r MQSERIES_XA_RMI -s MPUT2:MPUT \
          -s MGET2:MGET \
          -v -bshm
   $ buildclient -o doputs -f MQ_INSTALLATION_PATH/samp/amqstxpx.c \
          -f MQ_INSTALLATION_PATH/lib/libmqm.so
   $ buildclient -o dogets -f MQ_INSTALLATION_PATH/samp/amqstxgx.c \
          -f MQ_INSTALLATION_PATH/lib/libmqm.so
   

5. Edit ubbstxcx.cfg and add details of the machine name, working directories, and queue manager as necessary:

   $ tmloadcf  -y MQ_INSTALLATION_PATH/samp/ubbstxcx.cfg
   

6. Create the TLOGDEVICE:

   $tmadmin -c
   

   A prompt is displayed. At this prompt, enter:

   > crdl -z /APPDIR/TLOG1
   

7. Start the queue manager:

   $ strmqm
   

8. Start TUXEDO:

   $ tmboot -y
   

What to do next

We can now use the doputs and dogets programs to put messages to a queue and retrieve them from a queue.