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

KEEPLAST
Specifies that the last message in a sequence of duplicated messages is written
to the output stream.
PAD
Specifies the padding character to be used when comparing fields extending
beyond the end of the data in the examined message.
PAD must be followed by a single delimited character or a single hex
character.
The default PAD value is hex zero ('00'X).
position.length
The starting position and number of characters to be compared.
Position indicates the starting character within the line. Position can be any
positive number.
Length is an unsigned positive number indicating the number of characters
from position to be compared. An asterisk (*) can be specified for length
indicating that all characters after position are to be used. Position without
length and the period (.) separator cause length to default to 1.
If length is larger than the available characters, all available characters are used
and the compared field is padded with the value specified by PAD.
The default is to compare the entire message line (1.*).
Up to eight position.length pairs can be specified.
Usage Notes
DELDUPES delays the stream. Each message for the primary output stream is held
by DELDUPES until a nonmatching message is found. When ALL or KEEPLAST is
specified, each message for the secondary stream is delayed until another matching
message is received. When KEEPFIRST is specified, messages for the secondary
stream are not delayed.
Examples
Example: Display Last Logtime
This displays a report of last time each person was logged:
PIPE < LOGTIMES
| SORT 1.18
| DELDUPES KEEPLAST 1.18
| CONSOLE
If LOGTIMES contains:
DOE, JOHN 11/02/18 13:25:04
SMITH, FRED 11/02/18 13:29:21
COLLINS, MARY 11/02/23 17:01:55
DOE, JOHN 11/02/23 09:00:00
HOWE, TOM 11/02/23 04:14:20
JONES, FRED 11/02/23 11:16:44
COLLINS, MARY 11/03/01 10:15:40
Then, the output to the console shows the latest entry for each person:
PIPE DELDUPES
Chapter 2. Pipeline Stages and Syntax 69