home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / sort32b / sort32.doc next >
Text File  |  1994-01-05  |  6KB  |  147 lines
  1. 
  2.                                                                         
  3.                  SORT32 ver 2.01b 32bit sort for OS/2 2.1               
  4.                                                                         
  5.                  COPYRIGHT (C) 1993  Larry Griffiths                    
  6.                                                                         
  7.                                                                         
  8. 
  9.  
  10. SORT32 is a 32 bit OS/2 2.1 sort program.
  11. This version can sort up to 999,999 records.
  12. This version limits the record length to 256 characters.
  13.  
  14. The command format is as follows:
  15.  
  16. SORT32 Infilename Outfilename [Sort fields] [Options]
  17.  
  18.    Infilename:  Name of the input file.
  19.                 Each record (or line) in the file must be terminated
  20.                 with carriage-return/linefeed. (This is normal for most
  21.                 text files.)  Any other types of files will produce
  22.                 unpredictable results.
  23.  
  24.    Outfilename: Name of the output file.
  25.  
  26.    Sort fields: Up to 16 sort fields may be specified.
  27.  
  28.                     Each sort field contains the starting position,
  29.                     the length, and the sequence of the sortfield.
  30.  
  31.        EXAMPLES:  "SORT32 in out"
  32.  
  33.                   (This will default to column 1,
  34.                   length of 1, ascending sequence)
  35.  
  36.                   "SORT32 in out 3,3,d"
  37.  
  38.                   (Sort starting in column 3, for a length of 3,
  39.                    in descending sequence)
  40.  
  41.                   "SORT32 in out 5,2,a 2,3,d"
  42.  
  43.                   (Sort starting in column 5, for a length of 2,
  44.                    in ascending sequence.  If this field is the same
  45.                    in both records being compared, then
  46.                    sort starting in column 2, for a length of 3,
  47.                    in descending sequence)
  48.  
  49.                   "SORT32 in out 5,2 2,d"
  50.  
  51.                   (Sort starting in column 5, for a length of 2,
  52.                    in ascending sequence.  If this field is the same
  53.                    in both records being compared, then
  54.                    sort starting in column 2, for a length of 1,
  55.                    in descending sequence)
  56.  
  57.                   NOTE:  The length defaults to 1 if
  58.                          it is not entered.
  59.  
  60.                          The sequence defaults to ascending if
  61.                          it is not entered.
  62.  
  63.    Options:     The options must start with the '-' (Dash or Minus)
  64.                 character.
  65.                 This version contains the options 'd' and 's'.
  66.  
  67.        EXAMPLES:  "SORT32 in out -d"
  68.  
  69.                   (Sort starting in column 1, for a length of 1,
  70.                    in ascending sequence.  Drop records that
  71.                    have the same value in column 1.
  72.  
  73.                   "SORT32 in out 10,2 -s"
  74.  
  75.                   (Sort starting in column 10, for a length of 2,
  76.                    in ascending sequence.  If any of the records
  77.                    are shorter than the starting column plus
  78.                    the sort field length, then drop the short
  79.                    record.  Any records shorter than 12 characters
  80.                    would be dropped in this case.)
  81.  
  82.                   NOTE: Any records that are shorter than the
  83.                         highest sortfield column plus the
  84.                         highest sortfield length will not be sorted
  85.                         but will be output if the 's' option is absent.
  86.  
  87.                   "SORT32 in out 10,2 14,5"
  88.  
  89.                   (Any lines that are shorter than 18 will not
  90.                    be sorted, but will appear in the output.
  91.                    The highest sortfield '14,5' specifies columns
  92.                    14,15,16,17, and 18.
  93.  
  94. 
  95.                                                                         
  96.                        F I X   H I S T O R Y                            
  97.                                                                         
  98. 
  99.  
  100. 01/05/94 - Fixed protection exception that occurred when sorting
  101.            one record.
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110. 
  111.                                                                         
  112.                        P E R F O R M A N C E                            
  113.                                                                         
  114. 
  115.  
  116. This is a virtual sort.  All of the records are sorted in the OS/2
  117. virtual address space.  Sorting files that are larger than the
  118. amount of free real memory on your system may cause excessive swapping.
  119. Try a seperate disk partition decicated to the swap dataset if
  120. your system locks up while swapping.  Excessive swapping will
  121. cause sort times to increase dramatically.
  122.  
  123.  
  124. 
  125.                         D I S C L A I M E R                             
  126. 
  127. THIS PROGRAM IS FREEWARE AND AS SUCH YOU ARE PERMITTED TO
  128. DISTRIBUTE IT WITHOUT CHARGE PROVIDED THAT ALL FILES ARE UNMODIFIED
  129. AND DISTRIBUTED TOGETHER.  DUE COPYRIGHT MUST BE OBSERVED.  THIS
  130. PROGRAM IS PROVIDED "AS IS" WITHOUT ANY WARRANTY OF ANY KIND,
  131. EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  132. WARRANTIES OF MERCHANTABLILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  133.  
  134. IN NO EVENT SHALL I BE LIABLE FOR ANY DAMAGES, EITHER DIRECT OR
  135. CONSEQUENTIAL, CAUSED BY THE USE, OR INABLILITY TO USE, THIS PROGRAM,
  136. EVEN IF I HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  137.  
  138. ALL TRADEMARKS AND SERVICE MARKS ARE THE PROPERTY
  139. OF THEIR RESPECTIVE OWNERS.
  140. 
  141. Any comments or suggestions may be sent in written form to:
  142.  
  143.             Larry Griffiths
  144.             P.O. BOX 691
  145.             Abilene Kansas, 67410
  146.  
  147.