TMF Reference Manual (G06.24+)

TMFCOM Commands
HP NonStop TMF Reference Manual—522418-002
3-99
CLOSE RESOURCEMANAGER
Usage Guidelines
The CLOSE RESOURCEMANAGER command itself does not directly close a
specified recoverable resource manager. However, when this command is executed,
the gateway process that opened the resource manager receives a signal indicating
that the operator requested closure of the resource manager. If the gateway process
tries to use the file number associated with its open instance of the resource manager,
that process encounters Error 66 (FEDEVDOWN). To continue processing
transactions for this resource manager, the gateway process must explicitly close and
then re-open the resource manager. To allow other gateway processes to use this
resource manager, the gateway process must close it.
The CLOSE RESOURCEMANAGER command also forces any active transactions
that have branches with a specified resource manager to abort. If this is a recoverable
resource manager with unresolved transaction branches, the resource manager enters
the crashed (rather than the closed) state.
If the specified resource manager is not currently open, an error message appears.
Examples
The following CLOSE RESOURCEMANAGER command forces closure of a
recoverable resource manager named TUX-A1_UNIX@SUN:
TMF 86> CLOSE RESOURCEMANAGER TUX-A1_UNIX@SUN
The next command forces closure of a recoverable resource manager named TUX-
A2_NT@MICROSOFT:
TMF 87> CLOSE RM TUX-A2_NT@MICROSOFT
Note. Resource managers, to which the CLOSE RESOURCEMANAGER command applies,
support heterogeneous transaction processing. Resource managers are used in products
such as NonStop TUXEDO. Although TMFCOM and the TMFSERVE programmatic interface
provide TMF commands and options for operating on resource managers, system managers
who use them do so in the context of issues involving multiple software subsystems and inter-
platform considerations. Complete discussion of heterogeneous transaction processing and
the context in which resource-manager commands and options 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.