1 10/20/86  sort_list, sls
 2 
 3 
 4 Syntax as a command:  sls path -control_args
 5 
 6 
 7 Function:  sorts the records in the specified lister file.  The records
 8 are sorted according to the fields specified in the -sort control
 9 argument.  Fields are sorted without regard to case; that is, they are
10 sorted in alphabetical order, not in the ASCII order.
11 
12 
13 Arguments:
14 path
15    is the pathname of the lister file to be sorted.  The suffix lister
16    must be the last component of the lister file name; however, if path
17    does not have a suffix of lister, one is assumed.
18 
19 
20 Control arguments:
21 -brief_errors, -bfe
22    suppresses error messages for lister files that have no records.
23 -sort STR, -st STR
24    specifies how the records in the lister file are to be sorted.  This
25    is a required argument.
26 
27 
28 Notes:  The sort_list command sets the "lister" severity indicator.  A
29 severity of 2 is set when the sort is not performed, for some reason
30 other than an empty lister file, or the invocation of sort_list
31 terminates abnormally.  A severity of 1 is set when the lister file has
32 no records.  A severity of 0 is set when the sort is completed and the
33 command terminates normally.