home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / p.lbr / PACK.HZP / PACK.HLP
Encoding:
Text File  |  1991-11-18  |  5.9 KB  |  126 lines
  1. ;
  2.                                      PACK                                     
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                5k (36)   396D  1.0b       Michael Broschat 7/89    Z3COM7
  6.  
  7.   1- Syntax/Options  2- Notes  3- File List  4- Messages  5- Examples of Use  
  8.  
  9.  
  10.    PACK rearranges data on disks so that all data associated with each file is
  11. contiguous.  This reduces  disk  head movement when  that file is subsequently
  12. read  or  modified.  The user  can  specify  certain files which should not be 
  13. moved, and can specify priorities among  the remaining files, so that the most 
  14. frequently accessed  files are  moved close to  the disk directory for reduced 
  15. access time.  
  16.  
  17.    Pack Vs 1.0 by Frank Cringle.
  18. :1
  19.  
  20.    Syntax   PACK <flist> <options>
  21.  
  22. <flist> is required and  is the name  of the file containing the list of fixed 
  23. and mobile file patterns.  The possible options are:
  24.  
  25.   Options   Dx  <-- pack disk x (default is the disk on which flist resides)
  26.             S   <-- display statistics only.  No packing takes place.
  27.             V   <-- be verbose.  The file patterns extracted from <flist> are
  28.                     displayed, and then the group permutation table (mainly 
  29.                     for debugging).
  30. :2
  31.  PACK Notes - 1/2 
  32.  
  33.    a. PACK requires  ZCPR3  with  CP/M 2.2  or ZRDOS, and  a Z80 or compatible 
  34.       processor.  It will only run if the user has wheel priviledge.
  35.  
  36.    b. Before using PACK, you must make a list of fixed and priority files for
  37.       the disk.  Backup the disk, sort the directory, and then run PACK.
  38.  
  39.    c. Backing up the disk...  You should  do this regularly, and always before 
  40.       running PACK.  Not that a disk crash is more probable while running PACK
  41.       than at  other times, but  it  is more certainly catastrophic if it does 
  42.       happen.  You will definitely  have to  restore the disk from your backup 
  43.       copy (floppies or tape) if the system crashes due  to a power failure or 
  44.       inadvertent reset while PACK is running.
  45.  
  46.    d. Sorting the directory... Use  CLEANDIR  or  SAP  to  sort  the directory 
  47.       entries on  the  disk.  The file  list given  to PACK preempts directory 
  48.       order, but within  each  group of files which match an entry in the file 
  49.       list directory order determines the order in which the data is packed.
  50.  PACK Notes - 2/2  
  51.  
  52.    e. Version 1.0b is an  assembled version of the  same source code linked to 
  53.       the new version (V4LIB) of SYS-, Z3-, V- libs.  Assembly and linking was
  54.       with the SLR Systems tools, Z80ASM and SLRNK. 
  55. :3
  56.  The file list 
  57.  
  58.    PACK requires  an input  file which  specifies which files on the disk must 
  59. remain where they are and which of  the remaining files should be moved to the 
  60. beginning of the disk.  The structure of this file is a sequence of file names
  61. and file classes, one to a line.  File classes (fixed or mobile) are specified
  62. by a line beginning with a semi-colon.  So a typical file list might be:
  63.  
  64.      ; Fixed             <-- All files  in any  user  area  matching !!*.* and
  65.      *:!!*.*                 BADSECT*.* remain fixed (on  my  system these are
  66.      *:BADSECT*.*            PluPerfect DateStamper and Backgrounder files and
  67.                              files which lock out flakey sectors).
  68.      ; Mobile            <-- The LBR containing less-frequently used COM files
  69.      CMD:COMMAND.LBR         is moved to  the front, followed by  all files in
  70.      ROOT:*.*                the  ROOT  directory.  PACK automatically appends
  71.                              *:*.* to  the  end  of the  mobile  list, so  all
  72.                              remaining files on the disk follow on.
  73.  
  74.    Case is not significant and blank lines are ignored.  DU: or DIR: is okay.
  75. * or ? means all user numbers.  A disk specified implicitly or explictly must 
  76. correspond to the disk specified on the command line (see D option).
  77. :4
  78.  Messages - 1/2 
  79.  
  80.    Ready to pack disk x                            
  81.    Are you sure you wish to proceed? (y/n) - 
  82.    Disk packed
  83.    nnnn group reads and mmmm group writes required to pack disk.   
  84.    PACK: interrupted by user          - you pressed ^C
  85.    Option not recognized: x
  86.    No such disk: x
  87.    Disk specification missing
  88.  
  89. Problems with <flist>
  90.    Line xxxx: invalid filename
  91.    Line xxxx specifies disk x (y expected)
  92.    Line xxxx: can't interpret directory specification
  93.    Line xxxx too long: truncated.
  94.  
  95. Disk read/write errors:
  96.      Can't read directory               - disk read error
  97.      read error at group gggg:ss        - group cannot be read/written,
  98.      write error at group gggg:ss       - see PACK.DOC for recovery
  99.  Messages - 2/2 
  100.  
  101. General problems:
  102.      PACK requires CP/M 2.2 (or ZRDOS)
  103.      Can't find <flist>
  104.      Disk x is set read only
  105.      Out of memory                      - you have a tiny TPA
  106.      Disk overflow (can't happen!)      - more groups are allocated in 
  107.                                           the directory than there are
  108.                                           groups on the disk
  109. :5
  110.  Examples of Use 
  111.  
  112.    a. B>PACK FLIST.C DCS       - display number of allocation groups that 
  113.                                  would have to be read and written to 
  114.                                  pack disk C according to the file list 
  115.                                  FLIST.C
  116.  
  117.    b. B>PACK FLIST.C DC        - as before, but 'for real'
  118.  
  119.  
  120.    PACK will  ask for  confirmation before  proceeding  to pack the disk.  The 
  121. process takes anywhere from a  few seconds to maybe  half an hour depending on 
  122. how much data must  be moved  and  how fast your disk hardware is.  If you get 
  123. impatient, on  no account switch  off or reset the machine.  If you hit ^C the 
  124. program will attempt  to  cut short  the packing process, but it may take some 
  125. time to reach a convenient consistent state.
  126.