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

PIPE JOINCONT
Usage Notes
Examples
148 Programming: Pipes
If multiple search strings are valid matches to the message, the longest
matching string is replaced by the substitution string.
A line is considered a match, if any of the comparison strings are found in the
appropriate leading or trailing position. A null string (//) is always a match.
At least one delimited string must be specified. You can specify /string/ up to
40 times.
The first nonblank character encountered after the keywords is the delimiter
which establishes the boundary of the text string used by the stage. The
delimited string ends when the same character is encountered a second time.
TRAILING
Specifies that if there is a match to the comparison string at the end of the
message, the next message is appended to the message that contained the
match. The default is TRAILING.
v JOINCONT cannot be the first stage.
v JOINCONT is used only with single-line messages. If the function is needed for
multiline messages, use a SEPARATE stage preceding the JOINCONT stage.
v Processing a JOINCONT stage on messages, which are all multiline or a
combination of single line and multiline, yields unpredictable results.
Example: Joining Messages Ending in a '$'
For this example, you have established a file member named MYFILE in which
some of the lines end with the character '$'. The file contains the following 80-byte
records:
YES
PIPE$
LINES $
ARE $
GREAT
Enter this command to eliminate each record's trailing blanks, leave the YES
message, join those that end in '$' into a new message 'PIPELINES ARE GREAT',
and write the results to the console:
PIPE < MYFILE
| STRIP TRAILING / /
| JOINCONT TRAILING /$/
| CONSOLE
Response
YES
PIPELINES ARE GREAT
Example: Joining Messages and Substituting a Character
Suppose you have established a file member named LETTERS in which you have
some random vowels and consonants. The file contains the following 80-byte
records:
A VOWEL
E VOWEL
I VOWEL
O VOWEL
U