|
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.
Syntax
int 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.
top
Options
CONCURRENT --
DELAYED -- 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.
top
Example
top
|
