TMF Reference Manual (G06.24+)

TMFCOM Commands
HP NonStop TMF Reference Manual—522418-002
3-37
ADD RESOURCEMANAGER
TMF State Requirement
Before you can enter the ADD RESOURCEMANAGER command, TMF must be
started.
Usage Guidelines
In heterogeneous transaction processing, TMF can start a transaction and then
subcontract portions (branches) of the transaction to one or more foreign transaction
management systems operating on platforms other than the NonStop system.
Alternatively, a foreign transaction management system can begin a transaction and
then subcontract parts to TMF. After completing the transaction, TMF and the foreign
transaction manager participate in an agreement protocol to determine the outcome of
the transaction. This cooperation between different transaction management systems
running on different platforms relies on collections of routines called resource
managers.
Resource managers encode the transactional semantics of foreign transaction
management systems, or provide abstractions of foreign database management
systems on the NonStop server platform. They run in a process environment called a
gateway process. A gateway process executes a resource manager routine to export
a transaction branch from TMF to a foreign transaction management system, import a
transaction branch from a foreign transaction management system to TMF, and
participate in the agreement protocol between the two transaction management
systems.
A resource manager that does not need to be recovered after a failure is called a
volatile resource manager. A volatile resource manager manages volatile elements:
objects in main memory, user processes maintaining transactional variables, servers
maintaining context during transaction execution, and so forth.
A resource manager that requires recovery after a failure is called a recoverable
resource manager. A recoverable resource manager, unlike a volatile resource
manager, must be registered with TMF in the resource manager directory before it can
Note. Heterogeneous transaction processing, and the resource managers that support this
processing, are used in products such as NonStop TUXEDO. Although TMFCOM and the
TMFSERVE programmatic interface provide TMF commands for operating on resource
managers, system managers issuing these commands do so in the context of
issues involving multiple software subsystems and inter-platform considerations. Thus,
although this manual describes resource-manager commands and touches briefly on related
terminology in the following paragraphs, complete discussion of the context in which these
commands are used lies beyond the scope of the TMF manual library.
For more information about heterogeneous transaction processing, see the Open Group
TRANSACTION PROCESSING Publications, available from X/Open Publications at the
following Web location:
http://www.opengroup.org/pubs/catalog/tp.htm
These publications can also be ordered through many bookstores.