home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / fileutil / cusrt2.arj / CUSORT.DOC < prev    next >
Encoding:
Text File  |  1991-09-14  |  7.2 KB  |  185 lines
  1. |    Colorado Utilities Sort (CUSORT v.2.15)
  2. |
  3. |    by
  4. |
  5. |    Fred C. Hill
  6. |
  7. |    Micro System Solutions
  8. |    5048 W. Maplewood Ave.
  9. |    Littleton, CO 80123
  10. |    1-(303) 795-7653
  11. |    1-(800) 421-1789 (orders)
  12. |
  13. Sorting is one of those things every computer user must do at one
  14. time or another, and the sort program provided with most versions
  15. of DOS just doesn't do the job. It's slow; only sorts from column
  16. one; won't sort descending; has a limited capacity; and only uses
  17. regular memory to sort in. Not a very useful program when you have
  18. hundreds of thousands of records you want sorted in position 25 for
  19. 12 characters.
  20.  
  21. CUSort implements what is known as a virtual sort, allowing you to
  22. sort more than will fit in RAM at one time.  It does this by
  23. sorting manageable portions of the input file first, and then
  24. merging these pre-sorted lists to form the final output file.  In
  25. theory, two billion records can be sorted in one run. In actual
  26. practice, the number of records will be limited only by the amount
  27. of available disk or expanded memory (EMS) capacity, and, of
  28. course, the amount of time you're willing to wait.
  29.  
  30. CuSort Revision history
  31.  
  32. version 1.0 - February 1990  Original version
  33.  
  34. version 2.0 - August 1990
  35.           Option D Directory changed to Option R Redirect.
  36.  
  37.           Option D Added to indicate "No duplicates to be written."
  38.  
  39.           Option L added to indicate "Sort by record length."
  40.  
  41.           Bug fixed - if blank record option (/B) not selected the
  42.           program would not produce an output file.
  43.  
  44. version 2.1 - November 1990
  45.           Option E added.  Do not use Expanded memory even if available.
  46.  
  47.           At an abnormal termination CuSort now removes its work files.
  48.  
  49.           Bugs fixed - 
  50.                   Option L flag was never initialized so it could 
  51.                   be invoked at any time by leftover memory contents.
  52.  
  53.                   StdIn was not always used properly.
  54.  
  55. version 2.11 - Changed hard disk usage.
  56.  
  57. version 2.12 - Added minus sign to sort fields for descending order
  58.                by field.
  59.  
  60. version 2.13 - Febrary 1991
  61.                Added C option to input largest record size. This
  62.                option will improve proformance and cut down on
  63.                disk usage.
  64. version 2.14 - June 1991
  65.                Added DO option to place duplicate records in a different
  66.                file rather than deleting them.
  67. version 2.15 - August 1991
  68.                Fixed multiple field sort.  Bug discovered by Guy Mayers.
  69.  
  70. The D & L options were added at the request of Terry Hall of
  71. Illinois.  Thanks for the idea Terry.  This addition allowed me to
  72. find the /B option bug also.
  73.  
  74. The DO option was added at the request of R.L.Boone of
  75. Houston, Texas.  Thanks for the idea Robert.
  76.  
  77. CUSort's operation is determined by the command line parameters you
  78. give it when the program is started.  The command line format is
  79.  
  80.      CuSort [options] <inputFile >outputFile
  81.  
  82.           Options:
  83.  
  84.                /-   Sort in descending order. The default is
  85.                     ascending order.
  86.                /I   Ignore upper/lower case.  All input is compared
  87.                     as if it were upper case.
  88.                /R xx     Redirect temporary sort files to directory
  89.                          xx. (files will be deleted before program
  90.                          terminates.)
  91.                /T   Trim records. This parameter allows you to
  92.                     remove blanks at the beginning and end of the
  93.                     input records. Sequencing is done prior to
  94.                     trimming.
  95.                /B   Do not write blank records. All blank records
  96.                     found during the input phase will be discarded.
  97.                /D   Do not write duplicate records.
  98.                /DO  Place duplicate records in an output file (DUPSORT.DTA).
  99.                /L   Sort by length of record. /S parm is ignored.
  100.                /S c,l    Sort fields ... c = column; l = length. You may
  101.                     have a maximum of 6 /S fields during any single
  102.                     run. They must be placed in priority sort
  103.                     order.
  104.                /E   Do not use Expanded Memory (EMS) even if that memory
  105.                     is available.
  106.  
  107.      When sorting by fields the parameter denoting descending order
  108. (/-), will result in the file being sequenced in descending order
  109. from the major sort field to the minor sort field.
  110.  
  111.      Examples:
  112.  
  113.      CuSort /B /S 1,25 < textin.dat > textout.dat
  114.           This example sorts just like the DOS sort except that the
  115.           sort field size is limited to 25 characters and any blank
  116.           records found during sorting will not be included in the
  117.           output file.
  118.  
  119.      CuSort /- /I < textin.dat > textout.dat
  120.           This example sorts the entire file, including blank
  121.           records in descending sequence. Lower case and Upper case
  122.           are sorted together.
  123.  
  124.      CuSort /- /I /S 10,5 /S 2,6 < textin.dat > textout.dat
  125.           This example sorts on column 10 for 5 characters as the
  126.           major sort field and column 2 for 6 characters as the
  127.           minor sort field. The file is sorted in descending
  128.           sequence and upper and lower case characters are sorted
  129.           together.
  130.  
  131.      CuSort /L /DO <textin >textout
  132.           This example will sort records by length of record and
  133.           will move any duplicate records to the file DUPSORT.DTA.
  134.  
  135.     ORDER FORM
  136.  
  137.      Name: ------------------------------------------------------
  138.  
  139.      Address: ---------------------------------------------------
  140.  
  141.      City: ---------------------------- State: ---- Zip: --------
  142.  
  143.      Phone: (     ) -------------------------------
  144.  
  145.      Credit card:   type -  Visa     Mastercard
  146.  
  147.      Card number: ------------------------------ expires ---/---
  148.      
  149.      Name on card: ---------------------------------------------
  150.  
  151. ----------------------------------------------------------------
  152.      CuSort latest version . . . . . . . . . . . . . . . $ 12.00
  153.           Includes the following..
  154.                Current disk direct from author
  155.                Laser printed documentation
  156.                Shipping and handling
  157.                Telephone support
  158.                Notification of further upgrades and
  159.                     products.
  160.  
  161.      Colorado residents include 3% state tax and 
  162.           appropriate local tax. . . . . . . . . . . . . .$ -----
  163.  
  164.      Shipping and Handling . . . . . . . . . . . . . . . .$  5.00
  165.  
  166.                          Total included  . . . . . . . . .$ -----
  167.  
  168.  
  169. ----------------------------------------------------------------
  170. Order in one of three ways... Fill out this form and mail to: 
  171.      Micro System Solutions
  172.      5048 W. Maplewood Ave.
  173.      Littleton, CO 80123
  174. - or -
  175.      Call 1-(800) 421-1789 or 1-(303) 795-7653 (credit card orders)
  176. - or-
  177.      Leave a Compuserve CMail (Compuserve Mail) message for
  178.      Micro System Solutions (Fred C. Hill PPN 76060,102) with all
  179.      of the information above. (credit card orders or information
  180.      only please, DO NOT leave messages with credit card numbers
  181.      in the forum areas)
  182. ----------------------------------------------------------------
  183.  
  184.      
  185.