Provides access to the current transaction object. This object allows you to query status of and control the current transaction context.

Syntax

transaction-handle [ :attribute | :method ]
transaction-handle
A handle variable whose value you return from the TRANSACTION attribute on a procedure object handle.
attribute
An attribute of the transaction handle.
method
A method of the transaction handle.

Attributes

DEFAULT-COMMIT attribute HANDLE attribute INSTANTIATING-PROCEDURE attribute
IS-OPEN attribute TRANS-INIT-PROCEDURE attribute TYPE attribute

Methods

SET-COMMIT( ) method SET-ROLLBACK( ) method

Notes

  • In an application server session, if a transaction initiating procedure is active, this handle allows you to control the (automatic) transaction using all of the supported attributes and methods. For more information on automatic transactions, see the TRANSACTION-MODE AUTOMATIC statement reference entry.
  • In an ABL client session or in an application server session with no active transaction initiating procedure, only the IS-OPEN attribute is available.
  • If a transaction initiating procedure is deleted, any open transaction is committed or rolled back according to the value of the DEFAULT-COMMIT attribute.
  • The value of this attribute remains the same (references the same transaction context) for the duration of an ABL session. This is true in the following instances:
    • Whether or not a transaction is opened or closed.
    • In an application server session, whether or not a transaction initiating procedure is created or deleted.

See also

TRANSACTION-MODE AUTOMATIC statement