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

PIPE NETVIEW
Usage Notes
168 Programming: Pipes
If the NETVIEW stage is the first stage, cmdtext is required.
If the NETVIEW stage is not the first stage, cmdtext is optional. The command
is run once for each message delivered by the previous stage. Every time the
command runs, the input message becomes the current message during the
processing.
If cmdtext is specified, the first blank-delimited token is considered to be the
command name. Any additional tokens are passed with the command and
become arguments to it.
If cmdtext is not specified, the NETVIEW stage extracts the first line of a
message as the command and additional lines, if any, as data to be processed
by that command. Any additional messages in the input stream are treated the
same way.
In all cases, the original message becomes the current message while the
command runs and is then discarded.
If the command name is not a valid NetView command or if no command is
found, a return code of 4 is generated and message DSI002I is inserted into the
output stream.
CGI
Use the CGI option for a command that can produce either a 3270 display or
HTML, to inform the command that HTML is preferred. The direct effect of the
CGI option is on the REXX function, CGI(), and causes the function to return a
value of 1. CGI cannot be specified with ECHO.
ECHO
When ECHO is specified, the text of the command is written to the pipeline
before the command is executed. ECHO cannot be specified with CGI.
MOE
Message on error (MOE) examines the return code from the command. If the
return code is not zero, it inserts message DWO369I containing the return code
into the stream after any messages the command might have returned. If you
do not specify MOE (message on error), return codes from commands are
ignored.
NOPANEL
When NOPANEL is specified, the command does not display a full-screen
panel. If it attempts to do so, message BNH113W is inserted into the pipeline
and the command receives an I/O error code from NetView presentation
services.
NOPANEL has restrictions when used with the ATTACH command. See the
IBM Tivoli NetView for z/OS Command Reference Volume 1 (A-N) or the NetView
online help for information about ATTACH.
TAG
The value for TAG is a1-16character string, which is placed in the
IFRAUSRC field of each correlated response. This value overlays any previous
value for the length given. If the value contains any blanks, commas, or equal
signs, you must enclose the value within quotation marks.
v It is important to distinguish between the output of a command and the results
of the command. The NETVIEW stage causes the output of a command to be
trapped within the pipeline, but the results, generally, are not. Output consists of