[Enterprise Extensions only]

Coordinator::hash_top_level_transaction

Overview Returns a hash value based on the top-level ancestor of the transaction associated with the target object.
Original interface CosTransactions::Coordinator Interface


Intended Usage

Each transaction has a single hash value. Hash values for transactions should be uniformly distributed. This operation is equivalent to the Coordinator::hash_transaction Operation when the transaction associated with the target object is a top-level transaction.

IDL Syntax

  unsigned long hash_top_level_tran();

Input parameters

None.

Return values

unsigned long
A hash value based on the top-level ancestor of the transaction associated with the target object.

Examples

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

C++ Example

  CosTransactions::Coordinator *coord;
  unsigned long hashval;
  hashval = coord->hash_top_level_tran();

Java Example

  org.omg.CosTransactions.Coordinator coord;
  int hashval;
  hashval = coord.hash_top_level_tran();