1<!--$Id: xa_intro.so,v 10.22 2001/03/30 20:34:54 bostic Exp $--> 2<!--Copyright (c) 1997,2008 Oracle. All rights reserved.--> 3<!--See the file LICENSE for redistribution information.--> 4<html> 5<head> 6<title>Berkeley DB Reference Guide: XA Introduction</title> 7<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> 8<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> 9</head> 10<body bgcolor=white> 11<a name="2"><!--meow--></a><a name="3"><!--meow--></a> 12<table width="100%"><tr valign=top> 13<td><b><dl><dt>Berkeley DB Reference Guide:<dd>Distributed Transactions</dl></b></td> 14<td align=right><a href="/xa/build.html"><img src="/images/prev.gif" alt="Prev"></a><a href="/toc.html"><img src="/images/ref.gif" alt="Ref"></a><a href="/xa/xa_config.html"><img src="/images/next.gif" alt="Next"></a> 15</td></tr></table> 16<p align=center><b>XA Introduction</b></p> 17<p>Berkeley DB can be used as an XA-compliant resource manager. The XA 18implementation is known to work with the Tuxedo(tm) transaction 19manager.</p> 20<p>The XA support is encapsulated in the resource manager switch 21db_xa_switch, which defines the following functions:</p> 22<blockquote><pre>__db_xa_close Close the resource manager. 23__db_xa_commit Commit the specified transaction. 24__db_xa_complete Wait for asynchronous operations to 25 complete. 26__db_xa_end Disassociate the application from a 27 transaction. 28__db_xa_forget Forget about a transaction that was heuristically 29 completed. (Berkeley DB does not support heuristic 30 completion.) 31__db_xa_open Open the resource manager. 32__db_xa_prepare Prepare the specified transaction. 33__db_xa_recover Return a list of prepared, but not yet 34 committed transactions. 35__db_xa_rollback Abort the specified transaction. 36__db_xa_start Associate the application with a 37 transaction. 38</pre></blockquote> 39<p>The Berkeley DB resource manager does not support the following optional 40XA features:</p> 41<p><ul type=disc> 42<li>Asynchronous operations 43<li>Transaction migration 44</ul> 45<p>The Tuxedo System is available from <a href="http://www.beasys.com">BEA Systems, Inc.</a></p> 46<p>For additional information on Tuxedo, see</p> 47<blockquote><i>Building Client/Server Applications Using Tuxedo</i>, 48by Hall (John Wiley & Sons, Inc.).</blockquote> 49<p>For additional information on XA Resource Managers, see</p> 50<blockquote>X/Open CAE Specification 51<i>Distributed Transaction Processing: The XA Specification</i>, 52X/Open Document Number: XO/CAE/91/300.</blockquote> 53<p>For additional information on The Tuxedo System, see</p> 54<blockquote><i>The Tuxedo System</i>, 55by Andrade, Carges, Dwyer and Felts (Addison Wesley Longman).</blockquote> 56<table width="100%"><tr><td><br></td><td align=right><a href="/xa/build.html"><img src="/images/prev.gif" alt="Prev"></a><a href="/toc.html"><img src="/images/ref.gif" alt="Ref"></a><a href="/xa/xa_config.html"><img src="/images/next.gif" alt="Next"></a> 57</td></tr></table> 58<p><font size=1>Copyright (c) 1996,2008 Oracle. All rights reserved.</font> 59</body> 60</html> 61