CALL RTR_GET_TID

CALL RTR_GET_TID

The CALL RTR_GET_TID command causes a command server to execute the rtr_get_tid( ) routine and to display the returned status.

Format

CALL RTR_GET_TID

Command QualifiersDefaults

/CHANNEL_NAME=channel-name /CHANNEL_NAME=RTR$DEFAULT_CHANNEL

/CLUSTER/NOCLUSTER

/NODE[=node-list]/NODE=default-node-list

/OUTPUT[=file-spec]/OUTPUT=stdout

Description

The CALL RTR_GET_TID command causes a command server to call to the rtr_get_tid( ) routine using values supplied on the command line.

The transaction id returned from the call is converted to its textual representation and displayed.

The rtr_get_tid( ) routine itself is described in Application Programmer's Reference Manual.

The prototype of rtr_get_tid( ) is:

rtr_status_t

rtr_get_tid (

 

 

rtr_channel_t

channel,

 

rtr_tid_flag_t

flags,

void*

ptid

 

 

) ;

 

Table 6–6 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–6 Parameters for rtr_get_tid

C Parameter Name

Parameter Value

Command Line Specification

 

 

 

channel

 

/CHANNEL_NAME=name

flags

RTR_NO_FLAGS

[none] [D]

 

 

 

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.

The default channel name is RTR$DEFAULT_CHANNEL.

/CLUSTER /NOCLUSTER (D)

Specifies that the command is executed on all the nodes in the cluster.

RTR Command Line Interface 6–13

Page 89
Image 89
Compaq AA-Q88CE-TE manual Call Rtrgettid, Parameters for rtrgettid