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                
39                modifications performed
40            under the protection of the transaction are discarded, and all
41            locks currently held by the transaction are released. In this event,
42            your data is simply left in the
43            state that it was in before the transaction began performing data
44            modifications.
45        </p>
46      <p>
47                Once you have aborted a transaction, the transaction
48                handle that you used for the transaction is no longer valid. To
49                perform database activities under the control of a new
50                transaction, you must obtain a fresh transactional handle.
51              </p>
52      <p>
53            To abort a transaction, call
54            <span><code class="methodname">DB_TXN-&gt;abort()</code>.</span>
55            
56            
57            
58            
59        </p>
60    </div>
61    <div class="navfooter">
62      <hr />
63      <table width="100%" summary="Navigation footer">
64        <tr>
65          <td width="40%" align="left"><a accesskey="p" href="usingtxns.html">Prev</a>��</td>
66          <td width="20%" align="center">
67            <a accesskey="u" href="usingtxns.html">Up</a>
68          </td>
69          <td width="40%" align="right">��<a accesskey="n" href="autocommit.html">Next</a></td>
70        </tr>
71        <tr>
72          <td width="40%" align="left" valign="top">Chapter��3.��Transaction Basics��</td>
73          <td width="20%" align="center">
74            <a accesskey="h" href="index.html">Home</a>
75          </td>
76          <td width="40%" align="right" valign="top">��Auto Commit</td>
77        </tr>
78      </table>
79    </div>
80  </body>
81</html>
82