|
|
This topic contains the following sections:
Object files for the Tuxedo MQ Adapter are included as part of the standard Tuxedo distribution. After customizing the $TUXDIR/udataobj/RM file with any values specific to the MQ installation being used, the Tuxedo administrator uses the buildmqadapter(1) command to build the MQ adapter executables. The 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 Tuxedo software is currently available on HP-UX, Solaris, AIX, Linux, and Windows versions of Tuxedo. Ports of Tuxedo to other platforms will include the MQ Adapter if WebSphere MQ is supported by IBM on the target platform.
The Tuxedo administrator should complete the following tasks before building the MQ Adapter TMS and adapter servers:
The Tuxedo installation program attempts to add a sensible default line for WebSphere MQ 6.0 to the $TUXDIR/udataobj/RM file when installing Tuxedo. For example, on 32-bit Solaris, the installation program adds the following lines:
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 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 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 Tuxedo administrator with write permission in the $TUXDIR/bin directory:
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.
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.)
Add the following lines to the *GROUPS section of the UBBCONFIG file for the group used for the MQ Adapter for Tuxedo servers.
MQ_GROUP_NAME TMSNAME=MQXA TMSCOUNT=3
OPENINFO="MQSeries_XA_RMI:BEA.TEST.MANAGER"
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 Tuxedo, make sure the following has been done before continuing with the MQ Adapter configuration procedures:
|