Call Rtr_Start_Tx - Compaq AA-Q88CE-TE System Manager's Manual

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
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
nodes specified by the latest
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
-----------------------------------------------------------
RTR
DDTM
XA
/NODE[=node-list]
/NODE=default-node-list (D)
Specifies that the command is executed on all nodes specified in
node-list
command was issued.
is not case sensitive.
nor is specified then the command is executed on the
/NODE /CLUSTER
SET ENVIRONMENT
Format of txid-number
7 integers of 4 bytes each, separated by commas
4 integers of 4 bytes each, separated by commas
Character-string up to 128 bytes of length
is omitted then the command is executed only on the node where the

CALL RTR_START_TX

command. If no
SET ENVIRONMENT
node-list
RTR Command Line Interface 6–43
. If