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

PIPE JOINCONT
Syntax
JOINCONT:
JOINCONT
NOT
TRAILING
LEADING
▼ /string/
Command Description
The PIPE JOINCONT stage joins consecutive messages in the stream when a match
to a search string is found. A message is considered in its entirety and it can
include blanks. For instance, an 80-byte record that is read from a file into the
pipeline can contain trailing blanks or sequence numbers, which might cause a
compare of a delimited string to the trailing part of the message to result in no
match. You can use the STRIP stage to remove unwanted blanks or other
characters before you use the JOINCONT stage.
Streams
Stream Type Number Supported
Input 1
Output 1
Termination Conditions
JOINCONT terminates when the input stream or the output stream disconnects.
Operand Descriptions
PIPE JOINCONT
LEADING
Specifies that if there is a match to the comparison string at the beginning of
the message, that message is appended to the previous message.
NOT
Specifies that the absence of the specified strings can cause lines to be joined.
/string/
Specifies the character string as one of the following strings:
v Comparison string
v Substitution string
When one delimited string is specified, it is treated as a comparison string. If a
message contains a match to the string, the string is removed from the message
before it is joined.
When more than one delimited string is specified, the last such string is a
substitution string while all others are comparison strings. When a message
contains a match to a comparison string, in the appropriate leading or trailing
position, the string that matches the search string is removed from the message
and replaced by the substitution string between the messages being joined.
Chapter 2. Pipeline Stages and Syntax 147