import com.sleepycat.db.*;

public void discard(int flags)
    throws DbException;

Description

The DbTxn.discard method frees up all the per-process resources associated with the specified DbTxn handle, neither committing nor aborting the transaction. This call may be used only after calls to DbEnv.txn_recover when there are multiple global transaction managers recovering transactions in a single Berkeley DB environment. Any transactions returned by DbEnv.txn_recover that are not handled by the current global transaction manager should be discarded using DbTxn.discard.

The flags parameter is currently unused, and must be set to 0.

The DbTxn.discard method returns EINVAL if the transaction handle does not refer to a transaction that was recovered into a prepared but not yet completed state. Otherwise, the DbTxn.discard method throws an exception that encapsulates a non-zero error value on failure.

After DbTxn.discard has been called, regardless of its return, the DbTxn handle may not be accessed again.

Errors

The DbTxn.discard method may fail and throw an exception encapsulating a non-zero error for the following conditions:

EINVAL

An invalid flag value or parameter was specified.

The transaction handle does not refer to a transaction that was recovered into a prepared but not yet completed state.

The DbTxn.discard 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 DbTxn.discard method may fail and throw a DbRunRecoveryException, in which case all subsequent Berkeley DB calls will fail in the same way.

Class

See Also