GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  COSTRANSACTIONS_COORDINATOR (3)

NAME

CosTransactions_Coordinator - This module implements the OMG CosTransactions::Coordinator interface.

CONTENTS

Description
Exports

DESCRIPTION

To get access to the record definitions for the structures use:
-include_lib("cosTransactions/include/CosTransactions.hrl").

EXPORTS

create_subtransaction(Coordinator) -> Control

Types:

Coordinator = #objref
Control = #objref

A new subtransaction is created whose parent is the Coordinator argument.

Raises exception:

* ’SubtransactionsUnavailable’ - if nested transactions are not supported.
* ’Inactive’ - if target transaction has already been prepared.

get_transaction_name(Coordinator) -> Name

Types:

Coordinator = #objref
Name = string() of type "oe_name@machine_type_timestamp"

Returns a printable string, which describe the transaction. The main purpose is to support debugging.

get_parent_status(Coordinator) -> Status

Types:

Coordinator = #objref
Status = atom()

Returns the status of the parent transaction associated with the target object. If the target object is a top-level transaction this operation is equivalent to get_status/1 operation.

Possible Status replies:

* ’StatusCommitted’
* ’StatusCommitting’
* ’StatusMarkedRollback’
* ’StatusRollingBack’
* ’StatusRolledBack’
* ’StatusActive’
* ’StatusPrepared’
* ’StatusUnknown’
* ’StatusNoTransaction’
* ’StatusPreparing’

get_status(Coordinator) -> Status

Types:

Coordinator = #objref
Status = atom()

Returns the status of the transaction associated with the target object.

get_top_level_status(Coordinator) -> Status

Types:

Coordinator = #objref
Status = atom()

Returns the status of the top-level transaction associated with the target object.

hash_top_level_tran(Coordinator) -> Return

Types:

Coordinator = #objref
Return = integer()

Returns a hash code for the top-level transaction associated with the target object. Equals the operation hash_transaction/1 if the target object is a top-level transaction.

hash_transaction(Coordinator) -> Return

Types:

Coordinator = #objref
Return = integer()

Returns a hash code for the transaction associated with the target object.

is_descendant_transaction(Coordinator, OtherCoordinator) -> Return

Types:

Coordinator = #objref
OtherCoordinator = #objref
Return = Boolean

Returns true if the transaction associated with the target object is a descendant of the transaction associated with the parameter object.

is_same_transaction(Coordinator, OtherCoordinator) -> Return

Types:

Coordinator = #objref
OtherCoordinator = #objref
Return = Boolean

Returns true if the transaction associated with the target object is related to the transaction associated with the parameter object.

is_top_level_transaction(Coordinator) -> Return

Types:

Coordinator = #objref
Return = Boolean

Returns true if the transaction associated with the target object is a top-level transaction.

register_resource(Coordinator, Resource) -> RecoveryCoordinator

Types:

Coordinator = #objref
Resource = #objref
RecoveryCoordinator = #objref

This operation registers the parameter Resource object as a participant in the transaction associated with the target object. The RecoveryCoordinator returned by this operation can be used by this Resource during recovery.

Note:
The Resources will be called in FIFO-order when preparing or committing. Hence, be sure to register the Resources in the correct order.

Raises exception:

* ’Inactive’ - if target transaction has already been prepared.

register_subtran_aware(Coordinator, SubtransactionAwareResource) -> Return

Types:

Coordinator = #objref
Return = ok

This operation registers the parameter SubtransactionAwareResource object such that it will be notified when the transaction, associated wit the target object, has committed or rolled back.

Note:
The Resources will be called in FIFO-order. Hence, be sure to register the Resources in the correct order.

rollback_only(Coordinator) -> Return

Types:

Coordinator = #objref
Return = ok

The transaction associated with the target object is modified so the only possible outcome is to rollback the transaction.

Search for    or go to Top of page |  Section 3 |  Main Index


Ericsson AB COSTRANSACTIONS_COORDINATOR (3) cosTransactions 1.3.1

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.