Chapter 3: Configuring the XA Environment

Using the DTM XA Interface with TUXEDO

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 3-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”.

**Table 3-4: Information needed to integrate the TUXEDO System**
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.

Wether 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.

View this book as PDF