ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaik_5.4.0.1/distributedtransactionsupport.htm

73 lines
4.5 KiB
HTML
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="reference" />
<meta name="DC.Title" content="Distributed transaction support" />
<meta name="abstract" content="Distributed transactions allow an application to coordinate units of work across multiple databases." />
<meta name="description" content="Distributed transactions allow an application to coordinate units of work across multiple databases." />
<meta name="DC.Relation" scheme="URI" content="rzaikodbcapifunctions.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1999, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1999, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="distributedtransactionsupport" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>Distributed transaction support</title>
</head>
<body id="distributedtransactionsupport"><a name="distributedtransactionsupport"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Distributed transaction support</h1>
<div><p>Distributed transactions allow an application to coordinate units
of work across multiple databases.</p>
<div class="section"><p>There are two different interfaces into the ODBC driver that allow
one to complete a distributed transaction. The two interfaces are MTS (Microsoft<sup>®</sup> Transaction
Server) and XA API support. Both of these interfaces are affected by the
setting of the XALOCKTIMEOUT and XATXNTIMEOUT <a href="connectkeywords.htm#connectkeywords">connection
string settings</a>.</p>
</div>
<div class="section"><h4 class="sectiontitle">MTS </h4><p>For more information on MTS refer to <a href="../rzaii/rzaiimts.htm">Using Microsoft Transaction
Server (MTS)</a>.</p>
</div>
<div class="section"><h4 class="sectiontitle">XA API support</h4><p>Refer to the 2140, 2141, 2142, and
2143 connection attributes on the <strong>Connection and statement attributes</strong> page
for a description of some of the relevant options for getting the XA support
to work. Note, that the 2141 and 2142 connection attributes do the same thing
as the XALOCKTIMEOUT and XATXNTIMEOUT connection string settings.</p>
</div>
<div class="section"> <div class="note"><span class="notetitle">Note:</span> <ul><li>Multiple iSeries™ connections
can be included in the distributed transaction only on V5R3 or later servers.
</li>
<li>xa_open is only called by the application for recovery purposes. When
connecting through the ODBC API SQLConnect or SQLDriverConnect the xa_open
is done automatically if the RMID was set via the 2142 connection attribute.
</li>
<li>The connection attribute SQL_ATTR_AUTOCOMMIT must be set as SQL_AUTOCOMMIT_ON.
</li>
<li>If an application wishes to start an XA transaction and then do some non-XA
transaction work, one must set the RMID to 0 to indicate to the driver that
the XA work is completed. </li>
<li>To do XA recovery an application calls xa_open with a string of: <em>SYSTEM=mySystem;UID=myUserID;PWD="myPassword";DATABASE=myDatabase; </em> replacing mySystem with your system name, myUserID with your user ID on
that system, and myPassword with that user ID's password. Note that the string
must be specified exactly as shown. Alternatively you can specify just <em>SYSTEM=mySystem;</em>. </li>
</ul>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaikodbcapifunctions.htm" title="Learn about implementations issues when using ODBC APIs.">Implementation issues of ODBC APIs</a></div>
</div>
</div>
</body>
</html>