Compaq AA-Q88CE-TE manual JOINTXID=txid-number, Nojointxid, Txidtype, Ddtm

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-listis omitted then the command is executed only on the node where the command was issued.

RTR Command Line Interface 6–43