IT_Bus::XATransactionManager Class Reference

#include <it_bus_pdk/xa_transaction_manager.h>

Inheritance diagram for IT_Bus::XATransactionManager:

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.

---