The XA interface describes a structure called a switch table, which lists the names of the xa_ routines implemented in the resource manager. This structure is called xa_switch_t, and is defined in the xa.h header file. The switch table helps build servers that are truly independent of the database vendor being used.

In order to be integrated in the X/Open environment, each resource manager must define the name of its XA switch table. Sybase provides two XA switches:

In spite of the nominal implication that the TUX and TXS switch structures are TPM-specific, the use of these switches is not dependent on the use of Tuxedo or TXS TPMs. Rather, as described above, their use is dependent on whether the application is single-threaded or multithreaded.

You can use the following DB XA method to access the switch table in a database-independent manner:

If you have built the DB XA Module using a single-threaded build type, xaSwitch() returns sybase_TUX_xa_switch. If you are using a multithreaded build, this method returns sybase_TXS_xa_switch.

For static libraries, you must supply "SYBASE_CT" to the xaSwitch() method.

For shared libraries, you must supply the name of the access library, using the same name as the non-XA library. For example:

Note that the method RWDBManager::xaSwitch(const RWCString&) returns a void*. This return value must be cast to a struct xa_switch_t pointer.