1<?xml version="1.0" encoding="UTF-8" standalone="no"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml">
4  <head>
5    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
6    <title>Aborting a Transaction</title>
7    <link rel="stylesheet" href="gettingStarted.css" type="text/css" />
8    <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
9    <link rel="start" href="index.html" title="Getting Started with Berkeley DB Transaction Processing" />
10    <link rel="up" href="usingtxns.html" title="Chapter 3. Transaction Basics" />
11    <link rel="prev" href="usingtxns.html" title="Chapter 3. Transaction Basics" />
12    <link rel="next" href="autocommit.html" title="Auto Commit" />
13  </head>
14  <body>
15    <div class="navheader">
16      <table width="100%" summary="Navigation header">
17        <tr>
18          <th colspan="3" align="center">Aborting a Transaction</th>
19        </tr>
20        <tr>
21          <td width="20%" align="left"><a accesskey="p" href="usingtxns.html">Prev</a> </td>
22          <th width="60%" align="center">Chapter 3. Transaction Basics</th>
23          <td width="20%" align="right"> <a accesskey="n" href="autocommit.html">Next</a></td>
24        </tr>
25      </table>
26      <hr />
27    </div>
28    <div class="sect1" lang="en" xml:lang="en">
29      <div class="titlepage">
30        <div>
31          <div>
32            <h2 class="title" style="clear: both"><a id="abortresults"></a>Aborting a Transaction</h2>
33          </div>
34        </div>
35      </div>
36      <p>
37                When you abort a transaction, all database 
38                <span>
39                        or store
40                </span>
41                modifications performed
42            under the protection of the transaction are discarded, and all
43            locks currently held by the transaction are released. In this event,
44            your data is simply left in the
45            state that it was in before the transaction began performing data
46            modifications.
47        </p>
48      <p>
49                Once you have aborted a transaction, the transaction
50                handle that you used for the transaction is no longer valid. To
51                perform database activities under the control of a new
52                transaction, you must obtain a fresh transactional handle.
53              </p>
54      <p>
55            To abort a transaction, call
56            
57            
58            <span><code class="methodname">Transaction.abort()</code>.</span>
59            
60            
61        </p>
62    </div>
63    <div class="navfooter">
64      <hr />
65      <table width="100%" summary="Navigation footer">
66        <tr>
67          <td width="40%" align="left"><a accesskey="p" href="usingtxns.html">Prev</a> </td>
68          <td width="20%" align="center">
69            <a accesskey="u" href="usingtxns.html">Up</a>
70          </td>
71          <td width="40%" align="right"> <a accesskey="n" href="autocommit.html">Next</a></td>
72        </tr>
73        <tr>
74          <td width="40%" align="left" valign="top">Chapter 3. Transaction Basics </td>
75          <td width="20%" align="center">
76            <a accesskey="h" href="index.html">Home</a>
77          </td>
78          <td width="40%" align="right" valign="top"> Auto Commit</td>
79        </tr>
80      </table>
81    </div>
82  </body>
83</html>
84