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

PIPE EDIT
100 Programming: Pipes
TOPLINE (global order)
Cancels all previous READLINE orders and performs a RESET. Input is set to
the first line of the multiline message.
TOPLINE is a complementary function to LASTLINE. Where TOPLINE sets the
input to the first line, LASTLINE sets the input to the last line of the multiline
message.
See also LASTLINE.
UPTO (global order)
Sets the logical end of the line for input orders position.length and WORD to be
a point other than the last character in the line.
/string/ Indicates that the input orders consider the line to end at the given
/string/. Previous SKIPTO or UPTO orders are respected. For example,
if the current line is:
PIPES ARE FUN. PIPES USING EDIT ARE EVEN BETTER!
number
And, the edit script is:
UPTO /FUN/
WORD -1
NEXT
The line is processed as follows:
PIPES ARE FUN. PIPES USING EDIT ARE EVEN BETTER!
UPTO /FUN/
WORD -1
UPTO 21
WORD -1
And, the output is:
ARE
Indicates that the input orders consider the line to end at character
number. Number must be an unsigned, positive number. Previous
SKIPTO or UPTO orders are respected. For example, if the current line
is:
PIPES ARE FUN. PIPES USING EDIT ARE EVEN BETTER!
And, the edit script is:
UPTO 21
WORD -1
NEXT
The line is processed as follows:
PIPES ARE FUN. PIPES USING EDIT ARE EVEN BETTER!
And, the output is:
PIPES
If the /string/ is not in the input, or a number is specified which is larger than
the length of the input, all of the input is available to the input orders.