Building the server environment for Solaris (64-bit)

How to build the server environment for IBM MQ for Solaris (64-bit).


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


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="-I /APPDIR"
    $ export FIELDTBLS=amqstxvx.flds
    $ export VIEWFILES=amqstxvx.V
    $ export SHLIB_PATH=$TUXDIR/lib: MQ_INSTALLATION_PATH/lib:/lib64
    $ export LD_LIBRARY_PATH=$TUXDIR/lib64: MQ_INSTALLATION_PATH/lib64:/lib64
    
  3. Add the following to the TUXEDO file udataobj/RM (RM must include MQ_INSTALLATION_PATH/lib/libmqmcs and MQ_INSTALLATION_PATH/lib/libmqmzse).
    MQSERIES_XA_RMI:MQRMIXASwitchDynamic: \
    MQ_INSTALLATION_PATH/lib64/libmqmxa64.a MQ_INSTALLATION_PATH/lib64/libmqm.so \
    /opt/tuxedo/lib64/libtux.a MQ_INSTALLATION_PATH/lib64/libmqmcs.so \
    MQ_INSTALLATION_PATH/lib64/libmqmzse.so
    
  4. Run the commands:
    $ mkfldhdr    amqstxvx.flds
    $ viewc       amqstxvx.v
    $ buildtms    -o MQXA -r MQSERIES_XA_RMI
    $ buildserver -o MQSERV1 -f amqstxsx.c \
           -f MQ_INSTALLATION_PATH/lib64/libmqm.so \
           -r MQSERIES_XA_RMI -s MPUT1:MPUT \
           -s MGET1:MGET \
           -v -bshm
           -l -ldl
    $ buildserver -o MQSERV2 -f amqstxsx.c \
           -f MQ_INSTALLATION_PATH/lib64/libmqm.so \
           -r MQSERIES_XA_RMI -s MPUT2:MPUT \
           -s MGET2:MGET \
           -v -bshm
           -l -ldl
    $ buildclient -o doputs -f amqstxpx.c \
           -f MQ_INSTALLATION_PATH/lib64/libmqm.so \
           -f MQ_INSTALLATION_PATH/lib64/libmqmzse.co \
           -f MQ_INSTALLATION_PATH/lib64/libmqmcs.so
    $ buildclient -o dogets -f amqstxgx.c \
           -f MQ_INSTALLATION_PATH/lib64/libmqm.so
           -f MQ_INSTALLATION_PATH/lib64/libmqmzse.co \
           -f MQ_INSTALLATION_PATH/lib64/libmqmcs.so
    
  5. Edit ubbstxcx.cfg and add details of the machine name, working directories, and queue manager as necessary:
    $ tmloadcf  -y 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.