Berkeley DB: DbTxnMgr.stat
Description: Berkeley DB: An embedded database programmatic toolkit.
Keywords: embedded,database,programmatic,toolkit,b+tree,btr ee,hash,hashing,transaction,transactions,locking,logging,access method,access me thods,java,C,C++

# DbTxnMgr.stat

`

###

    import com.sleepycat.db.*;

    public DbTxnStat stat()
    	throws DbException;

# Description

The 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:

public int st_refcnt;
  The number of references to the region.
public int st_regsize;
  The size of the region.
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 returned by time(2)).
public int st_last_txnid;
  The last transaction ID allocated.
public int st_maxtxns;
  The maximum number of active transactions supported by the region.
public int st_naborts;
  The number of transactions that have aborted.
public int st_nactive;
  The number of transactions that are currently active.
public int st_nbegins;
  The number of transactions that have begun.
public int st_ncommits;
  The number of transactions that have committed.
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 DbTxnMgr.stat method throws an exception that encapsulates an errno on failure.

# Errors

If a fatal error occurs in Berkeley DB, the DbTxnMgr.stat method may fail and throw a DbRunRecoveryException, at which point all subsequent database calls will also fail in the same way.

The DbTxnMgr.stat method may fail and throw an exception for any of the errors specified for the following Berkeley DB and C library functions: abort(3), fcntl(3), fprintf(3), getpid(3), malloc(3), and memset(3).

# Class

DbTxnMgr

# See Also

DbTxnMgr.begin, DbTxnMgr.checkpoint, DbTxnMgr.close, DbTxnMgr.open, DbTxnMgr.stat and DbTxnMgr.unlink.`