home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / p / sap60.lbr / SAP60.DZC / SAP60.DOC
Encoding:
Text File  |  1993-10-25  |  4.6 KB  |  120 lines
  1. TITLE : SAP60.DOC help file
  2.  
  3. FROM  ; IRV HOFF
  4.  
  5. DATE  : 27 JULY 87
  6.  
  7.  
  8.          NOTE:    As distributed, this program
  9.             erases zero-length files not
  10.             having a '-' in front of the
  11.             file name.  This can easily
  12.             be changed with byte 0103h.
  13.  
  14. WHAT IT DOES:
  15. -------------
  16. SAP60 (Sort And Pack the disk directory) is a program developed through
  17. the years to clean up the disk directory tracks of a CP/M disk.  It works
  18. equally well on tiny floppy drives or gigantic hard drives in excess of
  19. 100 Mb capacity.  It will check the directory to see how many files it
  20. contains, check memory to see sufficient is available.    (At 32 bytes per
  21. file name it can easily handle more than 1500 files names on a typical
  22. 50k TPA - most users have more TPA than that.)
  23.  
  24. It reads the filenames into memory from the directory tracks, cleans off
  25. the entire directory track area with E5's throughout, uses the same fast
  26. sort routine in current SD (Super Directory) programs and then puts the
  27. names back on the disk in alphabetic order.
  28.  
  29. HOW TO USE IT:
  30. --------------
  31. The program automatically works on the current drive unless you specify
  32. a different one.  In the following examples we assume you have renamed
  33. the program SAP.COM - it will tell you what version it is when it starts
  34. running:
  35.  
  36.        B>SAP    <ret>     -  current drive
  37.        B>SAP D: <ret>     -  with or without colon
  38.        B>SAP d  <ret>     -  upper or lower case
  39.  
  40. It also has a small (but hopefully adequate) help guide available:
  41.  
  42.        B>SAP ?  <ret>     -  displays a help guide
  43.  
  44.  
  45. ERASING ZERO-LENGTH FILES:
  46. -------------------------
  47. It erases files with an '$$$' extent and optionally erases 'zero-length'
  48. files.    That's worth some discussion.
  49.  
  50. Many people use names on their user areas to identify that disk:
  51.  
  52.         -    .123  0k   (for catalog programs, etc.)
  53.         -UPLOADS      0k   (for RCPM disk identification, etc.)
  54.         -MODEMS       0k   (perhaps to name a diskette
  55.  
  56. You obviously don't want "these zero-length" files erased by a disk
  57. utility program such as this.  Any files with a leading '-' will be re-
  58. tained.  You can optionally delete any other zero-length files or keep
  59. them:
  60.  
  61.     ERAZRO    DB  NO          does not erase them
  62.     ERAZRO    DB  YES       erases any non '-' zero-length files
  63.  
  64. You can change byte 0103h in a moment's time with SID or DDT to which-
  65. ever you prefer, then save 8 pages when finished.  (The program is a bit
  66. under 2k object code length.)
  67.  
  68.     0103h  00   keeps all zero-length files
  69.     0103h  FF   erases any non '-' zero-lengh files
  70.             (use anything other than 00h)
  71.  
  72.  
  73. TIME-DATE STAMPED FILES:
  74. ------------------------
  75. Since v50, SAP supports the Plu*Perfect (c) time and date stamping pro-
  76. gram.  These routines were added by Bridger Mitchell of Plu*Perfect.  At
  77. the same time he replaced the Shell-Metnzer sort that Sigi Kluger had
  78. added in v38 with one directly from the Super Directory (SD) program.
  79. It is substantially faster than that used SAP programs prior to v50.
  80.  
  81. ADVANTAGES:
  82. -----------
  83.  
  84. This program reads the disk directory tracks, sorts them alphabetically
  85. and then replaces them on the disk after first erasing the entire direc-
  86. tory area with E5's.  This erasure clears all previous file names that
  87. might remain after the new list is replaced.  Sorting the directory in
  88. this manner offers several advantages:
  89.  
  90.     1)  allows 'DIR' to show an alphabetized listing
  91.     2)  minimizes potential problems when using "UNERASE" pgms
  92.     3)  speeds up access via 'SD' and other special programs
  93.     4)  assists on working directly on the disk with 'DU', etc.
  94.     5)  prevents somebody else from reading files you erased
  95.     6)  option of erasing all files of zero-length (except those
  96.           starting with '-' for catalog use with MAST.CAT or to
  97.           name your disks, identify user areas, etc.
  98.  
  99. SUMMARY:
  100. -------
  101. This program can be used without alteration on any size floppy or hard
  102. drive.    It is intended only for CP/M-80 v2.2.  The only option involves
  103. zero-length files.  As mentioned that option is very easy to change in a
  104. moment's time.    It also supports disks using Plu*Perfect's time and date
  105. stamping program.
  106.  
  107.      Note:    There were several conflicting versions of
  108.         the SAP program including at least two v50
  109.         programs.  One would not work with 8080 or
  110.         8085 processors and required the Z80MR as-
  111.         sembler. That got confusing as it can only
  112.         assemble .AZM programs which nearly every-
  113.         one now associates  with "crunched files".
  114.         This version  hopefully coordinates all of
  115.         the more desirable  features of these var-
  116.         ious programs.
  117.  
  118.                 end
  119. ------------------------------------------------------------------------
  120.