Use Distributed transaction support

The iSeries™ Access for Windows^® client supports Microsoft^® Transaction Server (MTS) and the Component Services model, with the iSeries Access ODBC driver and the IBMDASQL OLE DB provider.

MTS

MTS is a Microsoft component-based programming model and run-time environment for developing, deploying, and managing Internet server applications. In many three-tier environments, Active Server Pages (ASP) call MTS components to access databases, mainframe applications, and message queues. Used with iSeries Access for Windows running in the middle-tier of a three-tier environment, MTS components manage transactions between client applications, iSeries Access for Windows components, and the databases involved in the transactions.

MTS uses Microsoft Distributed Transaction Coordinator (MSDTC) in order to manage transactions that span multiple Database Management Systems (DBMS), and to ensure two-phase commit integrity when dealing with transactions whose implementations depend on mutual success.

In newer Windows server models, MTS has been replaced with the Component Services model. The iSeries Access for Windows ODBC and OLE DB providers support the Component Services model in the same manner as they support MTS.

Implementation notes

If the MSDTC cannot load the iSeries Access ODBC driver, the SQLSetConnectAttr( SQL_ATTR_ENLIST_IN_DTC ) will fail with reason code of 2 (XaRmCreate failed). If you installed iSeries Access for Windows PC5250 eumlator component, the MSDTC system environment path is set for you. To avoid this, the system environment path on the PC running MSDTC must include the path to the Shared directory within the directory in which iSeries Access for Windows is installed. For example: C:\Program Files\IBM\Client Access\Shared.
If you are using SSL, or any other configurable value on the Connections > Properties dialog in iSeries Navigator, your iSeries connection name in iSeries Navigator must match the connection name specified on the client PC managed by MTS. MSDTC uses the same connection names as iSeries Access for Windows ODBC client PCs managed by MTS to connect to the DB2^® UDB for iSeries database. To change the connection properties of the MSDTC connections, you must change the system account registry.
One way to do this is to use Incoming Remote Command (IRC) in combination with the CWBENV utility:

Run CWBENV on a client PC to extract the configuration information for an environment.
Copy the resulting file to the MSDTC PC.
Start the iSeries Access for Windows Remote Command service and ensure that it is configured to run in the Local System context.
Using the RUNRMTCMD command from a PC5250 session, send a CWBENV command to the MSDTC PC to import the environment.
See the User's Guide in the iSeries Access for Windows program group for more information on these functions.

For more information about MTS or the Component Services model, refer to the Microsoft Web site.