Building the DB XA Module

Installing and Building Your SourcePro C++ Products
Rogue Wave web site: Home Page | Main Documentation Page

A.5 Building the DB XA Module

To build the DB XA Module:

Follow the instructions in Section 2.5 for creating a buildspec for SourcePro DB, with the following information.
In the component selection screen, select the DB Interface Module and the access module for your database. The DB XA Module does not appear in the component selection screen.
Click the Options button to open the RCB Options screen.
Check the Show advanced questions box.
Click OK to return to the main RCB window, and proceed with generating a buildspec as usual.
In the screen to enter compiler options (shown in Section 3.5.12), enter the following compiler commands into the Start of compile commands field:

XA flag: -DRWDBXA
Include path for the xa.h header file, if necessary.

Some database vendors, such as Oracle OCI, typically have the xa.h header file in their default include directory, making this step unnecessary. Other database vendors, such as Sybase and DB2, generally do not have the xa.h file in the include directory.

If the database vendor does not supply xa.h, this file should be located in the include directory of the TPM vendor. With Tuxedo, for example, you can include xa.h by specifying the TPM include path in the field Start of compile commands:
Compilation of access modules will fail if xa.h is not found in the include path.

Finish creating the buildspec by following the instructions in Section 2.5.
Run the buildspec as explained in Section 2.6.
Some combinations of platforms and access modules require an additional database library to be linked to allow access to the database XA APIs. Table 6 lists these combinations and the libraries they require.

Table 7: Additional libraries required by some platforms and access modules

Platform	Access Module	Additional Library
UNIX	Sybase	`libxadtm.a` or `libxadtm.so` or `libxadtm.sl`
Windows	Sybase	`libxadtm.lib`
Windows	Oracle OCI	`oraxa9.lib,` `oraxa10.lib`, or `oraxa11.lib`
Windows	DB2 CLI	`db2api.lib`

In case of a dynamic build, if an additional library is required, the access module build will likely fail. If the build does not fail, then the examples will fail at runtime. In either case, do the following:

a.	Open the makefile of the access module located in `buildspace/source/access-module`/`build-type`.
b.	Include the additional library on the link line.
c.	Link the access module again.

In case of a static build, if an additional library is required, the examples will not build. Do the following:

a.	Open the makefile of the examples located in `buildspace/examples/access-module`/`build-type`.
b.	Include the additional library on the link line of each example.
c.	Link all the examples again.

At this point you have installed and built the DB XA Module of SourcePro DB.

The Rogue Wave name and logo, and SourcePro, are registered trademarks of Rogue Wave Software. All other trademarks are the property of their respective owners.
Provide feedback to Rogue Wave about its documentation.