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

PIPE NLOCATE
Syntax
NLOCATE:
Synonyms
NLOCATE ▼ /string/
position.length BLANK
NULL
Stage Name Synonym
NLOCATE NLOC
Command Description
The NLOCATE stage discards messages from the primary output stream that
match a specified delimited character string. Messages that do not contain the
character string are passed to the primary output stream. Messages that contain the
character string are passed to the secondary output stream, if connected.
Streams
NLOCATE examines each record for a match to the delimited string. A position
and length can be supplied to limit the search to a particular column range. If the
delimited string is longer than the length specified on the NLOCATE stage,
matches never occur, and all messages are passed to the primary output stream.
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
secondary 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
Termination Conditions
NLOCATE terminates when the input stream or both output streams are
disconnected.
Operand Descriptions
PIPE NLOCATE
position.length
Specifies the character position where searching begins in each message and
the length of the search. If you specify a length of *, the remainder of the
Chapter 2. Pipeline Stages and Syntax 171