beautypg.com

Call rtr_send_to_server, Qualifiers – Compaq AA-Q88CE-TE User Manual

Page 115

background image

CALL RTR_SEND_TO_SERVER

Table 6–14 Parameters for rtr_send_to_server

C Parameter Name

C Parameter Value

Command Line Specification

channel

/CHANNEL_NAME=name

flags

RTR_NO_FLAGS

none [D]

RTR_F_SEN_EXPENDABLE

/EXPENDABLE

RTR_F_SEN_READONLY

/READONLY

RTR_F_SEN_RETURN_TO_SENDER

/RETURN_TO_SENDER

pmsg, msglen,
msgfmt

1

[message definition parameter list with
positional qualifiers. ]

1

The actual values used for

pmsg

,

msglen

and

msgfmt

are based upon the message definition you specify as a

command line parameter.

The command server uses message data specified as command line parameter
values to generate a record containing the message data (for the

pmsg

parameter),

the message length (for the

msglen

parameter), and a record type description (for

the

msgfmt

parameter).

Qualifiers

/ACCEPT
/NOACCEPT

The /ACCEPT qualifier sets the flag RTR_F_REP_ACCEPT in the call to

send_to_server( )

. It means the transaction is accepted by this client.

/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.

channel_name

is not case sensitive.

The default channel name is RTR$DEFAULT_CHANNEL.

/CLUSTER
/NOCLUSTER (D)

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

If neither

/NODE

nor

/CLUSTER

is specified then the command is executed on the

nodes specified by the latest

SET ENVIRONMENT

command. If no

SET ENVIRONMENT

command has been entered then the command is executed only on the node where
the command was issued.

Note: In environments that do not support clustering, use of the /CLUSTER
qualifier will cause the relevant command to be executed on the local node only.

/EXPENDABLE
/NOEXPENDABLE

The /EXPENDABLE qualifier sets the flag RTR_F_SEN_EXPENDABLE in the
call

rtr_send_to_server( )

.

/FORMAT[=fmt-string]
/NOFORMAT (D)

Specifies that a format string should be sent with this message.

RTR Command Line Interface 6–39