public Interface TransactionManager

hold lock until end of transaction.

release lock immediately after getting lock.

Allow lock to be released manually prior to end transaction.

Constant used for the lock_level argument to openConglomerate() and openScan() calls. Pass in MODE_NONE if you want no table or row locks. This is currently only supported from within access.

Add to the list of post commit work.

Add to the list of post commit work that may be processed after this transaction commits. If this transaction aborts, then the post commit work list will be thrown away. No post commit work will be taken out on a rollback to save point.

This routine simply delegates the work to the Rawstore transaction.

Parameters

work:Serviceable

The post commit work to do.

Check to see if a database has been upgraded to the required level in order to use a store feature.

Parameters

requiredMajorVersion:int

required database Engine major version

requiredMinorVersion:int

required database Engine minor version

feature:String

Non-null to throw an exception, null to return the state of the version match.

Returns:boolean

true if the database has been upgraded to the required level, false otherwise.

Exceptions

StandardException:

if the database is not at the require version when feature feature is not null .

The ScanManager.close() method has been called on "scan".

Take whatever cleanup action is appropriate to a closed scan. It is likely this routine will remove references to the scan object that it was maintaining for cleanup purposes.

The ConglomerateController.close() method has been called on "conglom_control".

Take whatever cleanup action is appropriate to a closed conglomerateController. It is likely this routine will remove references to the ConglomerateController object that it was maintaining for cleanup purposes.

The SortController.close() method has been called on "sort_control".

Take whatever cleanup action is appropriate to a closed sortController. It is likely this routine will remove references to the SortController object that it was maintaining for cleanup purposes.

Return existing Conglomerate after doing lookup by ContainerKey

Throws exception if it can't find a matching conglomerate for the ContainerKey.

Parameters

container_key:ContainerKey

container key of target conglomerate.

Returns:Conglomerate

If successful returns

Exceptions

StandardException:

Standard exception policy.

Get an Internal transaction.

Start an internal transaction. An internal transaction is a completely separate transaction from the current user transaction. All work done in the internal transaction must be physical (ie. it can be undone physically by the rawstore at the page level, rather than logically undone like btree insert/delete operations). The rawstore guarantee's that in the case of a system failure all open Internal transactions are first undone in reverse order, and then other transactions are undone in reverse order.

Internal transactions are meant to implement operations which, if interupted before completion will cause logical operations like tree searches to fail. This special undo order insures that the state of the tree is restored to a consistent state before any logical undo operation which may need to search the tree is performed.

Returns:TransactionManager

The new internal transaction.

Exceptions

StandardException:

Standard exception policy.

Get the Transaction from the Transaction manager.

Access methods often need direct access to the "Transaction" - ie. the raw store transaction, so give access to it.

Returns:Transaction

The raw store transaction.

Exceptions

StandardException:

Standard exception policy.