home *** CD-ROM | disk | FTP | other *** search
/ ftp.whtech.com / ftp.whtech.com.tar / ftp.whtech.com / club100 / txt / sort.doc < prev    next >
Text File  |  2006-10-19  |  5KB  |  130 lines
  1.                                         SORT
  2.  
  3.                                          by
  4.  
  5.                               Custom Software (C) 1985
  6.  
  7.  
  8.  
  9.                                 WHERE TO LOCATE SORT
  10.  
  11.  
  12.                Before you can load SORT you must decide where to put it in
  13.           memory. The ideal place to locate SORT is at the highest possible
  14.           address. If you are using any other machine language programs and
  15.           they have the ability to be relocated, we suggest that you locate
  16.           SORT at MAXRAM. If this is the case, go into BASIC and type:
  17.  
  18.                PRINT MAXRAM - 834          and press ENTER.
  19.  
  20.           The value printed on the screen will be the address to give to the
  21.           loader for SORT. If you have the Disk/Video Interface you may use
  22.           this method also.
  23.  
  24.                If you have any other machine language programs in memory
  25.           that cannot be relocated you must locate SORT below them. Using
  26.           the documentation from the other program, determine the starting
  27.           address of that program and subtract 834 from it. This will be
  28.           the address to give the loader for SORT.
  29.  
  30.  
  31.  
  32.                                 LOADING INSTRUCTIONS
  33.  
  34.  
  35.                Decide where in RAM you want SORT to reside by referring to
  36.           the section above. From the main menu on the Model 100, position
  37.           the cursor over BASIC and press ENTER.
  38.  
  39.           Now type:
  40.  
  41.                CLEAR 0,xxxxx               and press ENTER
  42.  
  43.           where xxxxx is the address that you have decided on.
  44.  
  45.           Check that you have SCODE.DO in RAM with no leading or trailing
  46.           characters from downloading. The first line should be: CD224221
  47.           and the last line should end with thirty zeros.
  48.  
  49.           Load and run SLOAD.BA, the screen will show:
  50.  
  51.                Loader/Relocator
  52.                (C) 1985 Custom Software
  53.                All Rights Reserved
  54.  
  55.           and prompt you for the starting address:
  56.  
  57.                Type the address you have decided upon and press ENTER.
  58.           The loader will read the file named SCODE.DO in RAM and begin
  59.           loading it. After the file is loaded you will be given the
  60.           starting and ending addresses.
  61.  
  62.  
  63.  
  64.                                  USING SORT.CO
  65.  
  66.  
  67.           SORT.CO will sort any .DO file in ascending or descending order.
  68.           It will sort any number of records by any of 255 different fields.
  69.           Each field can be up to 255 bytes (characters) long, fields do not
  70.           have to be the same length.  You can use any field delimiter that
  71.           you wish.  When sorting a file it follows some very simple rules:
  72.  
  73.                1) The value of each character is determined by the table on
  74.                pages 211-216 of the Model 100 manual.
  75.  
  76.                2) If two fields are identical throughout the length of the
  77.                shorter field, the longer field is considered larger.
  78.                Therefore, any records where the field to be sorted by is
  79.                empty will be moved to the top of the file.
  80.  
  81.                3) Each record in the file, including the last one, must be
  82.                terminated with a carriage return.
  83.  
  84.  
  85.           Position the cursor over the file named SORT.CO and press ENTER.
  86.           You will be prompted with:
  87.  
  88.                File to sort?
  89.  
  90.           Type in the name of the file you wish to sort and press ENTER.
  91.           The .DO extension IS REQUIRED.  You are then prompted with:
  92.  
  93.                Field delimiter (:)?
  94.  
  95.           Type the character that you have used to separate each field in
  96.           the record.  The default character is a colon and will be used
  97.           if you just press ENTER.  Next you are asked:
  98.  
  99.                (A) or D?
  100.  
  101.           This stands for Ascending or Descending order.  The default
  102.           value is A and will be used if you just press ENTER.
  103.  
  104.           SORT.CO will now start to sort the file.  After it is done,
  105.           you will be returned to the main menu.
  106.  
  107.           NOTE:  At any of the above prompts if you wish to ABORT, simply
  108.           press SHIFT/BREAK and you will be returned to the main menu.
  109.  
  110.  
  111.  
  112.                               SORT.CO ERROR MESSAGES
  113.  
  114.  
  115.           No CR at EOF
  116.  
  117.                Each record in the file must end with a carriage return.
  118.                This error indicates that the last record in the file does
  119.                not have one.  The sort will be aborted with no changes made.
  120.                Add a carriage return to the last record and try again.
  121.  
  122.  
  123.           Not enough memory
  124.  
  125.                The program needs a small amount of free memory to use when
  126.                sorting the records.  This amount is equal to the length of
  127.                the longest record in the file.  The sort will be aborted
  128.                with no changes made.  You must make more room before a sort
  129.                will be successful.
  130.