beautypg.com

Call rtr_send_to_server – Compaq AA-Q88CE-TE User Manual

Page 114

background image

CALL RTR_SEND_TO_SERVER

CALL RTR_SEND_TO_SERVER

The CALL RTR_SEND_TO_SERVER command causes a command server to
execute the

rtr_send_to_server( )

routine and to display the returned status.

Format

CALL RTR_SEND_TO_SERVER [message-field1] [,message-field2...]

Parameters

[message-field] [,message-field2...]

Specify the message to be sent as one or more comma separated parameter
values. You can use the /TYPE_OF_DATA and /LENGTH_OF_DATA positional
qualifiers on each parameter value to specify the data type and length of each
field.

Command Qualifiers

Defaults

/ACCEPT

NOACCEPT

/CHANNEL_NAME=channel-name

/CHANNEL_NAME=RTR$DEFAULT_CHANNEL

/CLUSTER

/NOCLUSTER

/EXPENDABLE

/NOEXPENDABLE

/FORMAT=fmt-string

/NOFORMAT

/LENGTH_OF_FIELD=message-lengthDepends on data type; see description.
/NODE[=node-list]

/NODE=default-node-list

/OUTPUT[=file-spec]

/OUTPUT=stdout

/READONLY

/NOREADONLY

/RETURN_TO_SENDER

/NORETURN_TO_SENDER

/TYPE_OF_DATA=data type

/TYPE_OF_DATA=STRING

Description

The CALL RTR_SEND_TO_SERVER command causes a command server to

call the

rtr_send_to_server( )

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_send_to_server( )

routine itself is described in Application

Programmer’s Reference Manual.

The prototype of

rtr_send_to_server( )

is:

rtr_status_t

rtr_send_to_server (

rtr_channel_t

channel,

rtr_sen_flag_t

flags,

rtr_msgbuf_t

pmsg,

rtr_msglen_t

msglen,

rtr_msgfmt_t

msgfmt

) ;

Table 6–14 shows the correspondence between values you supply on the command
line and the C language parameter values produced and used for the call.

6–38 RTR Command Line Interface