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

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