Compaq AA-Q88CE-TE User Manual
Page 119
CALL RTR_START_TX
phase cannot be executed on an client FTM channel, may be relaxed in a
future release.)
When a nested transaction is started (join_txid not equal to NOJOIN_
TXID), then that transaction is given a new RTR TXID (which the
operator can retrieve by calling rtr_get_tid). The foreign TXID passed in
join_txid is used only to identify the transaction for the foreign TM (for
example, when the foreign TM goes through recovery and requests RTR
to return all transactions in prepared state).
The channel on which a nested transaction is started must be opened
as a client channel, which implies the node is defined with the FE
role. However, a journal is required on that node. If there are no other
facilities on that node with the BE role defined, then RTR will behave as
an honorary BE, causing the journal to be opened locally.
Qualifiers
/CHANNEL_NAME=channel_name
/CHANNEL_NAME=RTR$DEFAULT_CHANNEL
Specifies the channel for which the operation is to be performed.
The command server uses a combination of the channel_name and the window
from which the call was issued to uniquely identify which channel to use.
channel_name
is not case sensitive.
The default channel name is RTR$DEFAULT_CHANNEL.
/CLUSTER
/NOCLUSTER (D)
Specifies that the command is executed on all the nodes in the cluster.
If neither
/NODE
nor
/CLUSTER
is specified then the command is executed on the
nodes specified by the latest
SET ENVIRONMENT
command. If no
SET ENVIRONMENT
command has been entered then the command is executed only on the node where
the command was issued.
Note: In environments that do not support clustering, use of the /CLUSTER
qualifier will cause the relevant command to be executed on the local node only.
/JOIN_TXID=txid-number
/NOJOIN_TXID
The format of the txid-number depends on the TXID_TYPE:
TXID_TYPE
Format of txid-number
-----------------------------------------------------------
RTR
7 integers of 4 bytes each, separated by commas
DDTM
4 integers of 4 bytes each, separated by commas
XA
Character-string up to 128 bytes of length
/NODE[=node-list]
/NODE=default-node-list (D)
Specifies that the command is executed on all nodes specified in
node-list
. If
node-list
is omitted then the command is executed only on the node where the
command was issued.
RTR Command Line Interface 6–43