Compaq AA-Q88CE-TE manual Call Rtrstarttx, Parameters for rtrstarttx, Nested Transaction Usage

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 QualifiersDefaults

/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–42RTR Command Line Interface