This topic contains the following sections:
Object files for the Oracle Tuxedo MQ Adapter are included as part of the standard Oracle Tuxedo distribution. After customizing the
$TUXDIR/udataobj/RM file with any values specific to the MQ installation being used, the Oracle Tuxedo administrator uses the
buildmqadapter(1) command to build the MQ adapter executables. The Oracle Tuxedo administrator also needs to use the
buildtms(1) command to build the TMS for the WebSphere MQ Resource manager. This chapter describes the process of building the MQ Adapter executables.
The MQ Adapter for Oracle Tuxedo software is currently available on HP-UX, Solaris, AIX, Linux, and Windows versions of Oracle Tuxedo. Ports of Oracle Tuxedo to other platforms will include the MQ Adapter if WebSphere MQ is supported by IBM on the target platform.
The Oracle Tuxedo administrator should complete the following tasks before building the MQ Adapter TMS and adapter servers:
The Oracle Tuxedo installation program attempts to add a sensible default line for WebSphere MQ 6.0 to the
$TUXDIR/udataobj/RM file when installing Oracle Tuxedo. For example, on 32-bit Solaris, the installation program adds the following lines:
# WebSphere MQ 6.0
MQSeries_XA_RMI:MQRMIXASwitchDynamic: /opt/mqm/lib/libmqmxa.so /opt/mqm/lib/libmqm.so
(On other hardware platforms, the default library suffixes and locations may be different.)
As the Oracle Tuxedo administrator, you should review this information to determine if it is correct for your installation. You may need to modify the RM file information
On Windows NT, there is no standard installation location for WebSphere MQ, so the variable
%MQMDIR% is used in the
%TUXDIR%\udataobj\RM file. This variable should be set before building the MQ Adapter servers.
If using a 64-bit version of Oracle Tuxedo, be sure to link with libraries in the WebSphere MQ lib64 directory and not in the 32-bit lib directory, and be sure to link with the mqmxa64 library and not the mqmxa library.
To build the MQ adapter servers, execute the following commands as the Oracle Tuxedo administrator with write permission in the
This command will install the TM_MQI, TM_MQO, and TMQUEUE_MQM servers in the
$TUXDIR/bin directory. The -v option indicates that buildmqadapter will write the buildserver and compiler command lines used to link the 3 servers as part of its output.
|Note:||you must use the build utilities to build the Oracle Tuxedo MQ Adapter Servers.|
Alternatively the MQ adapter servers can be built one at a time using the following commands:
buildTM_MQI -v -o $TUXDIR/bin/TM_MQI
buildTM_MQO -v -o $TUXDIR/bin/TM_MQO
buildTMQUEUE_MQM -v -o $TUXDIR/bin/TMQUEUE_MQM
(If building the servers one at a time, it is possible to specify $APPDIR instead of $TUXDIR/bin as the output directory.)
Run the following command while in the
$TUXDIR/bin directory to create the resource manager executable:
buildtms -o MQXA -r MQSeries_XA_RMI
(An alternate file name can be specified instead of MQXA if desired, and the output file can be placed in either $TUXDIR/bin or in $APPDIR.)
|Note:||You must use the
Add the following lines to the
*GROUPS section of the UBBCONFIG file for the group used for the MQ Adapter for Oracle Tuxedo servers.
MQ_GROUP_NAME TMSNAME=MQXA TMSCOUNT=3
In the above example,
MQ_GROUP_NAME is the name of the group in which the MQ adapter servers are defined. Your application may use whatever name it wants for this group. The number of TMS servers in this group is 3. BEA.TEST.MANAGER is the name of the queue manager being used, and another name should be substituted if your queue manager is named something else.
After you complete the installation procedures for the MQ Adapter for Oracle Tuxedo, make sure the following has been done before continuing with the MQ Adapter configuration procedures: