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

Examples
BEFORE
The line is split just before the specified string or character. Nothing is deleted
from the output. The point at which the split occurs can be adjusted using
charcnt.
See also the AFTER keyword.
charcnt
Indicates an offset to the split point. For example, if /string/ is specified, the
value of /string/ is found first, then the split is made charcnt characters before
or after that point. The value of charcnt must be a positive number, negative
number, or zero (0). The default value is zero (0).
Valid values for charcnt are in the range of −10,000,000 - +10,000,000.
See also the BEFORE and AFTER keywords.
STRING
Indicates that the /string/ is a single string. A match occurs only when the
complete string is found.
See also the ANYOF keyword.
/string/
A delimited character string containing a character list or string. SPLIT
searches for /string/ as indicated by the ANYOF or STRING keyword and split
the input line at each occurrence. The default value for /string/ is a single
blank.
Note: One or more characters must be enclosed within the delimiters. /String/
cannot be a null string (//).
Example: Splitting at Blanks
The following splits the literal string /HERE IS SOMETHING TO SPLIT/ at each
blank:
PIPE LITERAL /HERE IS SOMETHING TO SPLIT./
| SPLIT
| CONSOLE
The output displayed on the console is:
HERE
IS
SOMETHING
TO
SPLIT.
Example: Splitting Following a String
The following splits the literal string /BUY IT, YOU'LL SPLIT AND LIKE IT
BETTER./ three characters after each occurrence of the string /IT/:
PIPE LITERAL /BUY IT, YOU’LL SPLIT AND LIKE IT BETTER./
| SPLIT 3 AFTER STRING /IT/
| CONSOLE
The output displayed on the console is:
BUY IT, Y
OU’LL SPLIT AN
D LIKE IT BE
TTER.
PIPE SPLIT
Chapter 2. Pipeline Stages and Syntax 217