[Enterprise Extensions only]

CosTransactions in the Transaction Service

The CosTransactions Module is the only module in the Transaction Service.

Files for the CosTransactions module

AIX Solaris Windows NT Visual C++
module file name CosTransactions.idl
Java package file name org.omg.CosTransactions
C++ Header file name CosTransactions.hh
Linker files libsomosa1.a libsomosa1.so somosa1m.lib


Types

Status
This type enumerates the various states through which a transaction goes during its lifetime. A special value is used to indicate that there is no transaction.
  enum Status 
  { 
      StatusActive,
      StatusMarkedRollback,
      StatusPrepared,
      StatusCommitted,
      StatusRolledBack,
      StatusUnknown,
      StatusNoTransaction,
      StatusPreparing,
      StatusCommitting,
      StatusRollingBack 
  };
StatusActive
The transaction has begun, has not yet been committed or rolled back, and has not been marked rollback-only.
StatusMarkedRollBack
The transaction has begun, has not yet been committed or rolled back, and has been marked rollback-only.
StatusPrepared
The transaction is "indoubt". This means the local CosTransactions::Coordinator object is waiting for information from another object to decide the outcome of the transaction. This status can be returned by a coordinator after it has prepared, or inside a Resource object's commit, rollback or commit_one_phase operation.
StatusCommitted
The transaction has been committed. This status is returned by RecoveryCoordinator::replay_completion. Note that it is not returned generally, because the objects associated with a transaction are destroyed immediately after the transaction has committed.
StatusRolledBack
The transaction has been rolled back. This status is returned in a Resource object's rollback operation, or by RecoveryCoordinator::replay_completion.
StatusUnknown
The status of the transaction is not currently known. This occurs in a subordinate server process during recovery, when the superior has not been contacted. This status is returned only by RecoveryCoordinator::replay_completion.
StatusNoTransaction
There is no current transaction. This status is returned only by Current::get_status.
Vote
This type enumerates the votes available to a Resource for the Resource::prepare operation.
enum Vote
{
    VoteCommit,
    VoteRollback,
    VoteReadOnly
};

Exceptions

HeuristicRollback
HeuristicCommit
HeuristicMixed
HeuristicHazard
Inactive
InvalidControl
NotPrepared
NoTransaction
NotSubtransaction
SubtransactionsUnavailable
Unavailable

Interfaces

For information on each of the interfaces within the CosTransactions module, see the related topics.