[Enterprise Extensions only]

Coordinator::get_top_level_status

Overview Returns to a caller the status of the top-level ancestor of the transaction associated with the target object.
Original interface CosTransactions::Coordinator Interface


Intended Usage

If the transaction is a top-level transaction, this operation is equivalent to the Coordinator::get_status Operation. If it is not a top level transaction, this operation gets the status of the top-level ancestor.

IDL Syntax

  Status get_top_level_status();

Input parameters

None.

Return values

Status
The status of the top-level ancestor of the transaction associated with the target object.

Examples

The following examples demonstrate the usage of CosTransactions::Coordinator::get_top_level_status.

C++ Example

  CosTransactions::Coordinator *coord;
  CosTransactions::Status *status;
  status = coord->get_top_level_status();

Java Example

  org.omg.CosTransactions.Coordinator coord;
  org.omg.CosTransactions.Status status;
  status = coord.get_top_level_status();