Functions

OABEGIN

Marks the beginning of an update transaction for oacommit and oarollback. It is one of four routines that support transaction management from within OmniAccess.

Before you begin an update transaction that uses the OmniAccess index-access routines, call oabegin. oabegin marks the beginning of an indexing transaction.

If the corresponding native transaction is committed, call oacommit to commit all corresponding indexing operations from the most recent oabegin forward.

If the corresponding native transaction fails and is rolled back, oabegin serves as a point of reference for the rollback. If no savepoint was specified in a call to oarollback, the indexing transaction is rolled back to the point where oabegin was called, and you must call oabegin again to log another indexing transaction.

Therefore, depending on the complexity of an indexing transaction, you may want to call oasavepoint after calling oabegin. That way you can roll back all transactions to that savepoint and try the indexing transaction again instead of having to call oabegin to start over.

Transaction management applies to the Omnidex indexes only. If transaction management is required for the database, use the DBMS transaction management system.

See Also: ODXAIM

Syntax

oabegin (instance, options, status)

instance -- identifies a unique connection to a catalog previously established by oaconnect. This is a 32-bit signed integer passed by value.

options -- Options is a character string, passed by reference, that indicates the action or actions for oabegin to take. Terminate the option list with a semicolon or null character. If options contains only a semicolon or null character, oabegin defaults to the DELAYED option.

status -- Indicates the success or failure of the oabegin routine. A zero status.error means a successful call to oabegin. See Status Structure.

Options

CONCURRENT --

DELAYED -- Default. Causes subsequent indexing transactions to be posted only after a call to either oacommit, or oasavepoint with the ROLLFORWARD option.

IMMEDIATE -- causes subsequent indexing transactions to be posted immediately.

FILENAME -- specifies the name of the transaction log file.

Example

Top