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

Usage Notes
The default stage separator character is X'4F'. On American and English 3270
displays, X'4F' is represented as a vertical bar (|). In other countries or on
some workstations, X'4F' can be displayed as an exclamation mark or a split
vertical bar.
v For the PIPE command and its stages, a delimiter can be any character except
alphanumeric characters, parentheses, blanks, nulls, and national characters (@,
#, and $). The maximum length for a delimited string is 255 characters. Multiple
delimited strings must be separated by blanks. In the formats shown, the
delimiter is a /.
Ensure that delimited strings do not contain:
– The delimiter character in use
– The stage separator (unless escaped)
– The escape character (unless escaped)
– The end character (unless escaped)
v The presence of the escape character has no effect on characters that have special
meaning to individual stages. For example, do not use the escape character
within a delimited string in an attempt to include the delimiter character in the
string.
v If running DBCS, be careful of what STAGESEP character is used. The NetView
program determines the hexadecimal equivalent of the STAGESEP character and
then scans the string until it finds it again. The scan does not determine if the
string is part of a DBCS character. The next occurrence of the string ends the
stage command. See “PIPE VAR and PIPE $VAR ” on page 251 for more
information.
v See the individual stages for other usage notes that apply.
Return Codes
Pipeline Stages and Syntax
Return Code Meaning
0 The pipeline ran successfully.
8 An option field error occurred.
12 A PIPE syntax error occurred, or a stage separator character was
used improperly.
16 A stage specification error occurred.
20 A storage failure occurred during PIPE interpretation.
24 The pipeline is clogged. A deadlock occurred during pipeline
processing.
For information on debugging clogged pipeline conditions see
Chapter 8, “Debugging NetView Pipelines,” on page 345.
-1 An unrecoverable error occurred during processing, it was possibly
a looping condition.
-5 A RESET condition occurred.
Chapter 2. Pipeline Stages and Syntax 23