home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / p / sap50.lbr / SAP50.DZC / SAP50.DOC
Encoding:
Text File  |  1993-10-25  |  3.8 KB  |  89 lines
  1. SAP v50 -- SORT AND PACK CP/M DISK DIRECTORY -- 08/05/86
  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 or without 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 various user options at the
  35.         beginning of the file to either YES or NO, depending upon
  36.         your tastes.  Desiderata is as follows:
  37.  
  38.         a)    If CPMONLY is YES, no checks will be made to ensure that
  39.         SAP is running on a CP/M 1.4 or 2.2 machine.  Attempting
  40.         to run SAP under MP/M or CP/M+ will probably damage your
  41.         disk directory.  If CPMONLY is NO, checks will be made
  42.         to prevent SAP's execution under MP/M and CP/M+.
  43.  
  44.         b)    If ONLY14 is YES, you are guaranteeing that SAP will be
  45.         executed only in a CP/M 1.4 environment.  If you are not
  46.         sure, or if you are sure that SAP will never be executed
  47.         in a CP/M 1.4 environment, set to NO.
  48.  
  49.         c)    If ONLY22 is YES, you are guaranteeing that SAP will be
  50.         executed only in a CP/M 2.2 environment.  If you are not
  51.         sure, or if you are sure that SAP will never be executed
  52.         in a CP/M 2.2 environment, set to NO.
  53.  
  54.         d)    If both ONLY14 and ONLY22 are set to NO, tests will be
  55.         made (as in SAP40) at run time to determine the environ-
  56.         ment.  Do not set both ONLY14 and ONLY22 to YES.
  57.  
  58.         e)    If DELZRO is YES, any file of zero length not beginning
  59.         with the character "-" will be deleted (as in SAP40).
  60.         If SAVDASH is NO then all zero length files beginning with
  61.         "-" will also be deleted.  If DELZRO is NO, no file will be
  62.         deleted solely on the basis of its length.
  63.  
  64.         f)    If ASCENDING is YES, the user areas and files in each user
  65.         area will be sorted ascending.    If set to NO then the user
  66.         areas will still be sorted ascending, but the files within
  67.         each user area will be sorted descending.
  68.  
  69.         g)    If SAVDASH is YES, then files beginning with "-" will never
  70.         be deleted by SAP.  If SAVDASH is NO, then the action of
  71.         DELZRO will be unimpaired by checking file names.
  72.  
  73.         h)    Set MAXDRIVE to the highest drive letter on your system.  Any
  74.         attempt to access a higher drive by SAP will generate an error.
  75.  
  76.     2)  Assemble the source program with Z80MR or any assembler compatible
  77.         with it.  Linkedit, LOAD, or MLOAD as required.  Run as needed.
  78.  
  79. NOTE:  The SAP50.COM file enclosed with the library SAP49.LBR has been
  80.        assembled with the following options:
  81.  
  82.     CPMONLY     EQU    YES
  83.     ONLY14        EQU    NO
  84.     ONLY22        EQU    YES
  85.     MAXDRIVE    EQU    'B'
  86.     DELZRO        EQU    YES
  87.     SAVDASH     EQU    YES    <== changed from SAP49!
  88.     ASCENDING    EQU    YES
  89.