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

PIPE EDIT
argument. Note that FINDLINE 1 is equivalent to TOPLINE. If the number
specified is greater than the number of lines in the current message, a null line
is used for subsequent input orders.
If the number is negative, EDIT counts from the end of the message. For
example, LINE -1 selects the last line of a multiline message and LINE -2
selects the next to last line. LINE 0 (zero) results in a null line.
FINDLINE /string/ (global order)
Advances the current line forward to a line containing the specified target
string, which then becomes the current line. If no line after the current line
contains the target, a null line is used for subsequent input orders.
FWDLINE n (global order)
Moves the current line ahead by the number specified.
LASTLINE (global order)
Cancels all previous READLINE orders and performs a RESET. Input is set to
the last line of the multiline message.
LASTLINE is a complementary function to TOPLINE. Where LASTLINE sets
the input to the last line, TOPLINE sets the input to the first line of the
multiline message.
See also TOPLINE.
LOGTO (global order)
Sets an option such that if the message is presented for display using either the
CONSOLE stage or the ROUTE stage, the message is logged. One of these
arguments is required:
N This action is for the net log.
S This action is for the system log.
H This action is for the hardcopy log.
* This action is for all three log methods: net log, system log, and
hardcopy log.
Usage Notes:
1. If the message is automated, then automation can override the logging
options set by EDIT. If the message is delivered to a distributed autotask,
then the log options are honored on the local domain, but is reset to default
values by RMTCMD message forwarding. Also, if a message is routed
directly to a remote domain, the options are reset to default values.
2. Messages that are exposed for logging are always written to the CanzLog
file. You can control visibility of your messages in the CanzLog file by
using the TAG keyword of the LOGTO stage.
NAMEBIND (global order)
NAMEBIND writes the value of the /name/ and the text previously produced
by other output orders, if any, to a new output line. Both the /name/ and the
output line data are preceded in the output line by a halfword length value.
The message ID (HDRMTYPE) and the line counter meet the name binding
requirements for events sent to the NetView Alert and Message Adapters.
Lines created by NAMEBIND can be transferred to the adapter using the PPI
stage. Examples of NAMEBIND can be found in “Example: Sending an Alert to
the NetView Alert Adapter” on page 120, CNMEALUS, and CNMEMSUS. For
more information about PPI, see “PIPE PPI ” on page 187.
To create a valid adapter name/value pair binding, do one of these items:
v Copy the original contents of the automated alert or message to the output
using a COPY * EDIT order.
Chapter 2. Pipeline Stages and Syntax 95