home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / zcpr33 / pack10a.lbr / PACK10A.HZP / PACK10A.HLP
Text File  |  1988-01-24  |  6KB  |  159 lines
  1. ;                                                               v 1.0
  2.  
  3.  
  4.                PACK  --   Disk Packing Utility
  5.  
  6.  
  7.                I  Introduction
  8.                U  Usage
  9.                M  Messages
  10.  
  11. :I
  12. Introduction
  13.  
  14. PACK reorganises CP/M disks to improve file access times.  It requires 
  15. ZCPR3 with CP/M 2.2 or ZRDOS, and a Z80 or compatible processor.  It 
  16. will only run if the user has wheel priviledge.
  17.  
  18. The data on a given disk is rearranged in situ so that all the data 
  19. associated with each file is contiguous.  This reduces disk head 
  20. movement when that file is subsequently read or modified.  The user can 
  21. specify certain files which should not be moved, and can specify 
  22. priorities among the remaining files, so that the most frequently 
  23. accessed files are moved close to the disk directory for reduced access 
  24. time.
  25.  
  26. :U
  27. Using PACK
  28.  
  29. Follow these steps -
  30.  
  31.     1. Make a list of fixed and priority files
  32.     2. Backup the disk
  33.     3. Sort the directory
  34.     4. Run PACK
  35.  
  36. The file list
  37.  
  38. PACK requires an input file which specifies which files on the disk must 
  39. remain where they are and which of the remaining files should be moved 
  40. to the beginning of the disk.  The structure of this file is a sequence 
  41. of file names and file classes, one to a line.  File classes (fixed or 
  42. mobile) are specified by a line beginning with a semi-colon.  So a 
  43. typical file list might be:
  44.  
  45.      ; Fixed
  46.      *:!!*.*
  47.      *:BADSECT*.*
  48.  
  49.      ; Mobile
  50.      CMD:COMMAND.LBR
  51.      ROOT:*.*
  52.  
  53. This means that all files in any user area matching !!*.* and BADSECT*.* 
  54. remain fixed (on my system these are PluPerfect DateStamper and 
  55. Backgrounder files, and files which lock out flakey sectors).  Then the 
  56. library file containing less frequently used COM files is moved to the 
  57. front, followed by all files in my ROOT directory.  PACK automatically 
  58. appends *:*.* to the end of the mobile list, so all remaining files on 
  59. the disk follow on.
  60.  
  61. Case is not significant in the file list, and blank lines are ignored.  
  62. Directories can be given in DU: or DIR: form. * or ? in the directory 
  63. field means all user numbers.  If a disk is specified implicitly or 
  64. explictly it must correspond to the disk specified on the command line
  65. (see D option below).
  66.  
  67.  
  68. Backing up the disk
  69.  
  70. You should do this reqularly, and always before running PACK.  Not that 
  71. a disk crash is more probable while running PACK than at other times, 
  72. but it is more certainly catastrophic if it does happen.  You will 
  73. definitely have to restore the disk from your backup copy (floppies or 
  74. tape) if the system crashes due to a power failure or inadvertent reset 
  75. while PACK is running.
  76.  
  77.  
  78. Sorting the directory
  79.  
  80. Use CLEANDIR or SAP to sort the directory entries on the disk.  The file 
  81. list given to PACK preempts directory order, but within each group of 
  82. files which match an entry in the file list directory order determines 
  83. the order in which the data is packed.
  84.  
  85.  
  86. Running PACK
  87.  
  88. Enter the command:  PACK <flist> <options>
  89.  
  90. <flist> is required and is the name of the file containing the list of 
  91. fixed and mobile file patterns.  The possible options are:
  92.  
  93.      Dx      - pack disk x (default is the disk on which flist resides)
  94.      S       - display statistics only.  No packing takes place.
  95.      V       - be verbose.  The file patterns extracted from <flist> are
  96.                displayed, and then the group permutation table (mainly 
  97.                for debugging).
  98.  
  99. Examples:
  100.  
  101.      B>PACK FLIST.C DCS       - display number of allocation groups that 
  102.                                 would have to be read and written to 
  103.                                 pack disk C according to the file list 
  104.                                 FLIST.C
  105.      B>PACK FLIST.C DC        - as before, but 'for real'
  106.  
  107. PACK will ask for confirmation before proceeding to pack the disk.  The 
  108. process takes anywhere from a few seconds to maybe half an hour 
  109. depending on how much data must be moved and how fast your disk hardware 
  110. is.  If you get impatient, on no account switch off or reset the 
  111. machine.  If you hit ^C the program will attempt to cut short the 
  112. packing process, but it may take some time to reach a convenient 
  113. consistent state.
  114.  
  115. :M
  116. Messages
  117.  
  118. Normal messages:
  119.  
  120.      Ready to pack disk x
  121.      Are you sure you wish to proceed? (y/n) - 
  122.  
  123.      Disk packed
  124.  
  125. Statistics report:
  126.  
  127.      nnnn group reads and mmmm group writes required to pack disk.
  128.  
  129. Interrupt:
  130.      PACK: interrupted by user          - you pressed ^C
  131.  
  132. Problems with options:
  133.  
  134.      Option not recognized: x
  135.      No such disk: x
  136.      Disk specification missing
  137.  
  138. Problems with <flist>
  139.  
  140.      Line xxxx: invalid filename
  141.      Line xxxx specifies disk x (y expected)
  142.      Line xxxx: can't interpret directory specification
  143.      Line xxxx too long: truncated.
  144.  
  145. Disk read/write errors:
  146.      Can't read directory               - disk read error
  147.      read error at group gggg:ss        - group cannot be read/written,
  148.      write error at group gggg:ss       -  see PACK.DOC for recovery
  149.  
  150. General problems:
  151.  
  152.      PACK requires CP/M 2.2 (or ZRDOS)
  153.      Can't find <flist>
  154.      Disk x is set read only
  155.      Out of memory                      - you have a tiny TPA
  156.      Disk overflow (can't happen!)      - more groups are allocated in 
  157.                                           the directory than there are
  158.                                           groups on the disk
  159.