[Enterprise Extensions only]

Coordinator::is_descendant_transaction

Overview Determines whether the transaction associated with the target object is a descendant of the transaction associated with the parameter object.
Original interface CosTransactions::Coordinator Interface


Intended Usage

A transaction is an descendant of another transaction if, and only if, the second transaction is an ancestor of the first. For an definition of ancestors of transactions, see the Coordinator::is_ancestor_transaction Operation.

IDL Syntax

  boolean is_descendant_transaction(in Coordinator tc);

Input parameters

tc
A pointer to the Coordinator object for a transaction.

Return values

TRUE
The transaction associated with the target object is a descendant of the transaction associated with the parameter object.
FALSE
The transaction associated with the target object is not a descendant of the transaction associated with the parameter object.

Examples

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

C++ Example

  CosTransactions::Coordinator *c1, *c2;
  if( c1->is_descendant_transaction(c2))
  {
      cout << "c1 is a descendant of c2" << endl;
  }
  else
  {
      cout << "c1 is not a descendant of c2" << endl;
  }
 

Java Example

  org.omg.CosTransactions.Coordinator c1, c2;
  if( c1.is_descendant_transaction(c2))
  {
      System.out.println ("c1 is a descendant of c2");
  }
  else
  {
      System.out.println ("c1 is not a descendant of c2");
  }