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