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

Usage Notes
Examples
is searched. You can specify the letter S for the length if the specification is
followed by a delimited string. The TOSTRING stage replaces the letter with
the length of that delimited string.
/string/
Specifies a string for which to search. A message is considered a match if any
of the specified strings are found within it. 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 TOSTRING cannot be the first stage.
v If the delimited string is longer than the length specified on the TOSTRING
stage, no matches occur and all messages are discarded from the pipeline.
v TOSTRING is a terminating stage, meaning that when a match is found,
processing for this stage ends along with any outstanding CORRWAIT.
v You can specify the position.length and /string/ pair up to 40 times.
Example: Using TOSTRING to End a Wait
Because VTAM commands do not return an end of response indication, the text of
the response must be examined instead. In this REXX example, TOSTRING
terminates after it has processed the message containing the string /IST314I/. This
termination disconnects the output stream of CORRWAIT and causes the wait to
end.
’PIPE (NAME ENDSOON)’,
’| VTAM D NET,LINES’, /* Issue VTAM display command */
’| CORRWAIT 50’, /* Wait up to 50 seconds for response*/
’| TOSTRING /IST314I/’ /* Last line expected: IST314I END */
’| SEPARATE’, /* (for example) */
’ ... ’, /* processing as required. */
PIPE TOSTRING
The following stage, in this case SEPARATE, does not have a disconnected input
stream until after it consumes the last message. The remainder of the pipeline can
process the message containing /IST314I/ before it ends.
Chapter 2. Pipeline Stages and Syntax 237