home *** CD-ROM | disk | FTP | other *** search
/ Piper's Pit BBS/FTP: ibm 0000 - 0009 / ibm0000-0009 / ibm0003.tar / ibm0003 / CACHEDOC.ZIP / CACHE-AT.DOC < prev    next >
Encoding:
Text File  |  1990-02-03  |  10.2 KB  |  239 lines
  1.                           Vcache Operations
  2.  
  3.          Command Line Format
  4.  
  5.          The command line format for Vcache varies with the type
  6.          of memory you want to use for your cache:
  7.  
  8.              cache [size] [options] for standard memory
  9.  
  10.              cache-at [size] [start] [options] for extended memory
  11.  
  12.              cache-em [size] [options] for expanded memory
  13.  
  14.          Brackets [ ] denote optional parameters and should not
  15.          be entered on the command line.
  16.  
  17.          [size] specifies the cache memory size in Kbytes. If you
  18.          do not specify a size, Vcache will automatically assign a
  19.          default cache size as follows:
  20.  
  21.              cache - 128 Kb of standard memory will be reserved
  22.              for use by other programs, and all remaining memory
  23.              assigned to the cache.
  24.  
  25.              cache-at - Vcache will attempt to reserve any ex-
  26.              tended memory used by DOS VDISK and assign all
  27.              remaining extended memory to the cache.
  28.  
  29.              cache-em - all free expanded memory will be as-
  30.              signed to the cache.
  31.  
  32.          [start] specifies the extended memory starting address
  33.          in Kb for cache-at. If you do not specify a starting ad-
  34.          dress, the cache will begin at the bottom of extended
  35.          memory (1024Kb).
  36.  
  37. 4-1                                      Vcache Operations
  38.           If you are sharing the use of extended memory among
  39.           several programs, you must explicitly assign non-overlap-
  40.           ping blocks of extended memory to each program using
  41.           location and size specifications.
  42.  
  43.           [options] are specified by a "/" followed by a letter. More
  44.           than one option may be specified on a command line.
  45.  
  46.           options c through 0
  47.  
  48.           The option letters c through 0 are used to specify drives
  49.           that require the use of a device driver (such as removable
  50.           media drives or hard disks using non-standard partition-
  51.           ing schemes). To instruct Vcache to support a specific
  52.           drive, add the drive's DOS drive letter to the start-up com-
  53.           mand. You may include up to 12 drive letters, provided
  54.           that no more than 4 different device drivers are required.
  55.  
  56.           Use these options only if you are sure that your disk sub-
  57.           system does not utilize standard BIOS calls and requires
  58.           a device driver. For example, if you have a standard XT
  59.           with a bootable hard disk and have added a non-bootable
  60.           Bernoulli Box, then the command line might look like:
  61.  
  62.                cache /d/e
  63.  
  64.           options c* through 0*
  65.  
  66.           The options /c* through /0* instruct Vcache not to cache
  67.           specific drives. For example, if you did not want to cache
  68.           drive "D" you could enter the command line:
  69.  
  70.                cache /d*
  71.  
  72. Vcache Operations                                           4-2
  73.            option B = n
  74.  
  75.            This option specifies the LookAhead buffer size where n
  76.            is any number from 0 to 32 Kb. If you do not include this
  77.            option, a default size of 4Kb for PC-AT's or 2Kb for PC-
  78.            XT's will be used.
  79.  
  80.            LookAhead is utilized during sequential disk access to im-
  81.            prove system performance. Vcache continually monitors
  82.            your disk activity and turns LookAhead on and off ac-
  83.            cording to the type of reads being done. If you are per-
  84.            forming sequential reads, Vcache will read large blocks of
  85.            sectors into the LookAhead buffer. This saves time by
  86.            anticipating future reads and "combining them with reads
  87.            that have already been requested. If you are doing ran-
  88.            dom reads, however, Vcache will automatically turn off
  89.            LookAhead in order to avoid spending time reading data
  90.            that won't be used.
  91.  
  92.            The LookAhead buffer is also used for deferred writes, as
  93.            discussed below. If you specify B = 0, both LookAhead
  94.            and the deferred write capability will be disabled.
  95.  
  96.           For example, for a LookAhead buffer size of 8 Kb you
  97.           would enter:
  98.  
  99.                Cache-at /B = 8
  100.  
  101.            option T=n
  102.  
  103.           This option specifies a maximum delay value for disk
  104.           writes. The delay value "n" may be O, 1, or 2 seconds. If
  105.           you do not include this option, a delay value of 1 second
  106.           will be used.
  107.  
  108. 4-3                                          Vcache Operations
  109.            If a non-zero delay value is specified, Vcache will defer
  110.            single sector writes up to 1 or 2 seconds. This achieves
  111.            substantial time savings by avoiding multiple updates of
  112.            the same sector and by combining multiple small write
  113.            commands into one larger write command.
  114.  
  115.            The LookAhead buffer (see above) is used when perform-
  116.            ing deferred writes. The larger the buffer is, the more data
  117.            Vcache can write per disk access, and the faster your
  118.            system runs. You must have a LookAhead buffer to take
  119.            advantage of deferred writes; if you specify B=0 the
  120.            deferred write feature is disabled.
  121.  
  122.            If Vcache is unable to find a safe time-slot to complete the
  123.            deferred writes, you will hear a snooze alarm sound every
  124.            five seconds until the deferred writes have been com-
  125.            pleted.
  126.  
  127.            If you reboot, Vcache will normally intercept the Ctl-Alt-
  128.            Del keystroke and complete any deferred writes before
  129.            continuing the boot sequence.
  130.  
  131.            option q
  132.  
  133.            This option terminates Vcache operation and releases al-
  134.            located memory.
  135.  
  136.            option r
  137.  
  138.            This option instructs Vcache to discard the cache con-
  139.            tents whenever a DOS Disk Reset function call is
  140.            detected. This may be useful when changing removable
  141.            media cartridges. Do not use this option with the Ber-
  142.            noulli Box, as the normal device driver handles media
  143.            changes properly.
  144.  
  145. Vcache Operations                                              4-4
  146.            option s
  147.  
  148.            This option enables AUTOCAD compatibility for Cache-
  149.            AT. Ordinarily AUTOCAD will use all of the extended
  150.            memory and overwrite your cached data. If you use this
  151.            option, then only that extended memory below the cache
  152.            area will be made available for use by other programs.
  153.  
  154.            option u
  155.  
  156.            This option accommodates certain disk partitioning
  157.            schemes for disks larger than 33 megabytes which do not
  158.            handle the disk BIOS interrupt correctly. This option is
  159.            not required for normal MS-DOS partitioning or for Vfea-
  160.            ture disk partitioning. When this option is used, only the
  161.            first 256 Mbytes of each physical disk is cached.
  162.  
  163.            option v
  164.  
  165.            This option disables normal INT 19 capture. This may
  166.            solve problems with rare and unusual programs that use
  167.            INT 19 in a non-standard manner.
  168.  
  169.            option w
  170.  
  171.            This option may be required for correct operation of
  172.            Vcache on "clone" PC-AT's which do not follow standard
  173.            conventions for returning from 80286 protected mode. lt
  174.            may also be required when using some extended
  175.            memory expansion boards at speeds above 8 megahertz.
  176.            If your computer stops when the cache is started, try
  177.            using this option.
  178.  
  179. 4-5                                             Vcache Operations
  180.             option x
  181.  
  182.             Vcache normally performs a memory diagnostic before it
  183.             begins caching the hard disk. When this option is used,
  184.             the diagnostic step is skipped.
  185.  
  186.             option z
  187.  
  188.             This option disables the snooze-alarm sound when run-
  189.             ning with deferred writes enabled.
  190.  
  191.             Displaying Status
  192.  
  193.             Vcache status may be displayed at any time after start-up
  194.             by re-executing the cache program (cache, cache-at, or
  195.             cache-em). Example:
  196.  
  197.                 Disk Usage Statistics:        Error Statistics: 
  198.              Kind   Requested Actual %         0 Cache Memory Errors
  199.              Reads      5933    551  9         0 Disk Transfer Errors
  200.              Writes     480     237  49        0 Errors Ignored by User
  201.  
  202.                                      
  203.  
  204.             Disk usage statistics indicate the number of disk read and
  205.             write requests, the actual number of disk reads and writes
  206.             performed, and the percentage ratio of actual to re-
  207.             quested reads and writes.
  208.  
  209.             Error statistics include the number of cache memory er-
  210.             rors, disk transfer errors, and cache I/0 errors ignored by
  211.             the user. These numbers include the number of retries re-
  212.             quired to achieve an error-free transfer. Disk errors are
  213.             associated with your disk subsystem. Memory errors are
  214.             associated with your extended or expanded memory sub-
  215.             system.
  216.  
  217. Vcache Operations                                                 4-6
  218.          If the message cache@e inactive appears above the status
  219.          display, a serious problem exists. This message will be
  220.          followed by an error code; error 99 indicates that some
  221.          other program is storing data in the cache tables; any
  222.          other error number indicates a failure in your expanded
  223.          memory subsystem.
  224.  
  225.          Quitting Vcache
  226.  
  227.          If you wish to terminate Vcache operation and release the
  228.          cache memory, re-execute the cache command (cache,
  229.          cache-at, or cache-em) using the q option.
  230.  
  231.          If another resident program has been started following
  232.          Vcache start-up, Vcache may not be able to release
  233.          standard memory, including the memory used for the
  234.          cache program itself,. If this occurs, a diagnostic mes-
  235.          sage will be displayed; in this case, quit the offending
  236.          resident program and then quit Vcache again.
  237.  
  238. 4-7                                        Vcache Operations
  239.