IT_Bus::XATransactionManager Class Reference

#include <it_bus_pdk/xa_transaction_manager.h>

Inheritance diagram for IT_Bus::XATransactionManager:

IT_Bus::TransactionManager IT_Bus::RefCountedBase List of all members.

Detailed Description

Abstract class used to represent a CORBA XA Transaction manager instance.

Definition at line 14 of file xa_transaction_manager.h.

Public Member Functions

virtual xa_switch_t * get_xa_switch ()=0
 Return an XA switch structure that allows Artix to be used as an XA Resource manager and hence be coordinated by an external XA compilant Transaction Manager.
virtual Boolean register_xa_resource (xa_switch_t *xa_switch, String open_string, String close_string, String resource_manager_identifier, Boolean use_dynamic_registration_optimization, Boolean is_single_threaded_resource)=0
 Register an XA Resource Manager with Artix.


Member Function Documentation

virtual xa_switch_t* IT_Bus::XATransactionManager::get_xa_switch (  )  [pure virtual]

Return an XA switch structure that allows Artix to be used as an XA Resource manager and hence be coordinated by an external XA compilant Transaction Manager.

Returns:
xa_switch_t An XA switch that can be enlisted with XA compliant transaction managers.

virtual Boolean IT_Bus::XATransactionManager::register_xa_resource ( xa_switch_t *  xa_switch,
String  open_string,
String  close_string,
String  resource_manager_identifier,
Boolean  use_dynamic_registration_optimization,
Boolean  is_single_threaded_resource 
) [pure virtual]

Register an XA Resource Manager with Artix.

This resource will be associated with any transactions that become active within this Artix Bus instance.

Parameters:
xa_switch_t An XA switch pointer for the resource manager to be enlisted.
String The open string to use when calling xa_open() on the resource manager. Supplying an empty strings causes the open string to be read at runtime from the configuratoin scope identified in the artix_config_scope_name parameter.
String The close string to use when calling xa_close() on the resource manager. Supplying an empty strings causes the open string to be read at runtime from the configuratoin scope identified in the artix_config_scope_name parameter.
String A unique identifier for this resource manager. This identifier is used as a prefix when looking up resource specific configuration information from the artix.cfg file.
Boolean Indicates whether the XA resource supports dynamic registration at runtime.
Boolean Indicates whether the XA resource requires a single threaded access model. Supplying a value if 'true' causes the resource to be managed using the XA::PROCESS thread model and hence treated as a single threaded XA Resource, supplying a value of 'false' causes the resource to be managed using the XA::THREAD threading model and hence treated as a multi-threaded XA Resource.
Returns:
Boolean True if the resource registration was successful.


Generated on Thu Sep 7 11:40:24 2006 for Artix by  doxygen 1.4.7