Getting Connected with the DB XA Module

SourcePro DB : DB XA Module User’s Guide : Using the DB XA Module Database Classes : 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.