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

TO/NOT
Removes blanks or other specified characters that are not blank (or not
specified). TO and NOT have exactly the same function.
TRAILING
Removes blanks or other specified characters from only the end of the text in
the message lines.
Usage Notes
Examples
v STRIP cannot be the first stage.
v A delimited character set is not recognized as a sequence of characters. Each
character is considered individually. If you specified the delimited set /CAT/
with TRAILING, any message ending with an A, C, T, or any combination of
those characters is considered a match.
Attention: Be cautious when using NOT to strip non-null characters from a
message. If you omit nn to limit the strip action, the entire message might be
stripped.
Example: Stripping Leading Characters
For this example, you have established a file member named AFILE in which
records begin either with the characters 'A' or 'T' as shown:
A
TAME
ARTFUL
AARDVARK
ATE
THE
APPLE
To read the records into a pipeline, strip leading characters 'A', 'T', 'AT', or 'TA',
and write the results to the console, enter:
PIPE < AFILE
| STRIP LEADING /TA/
| CONSOLE
Response
(blank)
ME
RTFUL
RDVARK
E
HE
PPLE
Example: Stripping Sequence Numbers from the End of a
Message
For this example, you have established a file member named THISFILE. The
records are 80 bytes long and end in eight character sequence numbers.
PIPE STRIP
To read the records into a pipeline, strip any character that is not null for eight
characters from the end of the record, write the resulting messages to a stem
variable named 'OUTLINE.', and process in a command list as shown.
Chapter 2. Pipeline Stages and Syntax 231