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

PIPE TOSTRING
PIPE TOSTRING
Syntax
Synonyms
TOSTRING:
TOSTRING
ALL
FIRST
LAST
INCL
NOINCL
Stage Name Synonym
TOSTRING TOS
▼ /string/
position.length BLANK
NULL
Command Description
The TOSTRING stage enables you to select messages in the input stream up to,
and including, the message containing the text that matches the delimited string
that you specified. Selected messages are passed to the primary output stream.
Those not selected are passed to the secondary output stream, if connected. You
can specify up to 40 delimited strings, each with an optional position and length
pair, to limit the column range of the search.
Streams
236 Programming: Pipes
Stream Type Number Supported
Input 1
Output 2
Termination Conditions
TOSTRING terminates when the input stream or both output streams disconnect. If
a secondary output stream is not defined, TOSTRING terminates when it matches
its target.
Operand Descriptions
ALL|FIRST|LAST
This keyword affects processing only for MLWTOs. Specifies whether the first,
the last or all lines of multiline messages are compared. The default is ALL.
INCL
Include the matched message in the primary output stream. This is the default.
NOINCL
Do not include the matched message in the primary output stream.
position.length
Specifies the character position in each message where searching begins, and
the length of the search. If you specify a length of *, the remainder of the
message is searched. If you do not specify a position.length, the entire message