Compaq AA-Q88CE-TE - Manual (Page 118)

CALL RTR_START_TX
CALL RTR_START_TX
The CALL RTR_START_TX command causes a command server to execute the
rtr_start_tx( ) routine and to display the returned status.
Format
CALL RTR_START_TX
Command Qualifiers Defaults
/CHANNEL_NAME=channel-name /CHANNEL_NAME=RTR$DEFAULT_CHANNEL
/CLUSTER /NOCLUSTER
/JOIN_TXID=txid-number /NOJOIN_TXID
/NODE[=node-list] /NODE=default-node-list
/OUTPUT[=file-spec] /OUTPUT=stdout
/TIMEOUT_MS=timoutms /TIMEOUT_MS=0
/TXID_TYPE=txid-type /TXID_TYPE=RTR
Description
The CALL RTR_START_TX command causes a command server to call the
rtr_start_tx( ) routine using values supplied on the command line.
The numeric status returned from the call is then converted to its textual
representation and displayed.
The rtr_start_tx( ) routine itself is described in Application Programmer’s
Reference Manual.
The prototype of rtr_start_tx( ) is:
rtr_status_t rtr_start_tx (
rtr_channel_t channel,
rtr_sta_flag_t flags,
rtr_timout_t timoutms,
rtr_channel_t joinchan
) ;
Table 6–16 shows the correspondence between values you supply on the command
line and the C language parameter values produced and used for the call.
Table 6–16 Parameters for rtr_start_tx
C Parameter Name C Parameter Value Command Line Specification
channel /CHANNEL_NAME=name
flags RTR_NO_FLAGS [none] [D]
timoutms /TIMEOUT_MS=timoutms
joinchan /JOIN_CHANNEL=channel-name
Nested Transaction Usage
If the FOREIGN_TM qualifier is specified for channel, then the global
coordinating TM for this transaction is a foreign TM. In this case,
rtr_start_tx( ) must be called to start a transaction (cannot be started
implicitly on first call to rtr_send_to_server( ) and the join_txid
parameter must be specified. The txid_type parameter defaults to RTR if
not specified. (This restriction, that classic transactions without a prepare
6–42 RTR Command Line Interface