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

PIPE SORT
Usage Notes
Examples
214 Programming: Pipes
And, the messages are passed to the output stream in the following order:
This is message number two
This is message one
PAD can be in either of the following forms:
'nn'X
X'nn'
Each n is a number 0-9orcharacter A - F.
position.length
The starting position and number of characters defining the sort field.
Position indicates the starting character within the message. By default, position
is counted from the first character of the message.
Position can be any positive number.
Length is an unsigned positive number indicating the number of characters
from position to be included in the sort field. An asterisk (*) can be specified for
length indicating that all characters after position are to be used. Position
without length and the period (.) separator default length to 1.
If length is larger than the available characters, all available characters are used
and the PAD value is used to pad the sort field to the required length.
Consider the following message:
PIPES CAN BE FUN!
This ... Results in ...
7.6 CAN BE
9.20 N BE FUN!
8 A
Up to eight sort fields can be specified. Sorting comparison proceeds from left
to right order with the later fields only being considered if the previous are
equal. Fields can overlap, but doing so causes additional processing time.
v SORT cannot be the first stage.
v CASEI cannot be used with SORT.
v RESET during SORT processing can yield unpredictable results.
v SORT is stable. If identical sort fields are specified, sorted messages are kept in
the same order.
Example: Sorting Messages
This example shows three messages sorted by SORT A 1.3 5.1 10.2:
One message
One more message
Another message
The three sort fields for each of these message are:
Onemge
Onemme
Anohes