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

additional lines, if any, as the data to be processed by that command. The
VTAM stage 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, and is then discarded.
Additional messages in the input stream are treated in the same way. If the
command is not a supported VTAM command (DISPLAY, VARY, or MODIFY),
the error message DSI071I INVALID VTAM COMMAND is inserted into the output
stream.
ECHO
When ECHO is specified, the text of the command itself is written to the
pipeline before the command is executed.
MOE
Message on error (MOE) specifies to examine the return code from the
command and, if the return code is not zero, insert message DWO369I
containing the return code into the stream, after any messages the command
might have returned.
For local resources the return codes are those documented for the commands:
DISPLAY, VARY, and MODIFY. If the RMTCMD command on the VTAM stage
is used to access remote resources, the return codes are those documented for
RMTCMD.
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.
Usage Notes
Command authorization checking applies to all commands invoked using the
VTAM stage.
Return Codes
The following return codes are valid only when the MOE operand is used:
PIPE VTAM
Return Code Meaning
-4 Installation exit 03 generated USERDROP.
-500 to -599 Failure attempting to call installation exit 03. Please report specific
return code to the IBM Software Support.
-108 Command is type=I or type=P.
-112 Command search failure, usually because the command is too long.
-116 ACCESS not authorized. Command authorization restrictions
prevent processing.
-120 Command is type=D.
There are other possible return codes indicating storage failure. The code you get
depends upon the processing phase when storage failure was detected. Look for
DSI124I at the system console for this condition.
Chapter 2. Pipeline Stages and Syntax 267