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

PIPE LOCATE
Syntax
LOCATE:
Synonyms
LOCATE
ALL
FIRST
LAST
▼ /string/
position.length BLANK
NULL
Stage Name Synonym
LOCATE LOC
Command Description
The LOCATE stage selects messages that match a specified delimited character
string to be passed to the primary output stream. Messages that do not contain the
character string are passed to the secondary output stream, if connected.
Streams
LOCATE examines each input message for a match to the delimited string. A
position and length pair can be supplied to limit the search to a particular column
range.
If the delimited string is longer than the length specified on the LOCATE stage, no
matches occur, and no messages are passed to the primary output stream.
Discarded messages are passed to the secondary output stream, if connected.
If the input message is a multiline message, all message lines are examined for the
string specified. The entire multiline message is selected and passed to the primary
output stream when any line of the message text matches the string specification.
A message is considered a match if any of the specified strings are located within
it.
Stream Type Number Supported
Input 1
Output 2
PIPE LOCATE
Termination Conditions
LOCATE ends when the input stream or both output streams are disconnected.
Chapter 2. Pipeline Stages and Syntax 155