public void discard(int flags)
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
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
After DbTxn.discard has been called, regardless of its return, the
DbTxn handle may not be accessed again.
The DbTxn.discard method may fail and throw an exception encapsulating a non-zero error for the following conditions:
- 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.
Transaction Subsystem and Related Methods
Copyright Sleepycat Software