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

Usage Notes
PIPE EDIT, UFLAGS is equivalent to the previously-existing IFRAUSRB, except
that UFLAGS accepts a value shorter than 2 characters (no padding occurs) or
truncates a value longer than 2 characters.
WTOKEY
For the Message Revision Table (MRT), WTOKEY sets the key field associated
with the WTO system macro, which is the WQEKEY in system macro
IHAWQE.
v Code one edit phrase or one global order on each source line because edit
scripts consisting of many edit phrases can be difficult to read. Together with
appropriate commentary, your edit script is easy to understand. See sample
CNME2011 (SESMGET) for an example of this type of coding.
v When converting date and time values using CNVDT or CNVDT0, if the input
data is longer than the specified input format, only a substring of the input data
is compared and converted. The remainder remains as-is in the output.
For example, the following statements convert the first 8 characters, the date
portion, of the Greenwich Mean Time, to the date format specified by the
DEFAULT command:
PIPE ...|EDIT IFRAUGMT ZDT
CNVDT (’MM/DD/YY’ DATE) NEXT|...
The last 9 characters remain in their original input format in the output.
In date conversion, the first, or leading, characters of the input are converted. In
time conversion, the last, or trailing characters of the input are converted. For
example, the following statements convert the time portion of the GMT:
PIPE ...|EDIT IFRAUGMT ZDT CNVDT
(’HH:MM:SS’ TIME) NEXT|...
Examples
Additional examples can be found in CNMS1101.
Example: Selecting a Word
The following edit script selects the fifth word in the input line and places it as the
next entry in the output line:
WORD 5
NEXT
If the input line processed by this script is DSI001I MESSAGE SENT TO NETOP2,
NETOP2 is placed in the output line. If the output line currently contains text,
NETOP2 is added without an intervening blank.
Example: Creating a Command
In this example, the edit phrase changes the results from a LIST STATUS=TASKS
command into commands to start all the reported resources. The LIST
STATUS=TASKS command returns lines of the following format:
TYPE: OST TASKID: RESOURCE: A01A441 STATUS: NOT ACTIVE
Each LIST STATUS=TASKS line is processed by the following edit script:
/START TASK=/ 1
WORD 5
NEXT
PIPE EDIT
Chapter 2. Pipeline Stages and Syntax 119