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

PIPE NLOCATE
message is searched. If you do not specify a position.length, the entire message
is searched. You can specify the letter S for the length if the specification is
followed by a delimited string. The NLOCATE stage replaces the letter with
the length of that delimited string.
/string/
Specifies the string for which to search. The first nonblank character
encountered after the stage name or position.length is the delimiter establishing
the boundary of the text string used by the stage. The delimited string ends
when the same character is encountered a second time.
BLANK
Specifies that the character string for which to search contains only blanks. The
search occurs in the range specified by the position.length parameter, but if the
data contains only blanks, a match is recognized regardless of the length
specified.
NULL
Specifies that the stage is to search for no data whatsoever, that is, null data
(not even blanks). This means that a match is recognized only when the data is
shorter than the number specified for position in the position.length parameter.
Usage Notes
v NLOCATE cannot be the first stage.
v You can specify the position.length and /string/ pair up to 40 times.
Examples
172 Programming: Pipes
Example: Discarding Messages by Content
To issue the NetView command LIST STATUS=TASKS, trap the resulting messages,
discard messages containing the phrase NOT ACTIVE in positions 55 through 64,
and display the remaining messages, enter:
PIPE NETVIEW LIST STATUS=TASKS
| NLOCATE 55.10 /NOT ACTIVE/
| CONSOLE