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

PIPE LOCATE
Operand Descriptions
Usage Notes
Examples
156 Programming: Pipes
ALL|FIRST|LAST
This keyword affects processing only for MLWTOs. Specifies whether
comparisons are done on all, the first, or last line of multiline messages. The
default is ALL.
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
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 LOCATE stage replaces the letter with the
length of that delimited string.
/string/
Specifies the character string for which to search. The first nonblank character
encountered after the stage name or position.length is the delimiter which
establishes 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.
v LOCATE cannot be the first stage.
v You can specify the position.length and /string/ pair up to 40 times.
Example: Locating Messages by Content
To issue the NetView command LIST STATUS=TASKS, trap the resulting messages,
keep only the messages containing the phrase NOT ACTIVE in positions 55
through 64, and display them, enter:
PIPE NETVIEW LIST STATUS=TASKS
| LOCATE 55.10 /NOT ACTIVE/
| CONSOLE