DbTxn.discard
DbTxn.discard |
|
import com.sleepycat.db.*;public void discard(u_int32_t flags) throws DbException;
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.
The DbTxn.discard method may fail and throw an exception encapsulating a non-zero error for the following conditions:
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.
|
|
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
d25 1
a25 1
throws DbException;
a67 1
DbTxn.set_timeout
d72 1
a72 1
@
1.1.1.3
log
@Import: RPM 4.0.5
@
text
@d1 2
a2 2
a3 1
d24 1
a24 1
public void discard(int flags)
d39 2
a40 2
yet completed state.
Otherwise, the DbTxn.discard method throws an exception that encapsulates a non-zero error value on
d52 3
a54 3
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.
d56 1
a56 1
DbEnv, DbTxn
d58 13
a70 1
Transaction Subsystem and Related Methods
@
1.1.1.4
log
@Import: RPM 4.1
@
text
@d1 2
a2 2
d4 1
d25 1
a25 1
public void discard(u_int32_t flags)
d40 2
a41 2
yet completed state.
Otherwise, the DbTxn.discard method throws an exception that encapsulates a non-zero error value on d53 3 a55 3 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. d57 1 a57 1 DbEnv, DbTxn d59 1 a59 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 d24 1 a24 1 public void discard(int flags) d39 2 a40 2 yet completed state. Otherwise, the DbTxn.discard method throws an exception that encapsulates a non-zero error value on d52 3 a54 3 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. d56 1 a56 1 DbEnv, DbTxn d58 13 a70 1 Transaction Subsystem and Related Methods @