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