head 1.2; access; symbols RPM_4_2_1:1.1.1.5 RPM_4_2:1.1.1.5 RPM_4_1_1:1.1.1.5 RPM_4_1:1.1.1.4 RPM_4_0_5:1.1.1.3 RPM_4_0_4:1.1.1.2 RPM_4_0_3:1.1.1.1 RPM:1.1.1; locks; strict; comment @# @; 1.2 date 2008.01.02.09.54.02; author rse; state dead; branches; next 1.1; commitid z4cpSiAhOCXk5PLs; 1.1 date 2001.07.23.20.45.37; author rse; state Exp; branches 1.1.1.1; next ; 1.1.1.1 date 2001.07.23.20.45.37; author rse; state Exp; branches; next 1.1.1.2; 1.1.1.2 date 2002.01.08.00.30.11; author rse; state Exp; branches; next 1.1.1.3; 1.1.1.3 date 2003.01.18.13.49.00; author rse; state Exp; branches; next 1.1.1.4; 1.1.1.4 date 2001.12.06.00.08.13; author rse; state Exp; branches; next 1.1.1.5; 1.1.1.5 date 2003.01.18.14.04.59; author rse; state Exp; branches; next ; desc @@ 1.2 log @remove the ancient RPM 4.2.1 source tree copy @ text @ Berkeley DB: DbEnv.txn_stat

DbEnv.txn_stat

APIRef

import com.sleepycat.db.*;

public DbTxnStat txn_stat() throws DbException;

Description

The DbEnv.txn_stat method creates a DbTxnStat object encapsulating a statistical structure. The transaction region statistics are stored in a DbTxnStat object. The following data fields are available from the DbTxnStat object:

The transaction region statistics are stored in a structure of type DB_TXN_STAT. The following DB_TXN_STAT fields will be filled in:

public DbLsn st_last_ckp;
The LSN of the last checkpoint.
public DbLsn st_pending_ckp;
The LSN of any checkpoint that is currently in progress. If st_pending_ckp is the same as st_last_ckp there is no checkpoint in progress.
public long st_time_ckp;
The time the last completed checkpoint finished (as the number of seconds since the Epoch, returned by the IEEE/ANSI Std 1003.1 (POSIX) time interface).
public int st_last_txnid;
The last transaction ID allocated.
public int st_maxtxns;
The maximum number of active transactions possible.
public int st_nactive;
The number of transactions that are currently active.
public int st_maxnactive;
The maximum number of active transactions at any one time.
public int st_nbegins;
The number of transactions that have begun.
public int st_naborts;
The number of transactions that have aborted.
public int st_ncommits;
The number of transactions that have committed.
public int st_regsize;
The size of the region.
public int st_region_wait;
The number of times that a thread of control was forced to wait before obtaining the region lock.
public int st_region_nowait;
The number of times that a thread of control was able to obtain the region lock without waiting.
public Active st_txnarray[];
The array of active transactions. Each element of the array is an object of type DbTxnStat.Active, a top level inner class, that has the following fields:

public int txnid;
The Transaction ID.
public DbLsn lsn;
The Lsn of the begin record.

The DbEnv.txn_stat method throws an exception that encapsulates a non-zero error value on failure.

Errors

The DbEnv.txn_stat method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods. If a catastrophic error has occurred, the DbEnv.txn_stat method may fail and throw a DbRunRecoveryException, in which case all subsequent Berkeley DB calls will fail in the same way.

Class

DbEnv, DbTxn

See Also

DbEnv.set_tx_max, DbEnv.set_tx_timestamp, DbTxn.abort, DbEnv.txn_begin, DbEnv.txn_checkpoint, DbTxn.commit, DbTxn.discard, DbTxn.id, DbTxn.prepare, DbEnv.txn_recover, and DbEnv.txn_stat.

APIRef

Copyright Sleepycat Software @ 1.1 log @Initial revision @ text @d1 1 a1 1 @ 1.1.1.1 log @Import: RPM 4.0.3 @ text @@ 1.1.1.2 log @Import: RPM 4.0.4 @ text @d1 1 a1 1 d17 1 a17 1 APIRef d24 2 a25 2 public DbTxnStat txn_stat(int flags) throws DbException; a31 5

The flags value must be set to 0 or the following value:

Db.DB_STAT_CLEAR
Reset statistics after returning their values.
a47 1
public int st_nrestores;
The number of transactions that have been restored. a80 1 DbTxn.set_timeout d85 1 a85 1 APIRef @ 1.1.1.3 log @Import: RPM 4.0.5 @ text @d1 2 a2 2 a3 1 d28 4 a31 1

The DbEnv.txn_stat method returns the transaction subsystem statistics. d37 2 a38 3

The DbEnv.txn_stat method creates a DbTxnStat object encapsulating the transaction region statistics. The following data fields are available from the DbTxnStat object: d41 3 d63 2 a64 3

public int txnid;
The transaction ID of the transaction.
public int parentid;
The transaction ID of the parent transaction (or 0, if no parent).
public DbLsn lsn;
The current log sequence number when the transaction was begun. d71 3 a73 3 If a catastrophic error has occurred, the DbEnv.txn_stat method may fail and throw a DbRunRecoveryException, in which case all subsequent Berkeley DB calls will fail in the same way. d75 1 a75 1 DbEnv, DbTxn d77 13 a89 1 Transaction Subsystem and Related Methods @ 1.1.1.4 log @Import: RPM 4.1 @ text @d1 2 a2 2 d4 1 d29 1 a29 4

The DbEnv.txn_stat method creates a DbTxnStat object encapsulating a statistical structure. The transaction region statistics are stored in a DbTxnStat object. The following data fields are available from the DbTxnStat object: d35 3 a37 2

The transaction region statistics are stored in a structure of type DB_TXN_STAT. The following DB_TXN_STAT fields will be filled in: a39 3

public DbLsn st_pending_ckp;
The LSN of any checkpoint that is currently in progress. If st_pending_ckp is the same as st_last_ckp there is no checkpoint in progress. d59 3 a61 2

public int txnid;
The Transaction ID.
public DbLsn lsn;
The Lsn of the begin record. d68 3 a70 3 If a catastrophic error has occurred, the DbEnv.txn_stat method may fail and throw a DbRunRecoveryException, in which case all subsequent Berkeley DB calls will fail in the same way. d72 1 a72 1 DbEnv, DbTxn d74 1 a74 13 DbEnv.set_tx_max, DbEnv.set_tx_timestamp, DbTxn.abort, DbEnv.txn_begin, DbEnv.txn_checkpoint, DbTxn.commit, DbTxn.discard, DbTxn.id, DbTxn.prepare, DbEnv.txn_recover, DbTxn.set_timeout and DbEnv.txn_stat. @ 1.1.1.5 log @Import: RPM 4.1.1 @ text @d1 2 a2 2 a3 1 d28 4 a31 1

The DbEnv.txn_stat method returns the transaction subsystem statistics. d37 2 a38 3

The DbEnv.txn_stat method creates a DbTxnStat object encapsulating the transaction region statistics. The following data fields are available from the DbTxnStat object: d41 3 d63 2 a64 3

public int txnid;
The transaction ID of the transaction.
public int parentid;
The transaction ID of the parent transaction (or 0, if no parent).
public DbLsn lsn;
The current log sequence number when the transaction was begun. d71 3 a73 3 If a catastrophic error has occurred, the DbEnv.txn_stat method may fail and throw a DbRunRecoveryException, in which case all subsequent Berkeley DB calls will fail in the same way. d75 1 a75 1 DbEnv, DbTxn d77 13 a89 1 Transaction Subsystem and Related Methods @