~ubuntu-branches/ubuntu/maverick/evolution-data-server/maverick-proposed

« back to all changes in this revision

Viewing changes to libdb/tcl/docs/txn.html

  • Committer: Bazaar Package Importer
  • Author(s): Didier Roche
  • Date: 2010-05-17 17:02:06 UTC
  • mfrom: (1.1.79 upstream) (1.6.12 experimental)
  • Revision ID: james.westby@ubuntu.com-20100517170206-4ufr52vwrhh26yh0
Tags: 2.30.1-1ubuntu1
* Merge from debian experimental. Remaining change:
  (LP: #42199, #229669, #173703, #360344, #508494)
  + debian/control:
    - add Vcs-Bzr tag
    - don't use libgnome
    - Use Breaks instead of Conflicts against evolution 2.25 and earlier.
  + debian/evolution-data-server.install,
    debian/patches/45_libcamel_providers_version.patch:
    - use the upstream versioning, not a Debian-specific one 
  + debian/libedata-book1.2-dev.install, debian/libebackend-1.2-dev.install,
    debian/libcamel1.2-dev.install, debian/libedataserverui1.2-dev.install:
    - install html documentation
  + debian/rules:
    - don't build documentation it's shipped with the tarball

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<!--Copyright 1999-2002 by Sleepycat Software, Inc.-->
2
 
<!--All rights reserved.-->
3
 
<html>
4
 
<head>
5
 
   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
6
 
   <meta name="GENERATOR" content="Mozilla/4.75 [en] (X11; U; Linux 2.2.16-22 i686) [Netscape]">
7
 
</head>
8
 
<body>
9
 
 
10
 
<h2>
11
 
<a NAME="Transaction Commands"></a>Transaction Commands</h2>
12
 
Transactions are used in a manner similar to the other subsystems.&nbsp;
13
 
We create a handle to the transaction and&nbsp; then use it for a variety
14
 
of operations.&nbsp; Some of the transaction commands use the environment
15
 
instead.&nbsp; Those are presented first.&nbsp; The transaction command
16
 
handle returned is the handle used by the various commands that can be
17
 
transaction protected, such as <a href="../../docs/api_tcl/db_cursor.html">cursors</a>.
18
 
<br>
19
 
<hr WIDTH="100%">
20
 
<p><b>> &lt;env> txn_checkpoint [-kbyte <i>kb</i>] [-min <i>min</i>]</b>
21
 
<p>This command causes a checkpoint of the transaction region.&nbsp; It
22
 
is a direct translation of the <a href="../../docs/api_c/txn_checkpoint.html">txn_checkpoint
23
 
</a>function.&nbsp;
24
 
It returns either a 0 (for success), a DB error message or it throws a
25
 
Tcl error with a system message.&nbsp; The arguments are:
26
 
<ul>
27
 
<li>
28
 
<b>-kbyte </b>causes the checkpoint to occur only if <b><i>kb</i></b> kilobytes
29
 
of log data has been written since the last checkpoint</li>
30
 
 
31
 
<li>
32
 
<b>-min</b> causes the checkpoint to occur only if <b><i>min</i></b> minutes
33
 
have passed since the last checkpoint</li>
34
 
</ul>
35
 
 
36
 
<hr WIDTH="100%">
37
 
<br><b>> &lt;env> txn_stat</b>
38
 
<p>This command returns transaction statistics.&nbsp; It is a direct translation
39
 
of the <a href="../../docs/api_c/txn_stat.html">txn_stat</a> function.&nbsp;
40
 
It will return a list of name/value pairs that correspond to the DB_TXN_STAT
41
 
structure.
42
 
<hr WIDTH="100%">
43
 
<br><b>> &lt;env> txn_id_set&nbsp;</b><i> current max</i>
44
 
<p>This is a diagnosic command that sets the next transaction id to be
45
 
allocated and the maximum transaction
46
 
<br>id, which is the point at which the relcaimation algorthm is triggered.
47
 
<hr WIDTH="100%">
48
 
<br><b>>&nbsp; &lt;txn> id</b>
49
 
<p>This command returns the transaction id.&nbsp; It is a direct call to
50
 
the <a href="../../docs/api_c/txn_id.html">txn_id</a> function.&nbsp; The
51
 
typical use of this identifier is as the <b><i>locker</i></b> value for
52
 
the <a href="lock.html">lock_get</a> and <a href="lock.html">lock_vec</a>
53
 
calls.
54
 
<hr WIDTH="100%">
55
 
<br><b>> &lt;txn> prepare</b>
56
 
<p>This command initiates a two-phase commit.&nbsp; It is a direct call
57
 
to the <a href="../../docs/api_c/txn_prepare.html">txn_prepare</a> function.&nbsp;
58
 
It returns either a 0 (for success), a DB error message or it throws a
59
 
Tcl error with a system message.
60
 
<hr WIDTH="100%"><a NAME="> <env> lock_vec"></a><b>> &lt;env> txn_timeout
61
 
<i>timeout</i></b>
62
 
<p>This command sets thetransaction timeout for transactions started in
63
 
the future in this environment.&nbsp; The timeout is in micorseconds.
64
 
<br>&nbsp;
65
 
<br>&nbsp;
66
 
</body>
67
 
</html>