Compaq AA-Q88CE-TE manual 26RTR Command Line Interface

CALL RTR_RECEIVE_MESSAGE

For all messages received, RTR displays the contents of the message status block (msgsb) as follows:

the message type (for example, rtr_mt_opened, rtr_mt_msgn). the message length in bytes

the transaction ID, user handle, are event number are shown if they are relevant for the message type.

For message types that place a status code and reason code in the user buffer, the status code is converted to text and both are shown.

For all other message types, the contents of the user buffer are displayed hexadecimal and ASCII text.

Qualifiers

/CHANNEL_NAME=channel_name

/CHANNEL_NAME=RTR$DEFAULT_CHANNEL

Specifies one or more channels from which a message may be received. To specify two or more channels, enter a comma-separated list, e.g. /CHANNEL_NAME=(CHAN1,CHAN2,CHAN5). Channel names may include wildcard characters.

channel_name is not case sensitive.

Entering the qualifier without a value (that is, /CHANNEL) is equivalent to /CHANNEL=RTR$DEFAULT_CHANNEL. Omitting the qualifier altogether is equivalent to /CHANNEL=* (that is, receive a message on any defined channel).

The command server uses a combination of the channel-nameand the window from which the call was issued to uniquely identify which channel to use.

Note that this qualifier sets up the prcvchan parameter on the call to rtr_receive_message.

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

/NODE[=node-list] /NODE=default-node-list (D)

Specifies that the command is executed on all nodes specified in node-list. If node-listis omitted then the command is executed only on the node where the command was issued.

/OUTPUT[=file-spec] /OUTPUT=stdout (D)

Specifies that the resulting information is written to the file file-spec. If /OUTPUT or file-specis omitted then the standard or default output is used.

6–26RTR Command Line Interface