Filter
Top Products
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-name
and 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-list
is 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-spec
is omitted then the standard or default output is used.
6–26 RTR Command Line Interface