The following sections explain the application-specific steps you need to take to integrate the XA Interface with TUXEDO.
The application-specific part of the integration involves:
Linking the application with the application servers
Setting up the UBBCONFIG file
Building a transaction monitor server (TMS)
Integrating the application servers with the resource managers
It is assumed that TUXEDO is installed in the $TUXDIR directory and that any resource managers are also installed on the system.
In the following procedures, replace the environment
variables with the actual TUXEDO paths
as follows: replace $TUXDIR with
your actual root directory path, and replace $SYBASE with
the path to the DTM XA Interface installation
directory.
Table 2-4 provides the Sybase-specific information you need to perform the TUXEDO integration. The TUXEDO Installation Guide discusses this information in “Integrating a Resource Manager With System/T”.
Type of Information |
Sybase Specific |
Description |
|---|---|---|
RM name |
SYBASE_XA_SERVER |
The name of the resource manager in the name element of the xa_switch_t structure. |
XA structure name |
sybase_TUX_xa_switch |
The name of the xa_switch_t structure that contains the resource manager identifier, the flags for the resource manager’s capabilities, and the function pointers of the XA functions. |
Library name |
The library files ct_r, cs_r, comn_r, tcl_r, and intl_r which are located in $SYBASE/$SYBASE_OCS/lib |
The list of files needed to support the DTM XA Interface, and a full path name. |
Open string contents |
See “ Open string parameters for DTM XA Interface” in this document for more information.. |
The format of the information string passed to the functions. |
Whether you should use the DTM
XA with the reentrant libraries (such as ct_r, cs_r, comn_r, tcl_r,
and intl_r)
depends on whether or not you are developing threaded applications.
For threaded applications, you must use reentrant libraries. For
non-threaded applications, you can use non-reentrant libraries such
as ct, cs, comn, tcl, and intl.
See also “XA configuration file for DTM XA Interface” for information on creating an XA configuration file.
