beautypg.com

Call rtr_get_tid – Compaq AA-Q88CE-TE User Manual

Page 89

background image

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 Qualifiers

Defaults

/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