IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice

PIPE ROUTE
PIPE ROUTE
Syntax
ROUTE:
ROUTE
label:
AUTHRCVR
BULLETIN
Command Description
The ROUTE stage sends messages to another task. The target task is identified by a
standard NetView label or by the authorized receiver (AUTHRCVR), as specified
by the previous ASSIGN command.
Streams
204 Programming: Pipes
If you use the label syntax, the target task can be local (in the same NetView
program) or remote (in another NetView program). For a remote target, the
message is routed similarly to a RMTCMD response by SNA or by TCP/IP,
depending on the domain name. For more information on the domain name
specification, see the RMTSYN statement in the CNMSTYLE member.
If an argument is not specified, ROUTE reads target specifications from the
secondary input. One message is read from the secondary input for each message
routed. If the message read from the secondary has multiple lines, a single
message from the primary stream is routed to each target specified.
The message is also written to an output stream under the following conditions:
v If the routing is successful, the message is written to the primary output stream,
if connected.
v If the routing is not successful, the message is written to the secondary output, if
defined and connected. If no secondary output was defined, the message is
written to the primary output, if connected.
Note: When multiple targets are specified, the operation is regarded as successful
if any one of the message routings is successful. For a remote target, the
routing is successful if SNA or IP routing methods accept the message for
routing. A subsequent failure (for example the domain is inactive or security
prevents the session from being established), is reported by messages to the
authorized receiver.
Stream Type Number Supported
Input 2
Output 2
Termination Conditions
ROUTE terminates when the primary input stream disconnects.