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