home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / p / sap44.lbr / SAP44.DZC / SAP44.DOC
Encoding:
Text File  |  1993-10-25  |  5.3 KB  |  126 lines
  1. SAP v4.3 -- SORT AND PACK CP/M DISK DIRECTORY -- 03/19/85
  2.  
  3.      This CP/M utility reads the disk directory tracks, sorts the
  4. entries alphabetically and then rewrites them them back to the disk. 
  5. All unused or erased areas on the directory tracks are reformatted with
  6. continuous 'E5' characters.  This completely removes previous file names
  7. from the directory which have been deactivated.  Files of zero length
  8. may be deleted with the with the exception of files beginning with "-"
  9. as an assembly-time option.  (This supports labeling disks for the
  10. catalog program MCAT.)  The program works with CP/M 1.4 and CP/M 2.2 but
  11. does not work with CP/M 3.0 or MP/M.
  12.  
  13.      Sorting the directory in this manner offers many advantages.
  14. Some of them are:
  15.  
  16.     1)  Allows 'DIR' to show an alphabetized listing.
  17.     2)  Eliminates potential problems with "UNERASE" programs by
  18.         removing programs with a similar name that have been
  19.         previously deactivated.
  20.     3)  Speeds up access via 'SD' and other special programs.
  21.     4)  Assists on working directly on the disk with 'DU', etc.
  22.     5)  Removes files from the disk directory that somebody else
  23.         could recover.  (The data is still out there somewhere).
  24.  
  25.      TO USE:
  26.  
  27.      A>SAP43 B:     B: in this case indicate the desired
  28.                disk to be sorted and repacked.  If
  29.                not included, the logged on drive
  30.                will be sorted.
  31.  
  32.      TO CONDITION FOR USE:
  33.  
  34.     1)  Edit the source and set the VERBOSE, CPMONLY, ONLY14,
  35.         ONLY22, and DELZRO options at the beginning of the file to
  36.         either YES or NO, depending upon your tastes.  Desiderata is
  37.         as follows:
  38.  
  39.         a)    If VERBOSE is YES, all messages which appear on the
  40.         screen are full-length (as in SAP40).  If VERBOSE is NO,
  41.         all messages are truncated for conservation of memory.
  42.  
  43.         b)    If CPMONLY is YES, no checks will be made to ensure that
  44.         SAP is running on a CP/M 1.4 or 2.2 machine.  Attempting
  45.         to run SAP under MP/M or CP/M+ will probably damage your
  46.         disk directory.  If CPMONLY is NO, checks will be made
  47.         to prevent SAP's execution under MP/M and CP/M+.
  48.  
  49.         c)    If ONLY14 is YES, you are guaranteeing that SAP will be
  50.         executed only in a CP/M 1.4 environment.  If you are not
  51.         sure, or if you are sure that SAP will never be executed
  52.         in a CP/M 1.4 environment, set to NO.
  53.  
  54.         d)    If ONLY22 is YES, you are guaranteeing that SAP will be
  55.         executed only in a CP/M 2.2 environment.  If you are not
  56.         sure, or if you are sure that SAP will never be executed
  57.         in a CP/M 2.2 environment, set to NO.
  58.  
  59.         e)    If both ONLY14 and ONLY22 are set to NO, tests will be
  60.         made (as in SAP40) at run time to determine the environ-
  61.         ment.  Do not set both ONLY14 and ONLY22 to YES.
  62.  
  63.         f)    If DELZRO is YES, any file of zero length not beginning
  64.         with the character "-" will be deleted (as in SAP40). 
  65.         If DELZRO is NO, no file will be deleted solely on the
  66.         basis of its length.
  67.  
  68.     2)  Assemble the source program with ASM, M80, MAC, etc.  Link
  69.         edit, LOAD, or MLOAD as required.  Run as needed.
  70.  
  71. NOTE:  The SAP43.COM file enclosed with the library SAP43.LBR has been
  72. assembled with the following options:
  73.  
  74.     VERBOSE    EQU    NO
  75.     CPMONLY    EQU    YES
  76.     ONLY14    EQU    NO
  77.     ONLY22    EQU    YES
  78.     DELZRO    EQU    NO
  79.  
  80. ========================================================================
  81.  
  82.  07/25/85  Added some pushes and pops so that the switch routine will
  83.   v44       swap the entire contents of the two directory entries.
  84.        Previously it only swapped the part after it found a difference
  85.        which sometimes resulted in flag bits moving from one file
  86.        to another.            - Bob Clyne
  87.  
  88.  03/19/85  Inserted my name where it belonged under the v4.2 release
  89.   v4.3       notice, added conditional assembly option for verbose mode
  90.        which will, if selected, permit the program to assemble in
  91.        under 1k.  Added conditional assembly option for cpmonly mode
  92.        which suppresses check for MP/M and CP/M+.
  93.                     - Dennis Quinn
  94.  
  95.  03/06/85  Removed "trash directory" feature to make program more
  96.   v4.2     user-friendly, made "delete zero-length files" an
  97.            assembly-time option, as there are more programs than
  98.            MCAT which make use of zero-length files.
  99.                     - Dennis Quinn
  100.  
  101.  02/28/85  Minor cleanup, made compatible with all assemblers.
  102.    v41                     - Irv Hoff
  103.  
  104.  09/17/84  Added 'Previously sorted' statement that was included in v37
  105.    v40       but got dropped from v38 when the Shell-Metnzer sort was put
  106.        in.  It still rewrites the directory even if previously
  107.        sorted, to insure erased programs at end of directory are
  108.        properly cleared.        - Irv Hoff
  109.  
  110.  07/27/84  Corrected sorting of last directory entry.
  111.    v39
  112.  
  113.  10/16/83  Now using a Shell-Metzner sort which speeds the sorting time
  114.    v38     considerably, especially on large directories. (SFK)
  115.  
  116.  07/27/83  Shows an error flag for MP/M and CP/M+ both.  Rewrites the
  117.    v37       directory even if previously sorted, to insure erased pro-
  118.        grams at end of directory are properly cleared.
  119.                     - Irv Hoff
  120.  
  121.  1977    Written by L. E. Hughes.  Modified extensively since by Bruce
  122.     Ratoff, Keith Petersen, James Prest, Ron Fowler, Frank Gaude,
  123.     Sigi Kluger, Irv Hoff and likely others.
  124.  
  125. ========================================================================
  126.