home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / s.lbr / SPEEDUP.HZP / SPEEDUP.HLP
Encoding:
Text File  |  1991-11-18  |  7.3 KB  |  137 lines
  1. ;
  2.                                 SPEEDUP.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5. SPEEDUP.COM    3k (20)   8768  1.1        Hal Bower 8/89           Z3COM11
  6. SLOWDOWN.COM   1k (5)    BC1B  1.1        Hal Bower 8/89           Z3COM11
  7.  
  8.   1- Syntax  2- Operation  3- Configuration  4- Notes  5- Examples of Use     
  9.  
  10.    SPEEDUP is  a program originally designed to reduce the wear and tear  on a 
  11. portable computer equipped with  a single floppy disk drive  by minimizing the 
  12. requirements to  seek  to the directory tracks.   This version is  expanded to 
  13. accomodate  hard drives as  well for improved execution of script files and in 
  14. loading ZCPR3 system files.  It is a Resident System Extension (RSX) complying 
  15. with the latest Plu*Perfect definitions, and occupies space in the high end of 
  16. the Transient Program Area under  CP/M 2.2,  ZRDOS 1.x and  ZSDOS.   It may be 
  17. removed  by the Plu*Perfect REMOVE.COM routine,  or the companion SLOWDOWN.COM 
  18. transient program.
  19. :1
  20.  
  21.     Syntax   SPEEDUP [d:][s]
  22.         
  23.    Options   d: - Drive letter followed by colon
  24.              s  - Size of Cache in K (1-8)
  25.  
  26.   Defaults   Drive is currently logged
  27.              Size is 4K (128 entries)
  28.  
  29.    If no arguments follow the name,  the first four kilobytes  (128  directory 
  30. entries) of the currently logged drive will be loaded into a RAM buffer in the 
  31. resident module.  If a drive is specified, the first 128 directory entries (or
  32. fewer if the specified disk is  so  defined) will be entered.   In  a  similar 
  33. manner, the size of the buffer may be adjusted from one to eight kilobytes (32
  34. to 256 directory entries) by  appending a  size  number  immediately after the 
  35. drive separator (from 1k, 32 directory entries, to 8k, 256 entries).
  36. :2
  37.  
  38.  Operation - 1/2 
  39.  
  40.    When loaded, all or a  part of the disk directory is entered into protected 
  41. memory within the resident portion of the  RSX where it functions  as  a semi-
  42. permanent cache.  A DOS request to read one of these entries only accesses the 
  43. RAM copy,  and the  physical  disk  does  no  seek  to  the  directory tracks.  
  44. Instead, the requested file is  located  from  the cached data,  and  the head 
  45. positioned immediately to the data area on the disk.   A  write operation will 
  46. cause both the RAM and physical  disk  areas to  be updated with the necessary 
  47. operation,  so  little   is  gained  by  using  SPEEDUP   for  write-intensive 
  48. operations.
  49.  
  50.    The only precaution in  this  is  to  avoid  loading  a permanent RSX while 
  51. SPEEDUP is active.   Examples of  such  modules include  DateStamper (tm)  and 
  52. BackGrounder (tm) from Plu*Perfect Systems.   If either of these  are included 
  53. in  your startup file,  either load  them  before  SPEEDUP  or after SLOWDOWN.
  54. Clock driver modules for ZSDOS  only fall into  this catagory if  the RSX load 
  55. method is selected while running SETUPZST.
  56.  Operation - 2/2 
  57.  
  58.  
  59.   ***************************************************************************
  60.   * CAUTION: Since the directory is buffered, automatic disk change sensing *
  61.   * may be defeated.  NEVER CHANGE A DISK UNDER SPEEDUP WITHOUT IMMEDIATELY *
  62.   * FOLLOWING IT WITH A WARM BOOT (Control-C).  If you forget this step and *
  63.   * write to the disk, you will copy a portion of the previous disk's dir-  *
  64.   * ectory and the new file to the present disk and probably destroy exist- *
  65.   * ing files!                                                              *
  66.   ***************************************************************************
  67.  
  68. To remove SPEEDUP, the companion program SLOWDOWN will remove it ONLY IF IT IS 
  69. THE LAST RSX LOADED!  SLOWDOWN is executed by simply entering its name as:
  70.  
  71.               SLOWDOWN 
  72.  
  73. If SPEEDUP is the lowest RSX in memory,  it will  be removed without affecting
  74. any higher RSX modules in memory.  SLOWDOWN will NOT work if other Plu*Perfect
  75. RSX modules have been  loaded  after SPEEDUP.   In  this  case,  Plu*Perfect's 
  76. REMOVE utility must be used to remove the lower modules, and SPEEDUP as well.
  77. :3
  78.  Configuration 
  79.  
  80.    Two configuration options exist to tailor SPEEDUP to your desires or needs.
  81. The file SPEEDUP.CFG contains all the pertinent  data for use with Al Hawley's 
  82. excellent ZCNFG configuration tool.  
  83.  
  84.    The first configuration item controls printing of  a small reminder message
  85. which is normally printed upon each Warm Boot.   It contains the program name,
  86. the  drive  whose  directory  is  buffered,  and  the  number  of kilobytes so 
  87. buffered.   The purpose of this message is to remind  you of the RSX  to avoid 
  88. the unnerving experience of loading  a large program and encountering the "Out 
  89. of Memory" condition.   ZCNFG will toggle  this  option  on  and  off from the 
  90. configuration screen.
  91.  
  92.    The second option should not be needed by most users,  and  should NEVER be
  93. altered unless you KNOW what you are doing.   It sets  the assumed size of the
  94. Console Command Processor for calculations  of where to  place SPEEDUP in high
  95. memory.   The normal size of  the CCP is 0800H bytes,  but some custom systems
  96. use a slightly larger size.  Consult your system documentation on this matter.
  97. :4
  98.  SPEEDUP Notes - 1/2 
  99.  
  100.    a. SPEEDUP is highly optimized for Z80  code and will  NOT  work on 8080 or 
  101.       8085 based systems.   It has  been tested on Ampro Little Boards, SB180s 
  102.       and  a number of S100 systems under  the  CP/M 2.2-compatible  operating 
  103.       systems listed previously.   The overhead required is  less than  1k for 
  104.       the resident  module  plus the buffer size determined in the invocation.  
  105.       The RAM is  obtained by  protecting the  Console Command Processor,  and 
  106.       moving the BDOS vector at  locations  6 and 7 to reflect the base of the 
  107.       resident module.  TPA reduction will therefore be the CCP size (normally
  108.       2k), plus 1k for the RSX, plus the one to  eight k  for  the buffer.  In 
  109.       the default size,  a  reduction  in  TPA  of  approximately  7k  will be 
  110.       noticed.   The maximum buffer size of 8k will cause a reduction of about 
  111.       11k in available TPA space.
  112.  SPEEDUP Notes - 2/2 
  113.  
  114.    b. The cached  directory  information  is  updated  at  each  warm  boot to 
  115.       accomodate changes in disks.  The program flow first calls the BIOS disk
  116.       select routine with  a "New Mount" flag  set  to  force updating of BIOS 
  117.       information.   Necessary parameters  are then read  into the RSX and the 
  118.       cache  data is loaded.   This data may be examined with the ZCPR3 "Peek" 
  119.       command or with a debugger if you are curious about how it appears.
  120. :5
  121.  Examples of Use 
  122.  
  123.    a. Perhaps the biggest effect of  SPEEDUP may be obtained in  loading ZCPR3 
  124.       system  files.   SPEEDUP may be called  within  a STARTUP file by adding 
  125.       lines as: 
  126.  
  127.               SPEEDUP A:8         <== Buffer the boot drive, size arbitrary
  128.               ...                 <== Load the SYS files, etc
  129.               SLOWDOWN            <== ..and remove SPEEDUP
  130.  
  131.    b. SPEEDUP      <-- Cache 4K of current drive
  132.  
  133.    c. SPEEDUP 6    <-- Cache 6K of current drive
  134.  
  135.    d. SPEEDUP D:   <-- Cache 4K of drive D:
  136.  
  137.    e. SPEEDUP C:8  <-- Cache 8K of drive C: