CoreandServices.book - Ocean - Schlumberger

Data Management
The Abandon method will abort the operations performed in the transaction. This does
not necessarily mean that the operations will be rolled back or undone in the database.
Depending on the product family implementation, it is possible that an implementation
with an underlying database might perform rollback. In Petrel the underlying operation will
not be rolled back.
The Abandon method has two forms. The first has no arguments and may throw a
NotSupportedException. The second has an output parameter that is the collection
of exceptions that may be thrown by delegates. The second case should be used if access
to the exceptions is needed.
The TryLock and TryLockCollection methods will attempt to lock a set of objects
and will return true if all of the objects have been locked. On return from these methods,
all or none of the objects will be locked. The set of objects for TryLock is in the form of
an array. For TryLockCollection the set is an IEnumerable collection.
Events will be generated for the change to the borehole and the creation of the well log
when the transaction in the example is committed or abandoned. In either case, events
are raised during the operation and after it has completed. These events will instantiate a
new TransactionEventArgs object that will contain an ITransaction reference.
The events are:
• TransactionCommitting – raised when a transaction commit is being performed.
• TransactionCommitted – raised when a transaction commit has completed.
• TransactionAbandoning – raised when a transaction abandon is being performed.
• TransactionAbandoned – raised when a transaction abandon has completed.
Another event, ObjectLocked, will be raised when the transaction locks an object. This
event will instantiate a TransactionObjectEventArgs object. This object contains a
Data property with a collection of references to the objects that have been locked in
addition to the ITransaction reference contained in the other events.s a Data
property with a collection of references to the objects that have been locked in addition to
the ITransaction reference contained in the other events.
ITransactionManager Interface
DataManager provides the property TransactionManager to access the
ITransactionManager interface. The product family will provide the
ITransactionManager implementation of the system. The ITransactionManager
interface can be used to find the current transaction for a given context, find the
Schlumberger Private
Ocean Core 3-63