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

PIPE EDIT
118 Programming: Pipes
NEXTWORD (output order)
Specifies that the input to NEXTWORD is to be inserted into the output line. If
the output line already contains text, one blank is inserted into the output line
prior to the data.
position (output order)
Specifies that the data be placed in the output line beginning at the character
indicated by position. Ifposition is larger than the current length of the output
line, the existing output line is padded with the character defined by the PAD
global order and the data added after the padding characters. If the output line
created is already longer than position, the existing text beginning at position is
overlaid.
For example consider the following message on the input stream to EDIT:
CAN BE FUN WITH EDIT!
With the following edit script:
/PIPES/ 1
1.* 7
PIPES is written to the output stream beginning at position 1. Then, the entire
input stream is read using 1.* and written to the output stream beginning in
position 7. The resulting output data is:
PIPES CAN BE FUN WITH EDIT!
Consider CAN BE FUN WITH EDIT! as the input stream to the following edit
script:
PAD /*/
1.* 5
In this case the entire input stream is written to the output stream beginning at
position 5. The first four positions are padded with asterisks (*) which was
defined as the pad character. The resulting output data is:
****CAN BE FUN WITH EDIT!
Now consider the following edit script which receives CAN BE FUN WITH EDIT!
on the input stream:
/MANIPULATING MESSAGES IS HARD/ 1
1.* 23
First MANIPULATING MESSAGES IS HARD is written to the output. Then, all the
data received on the input stream is read by the input order 1.* and written to
the output at position 23. Because MANIPULATING MESSAGES IS HARD is longer
than 23 characters, the data read and the resulting output by 1.* 23 overlays
the existing output data resulting in the following text on the output stream:
MANIPULATING MESSAGES CAN BE FUN WITH EDIT!
SETGMT (output order)
SETGMT sets the IFRAUGMT value of the output message. The order is
carried out only if the input available is exactly eight bytes.
UCHARS (output order)
Sets a 16-byte "user char" area. In PIPE EDIT, UCHARS is equivalent to the
previously-existing IFRAUSRC, except that UCHARS accepts a value shorter
than 16 characters (no padding occurs) or truncates a value longer than 16
characters.
UFLAGS (output order)
Sets a 2-byte "user flags" area. In the MRT, this field accepts a string of up to
16 characters consisting of 0s, 1s, and Xs. These correspond to the requirement
to clear, set, or leave as-is the corresponding bit in the byte being referenced. In