AbortXtd

Abort the current transaction in progress (extended version).

Short Name

TRANABTX()

Type

Low-Level function

Declaration

COUNT AbortXtd(COUNT lokmod)

Description

AbortXtd() is an extended version of Abort that permits control of locks on abort. AbortXtd() accepts mode arguments similar to Commit(). lokmod values are described in the following table.

Mode Description
ctFREE Releases all locks. Identical to Abort. Clears the LockISAM() state.
ctKEEP Does not clear the LockISAM() state and keeps all the locks acquired before and during an active transaction.
ctKEEP_OUT Releases only locks obtained within the transaction and/or locks on records updated within the transaction. Does not clear the LockISAM() state.
ctKEEP_OUT_ALL Unconditionally keep all locks that were acquired before the transaction began. Free locks obtained within the transaction. Does not clear the LockISAM() state.

Return

Value Symbolic Constant Explanation
0 NO_ERROR No error occurred.
71 TNON_ERR There is no active transaction pending.

See FairCom DB Error Codes for a complete listing of valid FairCom DB error values.

See also

Abort, Begin, ClearSavePoint, Commit, LockISAM, RestoreSavePoint, SetSavePoint, TRANRDY