[Enterprise Extensions only]

Coordinator::is_related_transaction

Overview Determines whether the transaction associated with the target object is related to the transaction associated with the parameter object.
Original interface CosTransactions::Coordinator Interface


Intended Usage

A transaction is related to another transaction if, and only if, they share a common ancestor transaction.

IDL Syntax

  boolean is_related_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 related to the transaction associated with the parameter object.
FALSE
The transaction associated with the target object is not related to the transaction associated with the parameter object.

Examples

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

C++ Example

  CosTransactions::Coordinator *c1, *c2;
  if( c1->is_related_transaction(c2) )
  {
      cout << "c1 is related to c2" << endl;
  }
  else
  {
      cout << "c1 is not related to c2" << endl;
  }

Java Example

  org.omg.CosTransactions.Coordinator c1, c2;
  if( c1.is_related_transaction(c2) )
  {
      System.out.println ("c1 is related to c2");
  }
  else
  {
      System.out.println ("c1 is not related to c2");
  }