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

PIPE SORT
Syntax
SORT:
SORT
PAD '00'X
PAD 'nn'X
A
D
▼ position.length
Command Description
The SORT stage reads messages from the input stream and writes them to the
output stream in a specified order. Only the first line of each message is examined.
To sort lines within a message, the SEPARATE stage must be included prior to
SORT. If messages contain identical sort fields, they retain their input stream order
when passed to the output stream.
Streams
Before any data is written to the output stream, all data is read from the input
stream until the input stream disconnects. This causes the stream to be delayed.
Stream Type Number Supported
Input 1
Output 1
Termination Conditions
SORT terminates when both the input stream and output stream disconnect.
Operand Descriptions
A Specifies that the messages are sorted in ascending order. That is, messages
where the sort fields are lower EBCDIC values are output before those with
higher EBCDIC values.
D Specifies that the messages are sorted in descending order. That is, messages
where the sort fields are higher EBCDIC values are output before those with
lower EBCDIC values.
PAD
Specifies the character, in hex, to be used to pad sort fields when the fields
specified extend beyond the end of the message being sorted. The default is to
pad with the null character (X'00'). The message itself if not modified.
For example, if the following two messages were sorted with SORT PAD ’C1’X A
17.4:
This is message one
This is message number two
The two sort fields are:
oneA
numb
PIPE SORT
Chapter 2. Pipeline Stages and Syntax 213