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

PIPE PIPEND
Syntax
PIPEND:
Synonyms
PIPEND
*
number
Stage Name Synonym
PIPEND PIPEEND
Command Description
The PIPEND stage causes a complex pipeline to end immediately when it receives
the first message on its input data stream. PIPEND can be used to:
Streams
v End a pipeline which is too complex to be terminated by normal end-of-stream
conditions.
v End a pipeline and return a return code to the invoking program.
Stream Type Number Supported
Input 1
Output N/A
Termination Conditions
PIPEND ends when it receives a message or when the input stream disconnects.
Operand Descriptions
PIPE PIPEND
* Indicates that the data up to the first blank in the message is used to determine
the return code for the pipeline. If this data is a number, it is returned as the
return code from the PIPE command. If it is not a number, return code 100 is
returned from the PIPE command.
number
Specifies the return code to be returned from the PIPE command.
Number can be any number up to 2 31 −1.
Usage Notes
Return codes returned by the PIPE command are not to be used because of their
predefined meaning to the NetView program. These return codes are shown in
“PIPE (NCCF) ” on page 20.
Note: For NetView use only: use of these return codes can yield unpredictable
results.
Chapter 2. Pipeline Stages and Syntax 185