Getting Connected with the DB XA Module

DB XA Module User's Guide
Rogue Wave web site: Home Page | Main Documentation Page

4.2 Getting Connected with the DB XA Module

In the DB XA Module you establish database connectivity in much the same way as inthe DB Interface Module—by requesting an RWDBDatabase instance from RWDBManager. You still use the RWDBManager::database() method, but for XA-compliant database connectivity, you also provide an XA key in the sixth parameter, propertyString.

Here is the signature for static method RWDBManager::database():

static RWDBDatabase
database(const RWCString& accessLib,
         const RWCString& serverName,
         const RWCString& userName,
         const RWCString& passWord,
         const RWCString& databaseName,
         const RWCString& propertyString);

To establish a non-XA connection with DB Interface Module, you would provide arguments for all of the listed parameters, as shown here:

RWDBManager::database("accessLib", "serverName", "userName", 
                      "password", "databaseName",
                      "propertyString");

To establish an XA-enabled connection with the DB XA Module, however, you must provide only two arguments, accessLib and propertyString. All other parameters are not required, as shown here:

RWDBDatabase xaDB = RWDBManager::database("myAccessLib", "", "", "",
                                          "", "XA=xaParameter");

The value of the required arguments is specific to each access module. Note, for example, that the propertyString parameter is defined with argument "XA=xaParameter". The value of this argument is database-specific. For details specific to each access module, see Chapter 5.

To establish connections in a non-XA environment, see the DB Interface Module User's Guide. You can always produce non-XA connections, even when you have the DB XA Module.

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.