home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / dskstruc / dmgpr231.arj / DMGPARK.DOC < prev   
Text File  |  1992-05-09  |  9KB  |  199 lines
  1.  
  2.  
  3.  
  4.                                    DmgPARK.COM
  5.                        Hard Disk Head Parking TSR Utility
  6.  
  7.                        Copyright 1991, 1992 by Dan Goodell
  8.                                  April 24, 1992
  9.  
  10.  
  11.  
  12.           DmgPARK is a memory-resident program that will park your
  13.           hard disk's heads after a period of hard disk inactivity. 
  14.           This program will park one or two disks.  In a system with
  15.           two disks, each disk is parked independently.  Thus,
  16.           activity on one drive will not prevent the other drive from
  17.           parking.  The program should be able to automatically find
  18.           the innermost cylinder on the disk and use it as the
  19.           "landing zone".  If this is not where your disk's landing
  20.           zone is, you can specify the correct landing zone with a
  21.           command line parameter (unlike most other parking programs). 
  22.           Unlike most TSR parkers, this program avoids interrupting
  23.           the system during other disk accesses (which can crash the
  24.           system).  The program will detect if a copy of itself is
  25.           already memory-resident.
  26.  
  27.           Command syntax:
  28.  
  29.               DMGPARK  [/i]  [/u]  [/t:n]  [/0:n]  [/1:n]
  30.  
  31.                   /i      install TSR automatically (if not installed)
  32.                           or report parameter settings (if installed)
  33.  
  34.                   /u      uninstall TSR, if possible
  35.  
  36.                   /t:n    specify parking timeout period in seconds
  37.                           (range= 0 to 3600)
  38.  
  39.                   /0:n    force first disk to park at track number n
  40.  
  41.                   /1:n    force second disk to park at track number n
  42.  
  43.           One or more parameters must be included to install the
  44.           program.  If no parameters are specified on the command
  45.           line, a help screen is displayed showing the syntax options.
  46.  
  47.           The /i parameter will install the program if it is not yet
  48.           memory-resident.  If already installed, it will report the
  49.           time and track numbers already in use.
  50.  
  51.           Installing subsequent TSR's that use Interrupts 10h, 13h, or
  52.           1Ch will prevent this one from being uninstalled.
  53.  
  54.           The timeout period is entered in seconds.  Entries over 3600
  55.           seconds (1 hour) may be entered but will be capped at 3600. 
  56.           An entry of 0 will disable the parking function for both
  57.           disks.  If no period is specified, the default period is 120
  58.           seconds.
  59.  
  60.           If the track number parameters are not used, the program
  61.           will automatically determine the parking cylinder.  This can
  62.           be overridden by designating another track number to use. 
  63.           Specifying any invalid track will disable the parking
  64.           function for that disk.  Note: A subsequent call with the /i
  65.           parameter will cause the program to auto-find the parking
  66.           cylinder anew.
  67.  
  68.           The time and track number settings can be altered after
  69.           installation.  These numbers are entered and displayed in
  70.           decimal format.
  71.  
  72.  
  73.           DmgPARK is supplied as is.  The author disclaims all
  74.           warranties, expressed or implied, including, without
  75.           limitation, the warranties of suitability for any purpose. 
  76.           The author assumes no liability for damages, direct or
  77.           consequential, which may result from the use of this
  78.           program.  Users of this program must accept this disclaimer
  79.           of warranty.
  80.  
  81.           This program is the copyrighted work of its author, Dan
  82.           Goodell.  There is no charge for private, non-commercial use
  83.           of this program.  You are granted a license to use and
  84.           distribute this software, subject to the following:
  85.  
  86.               1).  It must be distributed in its original, unmodified
  87.           form, and with this documentation accompanying the program
  88.           file.
  89.  
  90.               2).  No fee may be charged for use or or distribution,
  91.           except for a nominal disk copying charge, not to exceed
  92.           $5.00.
  93.  
  94.               3).  The program may not be included with any other
  95.           product or service distributed for a fee, unless written
  96.           permission is provided by the author.
  97.  
  98.           I know the name of this program is not real clever, but give
  99.           me a break, folks -- all the good names are taken!  I've
  100.           heard of Diskpark, Hardpark, Hdpark, Autopark, Timepark,
  101.           Parktime, Pcpark, not to mention Park, Park, Park, Park, and
  102.           yet another Park!  I just want to be able to find mine
  103.           amongst all of the above!
  104.  
  105.           By the way, for a detailed review of a lot of these parking
  106.           utilities, please see my separate report, "The Truth About
  107.           Hard Disk Head Parking Programs", uploaded as PRKING.ZIP. 
  108.           If you use a parking utility, this report is well worth
  109.           reading!
  110.  
  111.           If you have any comments or questions about this program,
  112.           please contact me at CompuServe [71520,3116] or the address
  113.           shown below.
  114.  
  115.  
  116.  
  117.                               DmgPARK  Version 2.31
  118.                     Copyright 1991, 1992, All rights reserved
  119.  
  120.                                  by Dan Goodell    
  121.                                1261 Hookston Road  
  122.                                Concord, CA  94518  
  123.                              CompuServe: 71520,3116
  124.  
  125.  
  126.  
  127.  
  128.           Revision History:
  129.  
  130.           Version 2.31 Changes:                            04/24/92
  131.                  1. Modified use of 'busy' byte -- also set to 01h
  132.                     when any call to INT 13h is made. This prevents
  133.                     the parking routine from activating when other
  134.                     INT 13h action (such as a floppy read or write)
  135.                     is in progress, which could crash the system.
  136.  
  137.           Version 2.30 Changes:                            04/14/92
  138.                  1. Modified use of 'busy' byte -- set to 01h only
  139.                     when parking is actually in progress.
  140.                  2. Bug fix - the 8259 Interrupt Controller is not
  141.                     normally reenabled by the time the INT 1C bios
  142.                     routine finishes and our park routine is entered.
  143.                     New1C routine now reenables the 8259.
  144.                  3. Bug fix - asm logic corrected to allow timeout
  145.                     periods between 30-60 minutes.  The old logic 
  146.                     considered a drive parked if the 16-bit counter
  147.                     was negative, so barred using timeout values of
  148.                     8000h-FFFFh.
  149.  
  150.           Version 2.21 Changes:                            02/03/92
  151.                  1. Modified new INT 1C routine to carry out normal
  152.                     servicing first before returning to carry out new
  153.                     services.  This should prevent possible loss of
  154.                     time due to the timer tick routine getting lost
  155.                     during the parking routine.
  156.  
  157.           Version 2.20 Changes:                            01/06/92
  158.                  1. Removed incrementing seek test to find the last
  159.                     track - some controllers do not return seek
  160.                     errors so installation would hang.
  161.                  2. Installation routine now makes three attempts to
  162.                     find a parking track.
  163.  
  164.           Version 2.11 Changes:                            12/31/91
  165.                  1. Timeout seconds register increased from byte to
  166.                     word to allow periods greater than 255 seconds.
  167.                     Seconds limited to 3600 to avoid divide overflow
  168.                     when converting to timer ticks.
  169.                  2. Bug fix - corrected math error in findcyl routine
  170.                     when parking track is incremented or decremented
  171.                     across boundary of exact multiple of 256.
  172.  
  173.           Version 2.10 Changes:                            12/05/91
  174.                  1. Uninstall option added.
  175.                  2. Bug fix - program now returns version number of
  176.                     installed TSR instead of misinterpreting version
  177.                     at command line as the TSR version.
  178.  
  179.           Version 2.00 Changes:
  180.                  1. If dmgPARK is run again after installation, it
  181.                     will now overlay parameters in the installed TSR,
  182.                     instead of just refusing to run.
  183.                  2. Active TSR now returns its version number when
  184.                     polled by the command line program.
  185.                  3. Default is now Help mode instead of Install mode,
  186.                     parameter /i added.
  187.                  4. Timeout value in secs. is now saved for later
  188.                     redisplay with /i parameter.
  189.                  5. If parking track value is erased, /i without
  190.                     track parameter enables dmgPARK to automatically
  191.                     find innermost track and use it.  A valid track
  192.                     parameter will overlay, an invalid parameter will
  193.                     erase the existing track value.
  194.                  6. Coding changes to simplify routines.
  195.  
  196.           Version 1.00: original TSR version.
  197.  
  198.  
  199.