home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / sys_util / cav10h.zip / MANUAL.TX$ / manual.txt
Text File  |  1993-08-23  |  126KB  |  2,723 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.    █████████████████████████████████TM    WELCOME TO C&D PROGRAMMING CORP.'S:
  8.    ██                             ██
  9.    ██                             ██                  CacheAll(tm)
  10.    ██      ▄▄▄████████████        ██
  11.    ██    ▄████████████████        ██           The Cache of the 90's!(tm)
  12.    ██   ▄█████████████████        ██
  13.    ██   █████████\ ▀██████        ██             Order Line: (800) 847-5676
  14.    ██   █████████\ \ ▀▀▀▀▀        ██  Orders Outside U.S.A.: (801) 582-0503
  15.    ██   █████████\ \ \            ██                    BBS: (516) 434-8712
  16.    ██   █████████▄ \ \ \  ▄▄▄▄▄▄▄▄██▄▄▄        
  17.    ██   ███████████▄ \ \ \ ▀██████████████▄      Corporate Headquarters:
  18.    ██   ▀████████████▄ \ \ \ ▀██████████████         PO Box 1305
  19.    ██    ▀█████████████▄ \ \ \ ▀█████████████        Brentwood, NY 11717 USA
  20.    ██      ▀▀▀███████████▄ \ \ \ ▀███████████
  21.    ██                     █▄ \ \ \ ▀█████████
  22.    ██                     ███▄ \ \ \█████████
  23.    ██                     █████▄ \ \█████████    Sales Office:
  24.    ██                     ███████▄ \█████████        PO Box 581012
  25.    ██                     ██████████████████▀        Salt Lake City, UT 84158
  26.    ██                     █████████████████▀         USA
  27.    ████████████████████████████████████▀▀▀           FAX (801) 581-0883
  28.  
  29.     P  R  O  G  R  A  M  M  I  N  G
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                              Copyright (c), 1992-93
  38.                               C&D Programming Corp.
  39.                               All Rights Reserved.
  40.  
  41.         This evaluation version of CacheAll(tm), The Cache of the 90's!(tm),
  42.    may be freely copied and distributed for the purpose of evaluating
  43.    CacheAll(tm) under the conditions that CacheAll(tm), CUtil(tm) and the
  44.    accompanying software,
  45.  
  46.              (1)  will not be sold,
  47.              (2)  will not be reverse engineered,
  48.              (3)  will not be modified,
  49.              (4)  will not be incorporated, in whole or in part, into any
  50.                   other computer program,
  51.  
  52.    CacheAll, CUtil, AppTrack, "The Cache of the 90's!", FileTest and C&D's
  53.    logo are trademarks of C&D Programming Corp.
  54.  
  55.    All product names and services identified throughout this manual are
  56.    trademarks or registered trademarks of their respective companies.
  57.  
  58.  
  59.    CacheAll Evaluation Manual                                          Page i 
  60.    --------------------------------------------------------------------------
  61.  
  62.  
  63.                                 Table of Contents
  64.  
  65.    About CacheAll(tm), The Cache of the 90's!(tm), . . . . . . . . . . .     1
  66.  
  67.    About The Evaluation Version of CacheAll  . . . . . . . . . . . . . .     2
  68.  
  69.    How to Order CacheAll . . . . . . . . . . . . . . . . . . . . . . . .     2
  70.  
  71.    What do you get when you purchase CacheAll? . . . . . . . . . . . . .     3
  72.  
  73.    Technical Support -- How to reach us  . . . . . . . . . . . . . . . .     4
  74.  
  75.    Welcome to CacheAll . . . . . . . . . . . . . . . . . . . . . . . . .     5
  76.  
  77.    Before Installing CacheAll  . . . . . . . . . . . . . . . . . . . . .     6
  78.  
  79.    System Requirements . . . . . . . . . . . . . . . . . . . . . . . . .     6
  80.  
  81.    Application Compatibility for CacheAll  . . . . . . . . . . . . . . .     7
  82.  
  83.    Software Installation . . . . . . . . . . . . . . . . . . . . . . . .     9
  84.  
  85.    Preparing Your System For CacheAll  . . . . . . . . . . . . . . . . .     9
  86.  
  87.    About INSTALL . . . . . . . . . . . . . . . . . . . . . . . . . . . .     9
  88.  
  89.    Starting INSTALL  . . . . . . . . . . . . . . . . . . . . . . . . . .    10
  90.  
  91.    BEGINNERS: CacheAll is SMART! . . . . . . . . . . . . . . . . . . . .    13
  92.  
  93.    Running CacheAll  . . . . . . . . . . . . . . . . . . . . . . . . . .    14
  94.  
  95.    Unloading CacheAll  . . . . . . . . . . . . . . . . . . . . . . . . .    14
  96.  
  97.    CacheAll Options  . . . . . . . . . . . . . . . . . . . . . . . . . .    15
  98.  
  99.    CacheAll Option File  . . . . . . . . . . . . . . . . . . . . . . . .    23
  100.  
  101.    CacheAll Error Messages . . . . . . . . . . . . . . . . . . . . . . .    24
  102.  
  103.    CUtil(TM) Introduction  . . . . . . . . . . . . . . . . . . . . . . .    27
  104.  
  105.    CUtil for DOS . . . . . . . . . . . . . . . . . . . . . . . . . . . .    28
  106.  
  107.    CUtil Options . . . . . . . . . . . . . . . . . . . . . . . . . . . .    29
  108.  
  109.    CUtil for Windows . . . . . . . . . . . . . . . . . . . . . . . . . .    32
  110.  
  111.    Technical Specifications  . . . . . . . . . . . . . . . . . . . . . .    36
  112.  
  113.    Benchmarks  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    36
  114.  
  115.    Caching only specific drive directories . . . . . . . . . . . . . . .    38
  116.  
  117.  
  118.    CacheAll Evaluation Manual                                         Page ii 
  119.    --------------------------------------------------------------------------
  120.  
  121.  
  122.    Using CacheAll to Speed up Networks . . . . . . . . . . . . . . . . .    39
  123.  
  124.    Swap Files for CacheAll . . . . . . . . . . . . . . . . . . . . . . .    41
  125.  
  126.    Removing the swap file from your hard drive . . . . . . . . . . . . .    43
  127.  
  128.    Maximizing CacheAll's Performance . . . . . . . . . . . . . . . . . .    44
  129.  
  130.    What CacheAll will not do . . . . . . . . . . . . . . . . . . . . . .    45
  131.  
  132.    CacheAll's Automatic Settings . . . . . . . . . . . . . . . . . . . .    46
  133.  
  134.    Common Problems . . . . . . . . . . . . . . . . . . . . . . . . . . .    47
  135.  
  136.    Common Questions  . . . . . . . . . . . . . . . . . . . . . . . . . .    50
  137.  
  138.    Notes to CD-ROM Users . . . . . . . . . . . . . . . . . . . . . . . .    51
  139.  
  140.    Notes to Network Users  . . . . . . . . . . . . . . . . . . . . . . .    52
  141.  
  142.    FileTest(tm) -- A simplistic cache benchmarking program . . . . . . .    55
  143.  
  144.    AppTrack(TM) Makes Software audits a nuisance rather than a concern .    57
  145.  
  146.    Reseller Qualification Form: C&D Welcomes Resellers!  . . . . . . . .    58
  147.  
  148.  
  149.    CacheAll Evaluation Manual                                          Page 1 
  150.    --------------------------------------------------------------------------
  151.  
  152.  
  153.                  About CacheAll(tm), The Cache of the 90's!(tm),
  154.  
  155.         CacheAll is the only technology-independent cache program ever that
  156.    can speed up file access over 1000%! CacheAll is only 21 Kilobytes in size
  157.    and may be loaded high! CacheAll's advanced abilities don't stop there:
  158.    CacheAll is the only cache on the market that does all this -
  159.  
  160.    1) CacheAll has no limit to the types of devices it can cache,
  161.            ∙ Caches CD-ROMs & networked CD-ROMs
  162.            ∙ Caches Opticals & networked Opticals
  163.            ∙ Caches Hard Drives & networked Hard Drives
  164.            ∙ Caches Etc.! & networked Etc.!
  165.  
  166.    2) CacheAll uses RAM and an optional SWAP FILE for cache data storage
  167.            ∙ Supports cache sizes up to 64 Megabytes
  168.            ∙ SWAP FILE allows emulation and conservation of expensive RAM
  169.              and,
  170.            ∙ Can specify how devices are cached: RAM or SWAP FILE
  171.                 - Balances cache performance across slow and fast devices
  172.                 - Reduces server loading and network traffic
  173.  
  174.    3) CacheAll speeds up Microsoft Windows & multimedia,
  175.            ∙ CD-ROM applications fly
  176.            ∙ And networks too!
  177.  
  178.    4) CacheAll Increases Network performance when run on WORKSTATIONS **
  179.            ∙ 64 Megs of server data can be cached locally at workstation
  180.                 - Reduces network traffic
  181.                 - Reduces server loading
  182.            ∙ Artisoft(TM) LANtastic(TM) Compatible
  183.  
  184.    5) CacheAll allows you to cache specific sections of a resource
  185.            ∙ Cache data YOU want to cache, rather than entire device
  186.            ∙ Can eliminate the need for cache-locking
  187.  
  188.    6) CacheAll includes CUtil
  189.            ∙ DOS & Windows cache control
  190.            ∙ Provides real time viewing of files currently in cache
  191.                -  Excellent "tweaking" & management tool
  192.                -  And, of course, this feature works for network drives
  193.            ∙ View statistics, reset statistics, and more
  194.  
  195.    7) CacheAll can reconfigure itself automatically
  196.            ∙ CacheAll can optimize it's own parameters on startup
  197.            ∙ CacheAll is user friendly for beginners yet flexible for experts
  198.  
  199.         CacheAll provides all these features for only $79.
  200.  
  201.    ** FOR NETWORK DATA BASE USERS ONLY -- To prevent potential loss of your
  202.    data, CacheAll will not cache shared data files which are simultaneously
  203.    updated by multiple users across a network UNLESS you set these files to
  204.    read only status.
  205.  
  206.  
  207.    CacheAll Evaluation Manual                                          Page 2 
  208.    --------------------------------------------------------------------------
  209.  
  210.  
  211.                     About The Evaluation Version of CacheAll
  212.  
  213.         This evaluation version is only limited in three ways.  First, is
  214.    that it expires after November 1993.  Secondly, it will only run for 60
  215.    minutes before automatically disabling itself (which will be indicated by
  216.    a multi-tone beep). CUtil will report CacheAll as disabled when this
  217.    situation occurs.  Note: changing the system date or clock will not bypass
  218.    the time limitations. Lastly, while the commercial version fully supports
  219.    unloading CacheAll from memory, the evaluation may only be unloaded by
  220.    rebooting your computer.
  221.  
  222.         Because CacheAll uses new caching techniques, many cache benchmarking
  223.    programs DO NOT accurately detect the presence of CacheAll (primarily
  224.    because they do not access data the way that your applications do) and
  225.    therefore erroneously report no performance increase! This is simple to
  226.    prove: simply run {your application} without CacheAll and time with a
  227.    stopwatch, then install CacheAll and run {your application} again TWICE
  228.    measuring the time each time. Note that the last time {your application}
  229.    was run it took considerably less time because of CacheAll!
  230.  
  231.                               How to Order CacheAll
  232.  
  233.         This abbreviated manual covers only basic CacheAll and CUtil
  234.    operation. This manual is for your evaluation of CacheAll and CUtil,
  235.    should you continue to use CacheAll or CUtil you are required to purchase
  236.    the commercial version of CacheAll:
  237.  
  238.    If you are an ENDUSER: To purchase C&D products including CacheAll,
  239.  
  240.       - Visit your favorite software store or computer retailer
  241.       - Call C&D Programming Corp. @ 800-847-5676 (outside U.S. 801-582-0503)
  242.       - CacheAll's price is only $79.
  243.       - NOTE: Sending in your registration form FROM THIS EVALUATION SOFTWARE
  244.         will make you eligible for future upgrade discounts!
  245.       - Please send your registration form to the address noted on the form. 
  246.  
  247.    If you are a RESELLER: To purchase C&D products including CacheAll,
  248.  
  249.         Please mail the completed qualification form which appears at the end
  250.    of this document to the noted address, or fax to 801-581-0883.  After we
  251.    receive your properly completed qualification form we will send you a
  252.    reseller package which includes information necessary to order all C&D
  253.    products.
  254.  
  255.                  NO RESELLER INFORMATION WILL BE GIVEN UNTIL WE
  256.                 RECEIVE A PROPERLY COMPLETED FORM, NO EXCEPTIONS!
  257.  
  258.  
  259.    CacheAll Evaluation Manual                                          Page 3 
  260.    --------------------------------------------------------------------------
  261.  
  262.  
  263.                    What do you get when you purchase CacheAll?
  264.  
  265.    1) The commercial software,
  266.              ∙ Which is not time limited.
  267.              ∙ Does not disable itself after 60 minutes usage.
  268.              ∙ Allows you to unload CacheAll from memory as desired.
  269.  
  270.    2) The commercial software provides:
  271.  
  272.         for everyone,
  273.  
  274.              ∙ 2 color, 124 page manual
  275.              ∙ Spiral Bound! (lays flat on a table, desk, etc.)
  276.              ∙ Easy to read
  277.              ∙ Organized layout
  278.                   - 12 sections
  279.                   - Dictionary like tab bleeds => easy to find desired
  280.                     sections
  281.                   - Fully indexed
  282.                   - Table of contents inside at beginning as you are learning
  283.                   - Quick reference inside back cover for experienced users
  284.              ∙ Glossary of terms
  285.  
  286.         for experienced computer users,
  287.  
  288.              ∙ Details of CacheAll and CUtil operation 
  289.              ∙ Performance tips
  290.                   - For options settings
  291.                   - For specific computer configurations
  292.                   - Importance of specific options and settings
  293.              ∙ Glossary of terms
  294.  
  295.    3) Update notices and discounts on future releases
  296.  
  297.  
  298.    CacheAll Evaluation Manual                                          Page 4 
  299.    --------------------------------------------------------------------------
  300.  
  301.  
  302.                       Technical Support -- How to reach us
  303.  
  304.         Note that after the evaluation period a valid registration/serial
  305.    number will be required for all technical support regarding CacheAll! C&D
  306.    Programming Corp. will provide product support to unregistered users only
  307.    during the evaluation period. Please be prepared to give:
  308.  
  309.         ∙ The contents of your AUTOEXEC.BAT and CONFIG.SYS
  310.         ∙ A description of your computer including,
  311.              - CPU type and speed
  312.              - Optical drive type and speed
  313.              - CD-ROM type and speed
  314.              - Hard drive type and size
  315.              - Network type and version numbers
  316.              - Type and manufacturer of cards (VGA, etc.)
  317.  
  318.    to the technician before contacting C&D and include this information with
  319.    all correspondence. You may contact any one of the following sources for
  320.    technical support:
  321.  
  322.         This Document: Try reading through this manual
  323.  
  324.         BBS:      (516) 434-8712 for the latest technical tips and the latest
  325.                   versions of utilities, such as CacheAll's CUtil.
  326.                   Modem setup is: 8 data bits, no parity & 1 stop bit
  327.                   Modem speed is: 9600 baud, 38400 with compression
  328.  
  329.         Phone:    VOICE:    (516) 434-3214
  330.                   FAX:      (516) 434-7603
  331.                   FAXes -- Please remember to include YOUR FAX number!
  332.  
  333.         Postal:   C&D Programming
  334.                   Technical Support (CAEVAL1.0H)
  335.                   PO Box 1305
  336.                   Brentwood, NY 11717
  337.  
  338.  
  339.    CacheAll Evaluation Manual                                          Page 5 
  340.    --------------------------------------------------------------------------
  341.  
  342.  
  343.                                Welcome to CacheAll
  344.  
  345.         CacheAll instantly speeds up access to all of your personal
  346.    computer's data. CacheAll, unlike any other cache software available, is a
  347.    technology-independent cache which means it can speed up virtually all
  348.    storage devices! CacheAll can even extend laptop and notebook battery life
  349.    by reducing storage drive usage! CacheAll's advanced features don't stop
  350.    there ... it also automatically detects and efficiently responds to the
  351.    presence of storage devices. Just install CacheAll and without further
  352.    work, sit back and enjoy faster computing!
  353.  
  354.         When speed is important CacheAll's 1000%+ speed increase also saves
  355.    you money by avoiding costly and difficult upgrades of network drives, CD-
  356.    ROM drives, Optical drives, Bernoulli disks, and Hard drives, assuming an
  357.    upgrade is even available!
  358.  
  359.         Installed on all network workstations and non-dedicated servers,
  360.    CacheAll can dramatically reduce network traffic and server loading.
  361.    CacheAll accomplishes this by locally caching as much as 64 Megabytes of
  362.    data (Using RAM AND a SWAP FILE!) at the workstation -- after the first
  363.    read, workstations obtain data from CacheAll's local copy instead of
  364.    having to use the network.
  365.  
  366.         CacheAll operates in the background making fast copies of your data
  367.    in RAM (and an optional SWAP FILE) as you are using your personal
  368.    computer. Thereafter CacheAll immediately provides this copied data and
  369.    eliminates the long access times of CD-ROMs, opticals, networks, etc.
  370.    Using this technique, CacheAll makes your storage devices appear as if
  371.    they have been replaced with faster more expensive models, assuming a
  372.    faster model even exists!
  373.  
  374.       Congratulations on purchasing CacheAll -- The Cache of the 90's!(TM)
  375.  
  376.  
  377.    CacheAll Evaluation Manual                                          Page 6 
  378.    --------------------------------------------------------------------------
  379.  
  380.  
  381.                            Before Installing CacheAll
  382.  
  383.    Please take the following steps before installing CacheAll:
  384.  
  385.       - Please refer to the section entitled "Application Compatibility for
  386.         CacheAll" for important information regarding the use of CacheAll
  387.         with other applications.
  388.  
  389.       - Have a stamped envelope handy and your printer ready to print so that
  390.         you can immediately print and return the Registration Information
  391.         form. Returning this form entitles you to receive:
  392.  
  393.              ∙ Future upgrade discounts
  394.              ∙ New product announcements
  395.  
  396.                                System Requirements
  397.  
  398.    Installation Program
  399.       - IBM AT, PS/2, or 100% compatible computer
  400.       - 300Kb of conventional memory during installation
  401.       - MS-DOS versions 3.3 or later; or DR DOS 5.0 or later
  402.  
  403.    CacheAll and CUtil for DOS
  404.       - Minimum CONFIG.SYS settings of
  405.                 ∙ FILES = 40
  406.                 ∙ BUFFERS = 30
  407.       - IBM AT, PS/2, or 100% compatible computer
  408.       - MS-DOS versions 3.3 or later; or DR DOS 5.0 or 6.0
  409.       - When CacheAll is used to cache fast storage devices, such as a hard
  410.         drive:
  411.                 ∙ 512Kb (minimum) of extended, EMS or XMS allocated to
  412.                   CacheAll
  413.                 ∙ 300Kb free hard drive space
  414.       - When CacheAll is used to cache slow storage devices, such as CD-ROMs:
  415.                 ∙ 1Mb (minimum) of Extended Memory allocated to CacheAll
  416.                 ∙ 4.2Mb of free hard drive space, 300Kb for CacheAll program
  417.                   files plus 4Mb for the suggested (optional) swap file
  418.                      - Conventional RAM usage: 22Kb when loaded high using a
  419.                        memory manager with EMS; 52Kb to 57Kb when loaded high
  420.                        using a memory manager without EMS; 52 to 150Kb
  421.                        without a memory manager (depending on configuration)
  422.  
  423.    CUtil for Windows
  424.       - IBM AT, PS/2, or 100% compatible compute
  425.       - Approximately 200Kb of memory while executing
  426.       - MS-DOS versions 3.3 or later; DR DOS 5.0 or 6.0
  427.       - Microsoft Windows Version 3.0+
  428.  
  429.  
  430.    CacheAll Evaluation Manual                                          Page 7 
  431.    --------------------------------------------------------------------------
  432.  
  433.  
  434.                      Application Compatibility for CacheAll
  435.  
  436.    Microsoft Windows 3.x
  437.         When using CacheAll with Windows, you must load CacheAll before
  438.         starting Windows. If CacheAll is not loaded first, unpredictable
  439.         results may occur. If you are using Windows 3.0, you must also add
  440.         the line InDosPolling=1 to the [386Enh] section of the SYSTEM.INI
  441.         file. Please refer to your Microsoft Windows documentation for the
  442.         procedures to change the SYSTEM.INI file.
  443.     
  444.    Quarterdeck DESQview
  445.         CacheAll must be loaded before DESQview, not under a DESQview task.
  446.         Loading CacheAll in a task may cause unpredictable results.
  447.     
  448.    Artisoft LANtastic
  449.         When loading CacheAll on a LANtastic network, you must load CacheAll
  450.         after all network components; this includes REDIR and SERVER. Loading
  451.         CacheAll before the SERVER may cause unpredictable results.
  452.     
  453.    Novell Netware
  454.         When loading CacheAll on a Netware network, you must load CacheAll
  455.         after the NET component. Loading CacheAll before the NET component
  456.         may cause unpredictable results.
  457.     
  458.    Other networks
  459.         When loading CacheAll on a network, you should load it after all
  460.         network components. Loading CacheAll before the network components
  461.         may cause unpredictable results.
  462.  
  463.    Street Atlas USA Version 1.0
  464.         Street Atlas USA has a single very large file called WEST.DAT. To
  465.         take full advantage of CacheAll, BLOCKSIZE must be greater than 7. If
  466.         BLOCKSIZE is not greater than 7 only part of WEST.DAT will be cached.
  467.  
  468.    Disk compression programs
  469.         When using disk compression programs, be sure not to place the swap
  470.         file (specified with the DISKPATH option; see CacheAll options
  471.         section for full details of the DISKPATH option) on a compressed
  472.         volume. If you do put the swap file on a compressed volume,
  473.         unpredictable results may occur. Remember: the effective swap file
  474.         size will change and possibly overflow the volume of a compressed
  475.         drive. For this reason placing any swap file, such as Microsoft's
  476.         Windows swap file, on a compressed should be avoided!
  477.  
  478.    SCSI Drives
  479.         CacheAll does not support double buffering. If you own a SCSI drive
  480.         which requires double buffering, you must run double buffering
  481.         software with CacheAll.
  482.  
  483.    Silver Platter and other CD-ROM based retrieval systems
  484.         To cache CD-ROMs with CacheAll your software may need to be set for
  485.         networks regardless if CD-ROM is local. Use CUtil's LIST command to
  486.         determine if CacheAll requires this configuration change.  If very
  487.  
  488.  
  489.    CacheAll Evaluation Manual                                          Page 8 
  490.    --------------------------------------------------------------------------
  491.  
  492.  
  493.         few or no files are listed with the CUtil LIST command, you should
  494.         try to have your retrieval system set up as if it is on a network.
  495.  
  496.  
  497.    CacheAll Evaluation Manual                                          Page 9 
  498.    --------------------------------------------------------------------------
  499.  
  500.  
  501.                               Software Installation
  502.  
  503.         This SECTION takes you step by step through the CacheAll installation
  504.    procedure. CacheAll's installation program is very easy to use since
  505.    CacheAll is a "smart" program which eliminates complicated installation
  506.    procedures:
  507.  
  508.         Each time your computer is restarted CacheAll analyzes your system
  509.         and reconfigures itself appropriately. This allows you to make future
  510.         changes to your system, including adding CD-ROMs and network drives
  511.         WITHOUT EVER HAVING TO MAKE ANY CHANGES TO CacheAll! Simply install
  512.         and enjoy CacheAll's increase of your systems performance!
  513.  
  514.         The install procedure consists of a series of display screens which
  515.    are described in the following text. If at any time during the
  516.    installation you are not sure how to answer, simply press ENTER to accept
  517.    the default selection.
  518.  
  519.                        Preparing Your System For CacheAll
  520.  
  521.         This section discusses a few tasks which are necessary before
  522.    installing CacheAll.
  523.  
  524.         It is good practice to backup all of your writable storage devices
  525.    whenever making a change to your system. CacheAll does not harm the
  526.    information contained on these devices but it is good practice to back
  527.    them up in any case. Please refer to your DOS manual for backup
  528.    instructions if you do not already have a method to backup your system.
  529.  
  530.         If you are currently using a DOS version earlier than DOS 3.3 then
  531.    you will have to upgrade in order to use CacheAll. If you are not using
  532.    DOS 5.0 or later and were thinking of upgrading then do so before
  533.    installing CacheAll to take advantage of the many benefits over previous
  534.    DOS versions, especially memory management facilities which CacheAll will
  535.    take full advantage of.
  536.  
  537.                                   About INSTALL
  538.  
  539.         The CacheAll installation program is designed to automatically
  540.    determine your hardware configuration. First it will attempt to determine
  541.    the type of video display you have. Whether you have a monochrome or color
  542.    display, it will automatically adjust to display the best view for that
  543.    particular type of video hardware.
  544.  
  545.         CacheAll's INSTALL program is "mousable", which means that if a mouse
  546.    is connected to your system, you can use it to make selections within the
  547.    dialog boxes. (If you wish to use your mouse and the mouse cursor does not
  548.    appear when INSTALL has started, it should look like a small square block
  549.    in the upper left hand corner, make sure your mouse driver is properly
  550.    loaded. Refer to the documentation for your mouse regarding the loading
  551.    procedure.) To make selections without the mouse you may move between the
  552.    offered selections by pressing Tab or Shift-Tab followed by the ENTER key.
  553.    You may also use the "hot keys" which are described in the following text.
  554.  
  555.  
  556.    CacheAll Evaluation Manual                                         Page 10 
  557.    --------------------------------------------------------------------------
  558.  
  559.  
  560.         You must have at least 200Kb of conventional memory available before
  561.    running the CacheAll installation program.
  562.  
  563.                                 Starting INSTALL
  564.  
  565.    Some notes before starting:
  566.  
  567.       - We assume you are installing CacheAll from your A: drive. If you
  568.         choose to install from another drive simply replace all the following
  569.         references to A: with the proper reference for the drive you are
  570.         using, such as B:.
  571.  
  572.       - When you see the text ENTER it means to press the Enter key. At any
  573.         time during the installation, the Esc or Escape key will abort the
  574.         installation and return you to the DOS prompt.
  575.  
  576.       - INSTALL will present you with a sequence of "dialog boxes" which
  577.         allow you to enter necessary information and, make choices as to how
  578.         you wish to proceed to the next dialog box. To move between the
  579.         selections offered by each dialog box you may press Tab or Shift-Tab.
  580.         Press ENTER to accept a selection.
  581.  
  582.       - To begin the installation of CacheAll, create an installation
  583.         diskette by placing the evaluation software onto a floppy disk and do
  584.         the following:
  585.  
  586.           1. Put the installation disk into your A: drive.
  587.           2. Type:  A: ENTER
  588.              This will change your default disk drive to the A: drive.
  589.           3. Type:  INSTALL ENTER
  590.              This will execute the installation program for CacheAll
  591.  
  592.         After you complete step 3, it will take a few moments to start the
  593.    installation program. 
  594.  
  595.         At this point, you will enter the directory into which you want to
  596.    install the CacheAll files. If you want to accept the default directory of
  597.    C:\CACHEALL, simply press ENTER. If you want a different directory, enter
  598.    it now and press ENTER.
  599.  
  600.         If the directory you entered does not exist, you will be prompted
  601.    with a dialog box. Note that in some cases it may be necessary to create
  602.    the directory BEFORE running the installation software, although this
  603.    situation is very rare.
  604.  
  605.         If the directory specified in this dialog box is correct, press the
  606.    ENTER key or press the Y key. If the directory specified in this dialog
  607.    box is not correct, press the N key. When you press the N key, the
  608.    installation program will return you to the screen which asks for the
  609.    installation directory. This will give you another chance to select the
  610.    directory to install CacheAll into.
  611.  
  612.  
  613.    CacheAll Evaluation Manual                                         Page 11 
  614.    --------------------------------------------------------------------------
  615.  
  616.  
  617.         After the installation program creates the selected directory, you
  618.    will be asked if your computer is a standalone computer or is connected to
  619.    a network. If your computer IS NOT connected to a network press Y, press N
  620.    if this computer is connected to a network. Be sure to select YES if you
  621.    are not certain how to answer! 
  622.  
  623.         After selecting the installation type, INSTALL will display the
  624.    Registration Information dialog box. At this point you should be sure your
  625.    printer is turned on. (If you do not have a printer, you may save this
  626.    information in a file that can be printed later).
  627.  
  628.         To move between the fields, use Tab to move to the next field and the
  629.    Shift-Tab key to move to the previous field. You must complete all
  630.    requested information (name, company, address 1, address 2, city, state,
  631.    zip, phone, fax). If you do not have a company name or a fax number, you
  632.    may leave those entries blank.
  633.  
  634.         Once you have completed all fields, you have three choices. You can:
  635.           1. Print out the registration form.
  636.              Press Alt-P (hold down the Alt key and press the letter P).
  637.           2. Save the registration form to disk and print later.
  638.              Press Alt-S (hold down the Alt key and press the letter S). This
  639.              will save the registration information to the file CACHEALL.REG
  640.              in the directory you specified on the first screen of the
  641.              installation program.
  642.           3. Cancel the installation and return to DOS.
  643.              Press Alt-C (hold down the Alt key and press the letter C).  
  644.  
  645.         If you elect to print the registration form now, you will see a
  646.    dialog box which allows you to select the printer port to print the
  647.    registration form to.
  648.  
  649.         To select the printer port, use the up and down arrow keys until
  650.    desired printer port is highlighted. If your printer is installed on LPT1:
  651.    (printer port number 1), you can just press Alt-P or ENTER and the
  652.    registration form will be printed. To make "last minute" changes to your
  653.    registration information, you may return to that screen by pressing Alt-C.
  654.  
  655.    Seal the registration form in an envelope and mail to:
  656.  
  657.                        C&D Programming Corp.
  658.                        User Registration (CA10EVAL)
  659.                        P.O. Box 1305
  660.                        Brentwood, NY 11717
  661.  
  662.         Do this right away or, FAX it to us at (516)434-7603 right away!
  663.  
  664.         While sending the registration form to C&D, the installation program
  665.    will be copying the CacheAll program files to the directory you specified.
  666.    While the files are being copied you will see a status screen which shows
  667.    you how far the installation process has proceeded.
  668.  
  669.  
  670.    CacheAll Evaluation Manual                                         Page 12 
  671.    --------------------------------------------------------------------------
  672.  
  673.  
  674.         You must now decide if you want to update your AUTOEXEC.BAT file. 
  675.    Updating this file, by pressing ENTER, will cause CacheAll to
  676.    automatically start each time you turn your computer on. If you do not
  677.    update the file by pressing ALT-N, CacheAll must be started manually by
  678.    running the RUNCA.BAT file in the CacheAll directory (When starting
  679.    CacheAll manually be sure to do so AFTER all device drivers, redirectors
  680.    and network software is installed!).
  681.  
  682.         At this point, installation is almost complete. All that remains is
  683.    to review the README.TXT file which contains important information
  684.    regarding CacheAll. INSTALL displays this file for you and allows you to
  685.    scroll through the file by using the arrow keys. Should you wish to view
  686.    this information after the installation program ends, you can use the DOS
  687.    "TYPE", DOS "PRINT" command or the DOS 5.0 "EDIT" command.
  688.  
  689.         You have now completed the installation of CacheAll, The Cache of the
  690.    90's. By rebooting your computer you will experience the tremendous
  691.    benefits CacheAll provides!
  692.  
  693.  
  694.    CacheAll Evaluation Manual                                         Page 13 
  695.    --------------------------------------------------------------------------
  696.  
  697.  
  698.                           BEGINNERS: CacheAll is SMART!
  699.  
  700.         CacheAll is very user friendly to beginners. Since unlike other
  701.    programs CacheAll is capable of configuring itself, you just install and
  702.    enjoy it without doing any more work! CacheAll will even automatically
  703.    detect the installation of a new storage device, such as a CD-ROM, hard
  704.    drive, network drive, etc., without your changing CacheAll in any way!
  705.  
  706.         CacheAll is an especially powerful program which provides many
  707.    features not found in any other program. Because CacheAll is so powerful,
  708.    CacheAll automatically sets it's own options for novice users. When
  709.    changes are made to your system, by you or the programs you run, CacheAll
  710.    will detect these changes and reconfigure itself automatically so that you
  711.    don't have to!
  712.  
  713.         More advanced users should note that you are always free to override
  714.    one or all of CacheAll's automatic features. Refer to the CacheAll Options
  715.    Section to find out how to make these changes.
  716.  
  717.  
  718.    CacheAll Evaluation Manual                                         Page 14 
  719.    --------------------------------------------------------------------------
  720.  
  721.  
  722.                                 Running CacheAll
  723.  
  724.         The installation program will create a batch file called RUNCA.BAT in
  725.    the directory specified during the installation procedure. This batch file
  726.    contains all the information necessary to run CacheAll and will be called
  727.    by your AUTOEXEC.BAT file (unless you told the installation program not to
  728.    modify your AUTOEXEC.BAT file).
  729.  
  730.         While customizing certain parameter values for your particular system
  731.    can sometimes lead to increased performance, the average user should find
  732.    the automatic settings to be quite acceptable.
  733.  
  734.         Note that, depending on how you installed CacheAll RUNCA.BAT will use
  735.    STDALONE.OPT (for standalone installations) or NETWORK.OPT (for network
  736.    installations). When infrequently using a network you may wish to consider
  737.    using a batch file to switch back and forth between the appropriate OPT
  738.    file.
  739.  
  740.         The section titled CacheAll Options describes all the available
  741.    parameters of CacheAll. Again, it is not necessary to use these parameters
  742.    unless you would like to fine tune the performance of CacheAll.
  743.  
  744.             Unloading CacheAll (Not available in evaluation version)
  745.  
  746.         CacheAll can be unloaded from memory by running the CACHEALL.EXE
  747.    program with the parameter UNLOAD (or the abbreviation U). To do this you
  748.    must make sure you are in the subdirectory which contains CacheAll. For
  749.    this reason, you may want to consider adding CacheAll to your PATH. For
  750.    example, if you specify the command:
  751.  
  752.              C:\CACHEALL\CACHEALL UNLOAD
  753.  
  754.    from the DOS command line, CacheAll will unload itself from memory. Note
  755.    that if CacheAll is not the last program loaded into memory, CacheAll will
  756.    be deactivated but will remain in your system's memory until your computer
  757.    is turned off or rebooted.
  758.  
  759.  
  760.    CacheAll Evaluation Manual                                         Page 15 
  761.    --------------------------------------------------------------------------
  762.  
  763.  
  764.                                 CacheAll Options
  765.  
  766.         Spaces are not allowed, except between options. Equal signs or colons
  767.    are valid as keyword/value separators.  Example valid command lines are:
  768.  
  769.              CACHEALL MEMSIZE=8192 BLOCKSIZE:4 VERBOSE
  770.              CACHEALL MS:8192 BS=4 V
  771.  
  772.    These lines are identical in CacheAll and signify a memory size of 8192Kb
  773.    (MEMSIZE=8192 or MS=8192) and a block size of 4096 bytes (BLOCKSIZE=4 or
  774.    BS=4). It will also show all CacheAll settings upon startup (VERBOSE or
  775.    V).
  776.    NOTE: Numeric parameters always signify kilobytes.
  777.  
  778.              CACHEALL MEMSIZE=4000 BLOCKSIZE:4 DISKSIZE:5000
  779.              CACHEALL MS=4000 BS:4 DS=5000
  780.  
  781.    These lines are identical in CacheAll and signify a memory size of 4000Kb
  782.    (MEMSIZE=4000 or MS=4000), a disk size of 5000Kb (DISKSIZE=5000 or
  783.    DS=5000) and a block size of 4096 bytes (BLOCKSIZE=4 or BS=4).
  784.    NOTE: Numeric parameters always signify kilobytes.
  785.  
  786.         Options which have a value after the equal sign must not include
  787.    spaces around the equal sign. Adjacent options must have at least once
  788.    space separating them.
  789.  
  790.         You can create an option file to store your most commonly used
  791.    parameters. See the section titled Creating a CacheAll Option File for
  792.    full details.
  793.  
  794.         The next several pages detail each of CacheAll's command line
  795.    options. Each page consists of the option name in large bold characters
  796.    followed by a series of sections describing the option.
  797.  
  798.  
  799.    CacheAll Evaluation Manual                                         Page 16 
  800.    --------------------------------------------------------------------------
  801.  
  802.  
  803.    ALLFILES
  804.                    ** USE THIS OPTION WITH EXTREME CAUTION! **
  805.         Shortcut: AF
  806.  
  807.         Example:  ALLFILES=C-ER
  808.                   This will tell CacheAll to cache all files on drives C
  809.                   through E (C,D,E), and R.
  810.  
  811.         Default:  CacheAll automatically sets this option for all local
  812.                   CD-ROM drives.
  813.  
  814.         Details:  If this option is set on a networked drive, loss of data
  815.                   can occur on that drive! Example: Using 2 networked
  816.                   personal computers as an example, if PC 1 reads some part
  817.                   of a file (which then becomes cache data in CacheAll) just
  818.                   before PC 2 writes to the same file, CacheAll's cache data
  819.                   on PC 1 does not reflect the file changes made by PC 2!
  820.  
  821.         Notes:    It may be necessary to manually set this option when using
  822.                   CD-ROMs over a network.
  823.  
  824.    BLOCKSIZE
  825.         Shortcut: BS
  826.  
  827.         Example:  BLOCKSIZE=4
  828.                   This will tell CacheAll to use a 4Kbytes block size for
  829.                   managing its internal cache.
  830.  
  831.         Default:  Automatically chosen to minimize overall memory usage.
  832.  
  833.         Notes:    Setting BLOCKSIZE to it's maximum value of 16 WILL NOT
  834.                   necessarily give maximum CacheAll performance! To tweak
  835.                   this option, slowly raise and lower BLOCKSIZE setting until
  836.                   maximum performance is achieved.
  837.  
  838.  
  839.    DISKPATH
  840.         Shortcut: DP
  841.  
  842.         Example:  DISKPATH=D:\TEMP
  843.                   This will tell CacheAll that you want the disk cache swap
  844.                   file to be stored in the TEMP directory on the D drive.
  845.  
  846.         Default:  C:\ is the default path.
  847.  
  848.         Details:  Place the swap file on a local hard drive and avoid
  849.                   compressed disks (such as a Stacker volume) and network
  850.                   drives since loss of data may result.
  851.  
  852.  
  853.    CacheAll Evaluation Manual                                         Page 17 
  854.    --------------------------------------------------------------------------
  855.  
  856.  
  857.    DISKSIZE
  858.         Shortcut: DS
  859.  
  860.         Example:  DISKSIZE=6000
  861.                   This will tell CacheAll to use 6000 Kilobytes (Kb)  (6
  862.                   Megabytes) for its swap file.
  863.  
  864.         Default:  Automatically chosen based on free disk space -- equal to
  865.                   50% of free disk space up to 4 Megabytes.
  866.  
  867.         Choices:  Any number from 0 through 64000.
  868.  
  869.         Notes:    MEMSIZE + DISKSIZE can not exceed 64 Megabytes.
  870.  
  871.    DRIVES
  872.         Shortcut: D
  873.  
  874.         Example:  DRIVES=FN-PR-T
  875.                   This will tell CacheAll to cache only drives F, N through P
  876.                   (N,O,P) and R through T (R,S,T).
  877.  
  878.         Default:  All non-removable drives found in your system are cached
  879.                   (as determined at startup of CacheAll).
  880.  
  881.         Choices:  Any drive letters from A through Z.
  882.  
  883.         Details:  Even if you use one of the other drive selection options
  884.                   (ALLFILES or SLOW), you must still specify the drive letter
  885.                   using the DRIVES option. You can think of the DRIVES option
  886.                   as the "complete set of drives which CacheAll will cache."
  887.  
  888.         Notes:    Removable drives, such as floppies, will not be cached by
  889.                   CacheAll unless you specifically tell CacheAll to do so
  890.                   with the DRIVES option. CD-ROMs are not considered to be
  891.                   removable.
  892.  
  893.    HELP
  894.         Shortcut: H or ?
  895.  
  896.         Example:  HELP
  897.  
  898.         Details:  This option causes CacheAll to show the help screen listing
  899.                   all available CacheAll options.
  900.  
  901.  
  902.    CacheAll Evaluation Manual                                         Page 18 
  903.    --------------------------------------------------------------------------
  904.  
  905.  
  906.    MAXFILES
  907.         Shortcut: MF
  908.  
  909.         Example:  MAXFILES=200
  910.                   This tells CacheAll to keep cache information for a maximum
  911.                   of 200 files.
  912.  
  913.         Default:  This option varies depending on the cache sizes specified
  914.                   in MEMSIZE, DISKSIZE, and BLOCKSIZE.
  915.  
  916.         Choices:  Number must be equal to or greater than the number of FILES
  917.                   specified on the FILES= line in your CONFIG.SYS (we suggest
  918.                   setting FILES=30 and BUFFERS=10 if no such lines appear in
  919.                   your CONFIG.SYS). This option is allowed a maximum value of
  920.                   400 files.
  921.  
  922.    MEMSIZE
  923.         Shortcut: MS
  924.  
  925.         Example:  MEMSIZE=2048
  926.                   Tells CacheAll to use 2048 Kilobytes (Kb) or 2 Megabytes
  927.                   (Mb) for its memory cache.
  928.  
  929.         Default:  Automatic memory cache size is 50% of your available
  930.                   Extended, XMS or EMS. CacheAll will search in that order,
  931.                   and will take 50% of whichever memory it finds first.
  932.                   CacheAll may be forced to use a specific memory type using
  933.                   the MEMTYPE option.
  934.  
  935.         Choices:  Any number from 64 through 64000.
  936.  
  937.         Notes:    MEMSIZE + DISKSIZE can not exceed 64 Megabytes.
  938.  
  939.    MEMTYPE
  940.         Shortcut: MT
  941.  
  942.         Example:  MEMTYPE=EXT
  943.                   Tells CacheAll to use extended memory for the memory cache.
  944.  
  945.         Default:  CacheAll will search for all types of memory. It will
  946.                   search memory types in this order:
  947.                     1. extended
  948.                     2. XMS
  949.                     3. EMS
  950.                   The first memory type found will be used to satisfy the
  951.                   MEMSIZE setting.
  952.  
  953.         Choices:  The available choices are EXT, XMS and EMS.
  954.  
  955.         Details:  If you are not using a memory manager, such as QEMM or
  956.                   EMM386, you will be forced to use extended memory since no
  957.                   other memory type is available.
  958.  
  959.  
  960.    CacheAll Evaluation Manual                                         Page 19 
  961.    --------------------------------------------------------------------------
  962.  
  963.  
  964.    MPX
  965.         Shortcut: MPX
  966.  
  967.         Example:  MPX=C8
  968.                   This specifies a multiplex id of C8.
  969.  
  970.         Default:  CacheAll will search for the first available multiplex id
  971.                   starting from C0.
  972.  
  973.         Choices:  The valid choices are C0 through FF (it is specified as a
  974.                   hexadecimal number).
  975.  
  976.         Details:  Other applications, such as Microsoft Windows, use the
  977.                   multiplex id extensively and if a multiplex id conflict
  978.                   does occur, this is how you would change it.
  979.  
  980.    READAHEAD
  981.         Shortcut: RA
  982.  
  983.         Example:  RA=DF-H:5
  984.                   This specifies a readahead of 5 blocks for drives D:, F:,
  985.                   G:, and H:.
  986.  
  987.         Default:  CacheAll defaults all drives to a readahead of 0.
  988.  
  989.         Choices:  The valid readahead range is 0 through 99 blocks.
  990.  
  991.         Details:  The readahead value tells CacheAll how many additional
  992.                   blocks to read beyond a single read request (assuming this
  993.                   read's data is NOT currently within CacheAll's cache). This
  994.                   is particularly important for SLOW devices, especially in
  995.                   multitasking environment (such as BBSs). Each drive can
  996.                   have a different readahead value. To set multiple drives,
  997.                   you would specify multiple readahead statements on the
  998.                   Cacheall command line, such as the following:
  999.  
  1000.                        C:\CACHEALL\CACHEALL RA=D:5 RA=E-G:10
  1001.  
  1002.                   The above line would set a readahead value of 5 for drive
  1003.                   D: and a readahead value of 10 for E:, F:, and G:.
  1004.  
  1005.  
  1006.    CacheAll Evaluation Manual                                         Page 20 
  1007.    --------------------------------------------------------------------------
  1008.  
  1009.  
  1010.    SLOW
  1011.  
  1012.         Shortcut: S
  1013.  
  1014.         Example:  SLOW=ABF-LN-Z
  1015.                   This will tell CacheAll to use the swap file and memory to
  1016.                   cache drives A, B, F through L and, N through Z. All other
  1017.                   drives (specified using the DRIVES parameter) are to be
  1018.                   cached using memory only.
  1019.  
  1020.         Default:  All local CD-ROMs.
  1021.  
  1022.         Choice:   Any drive letters from A through Z.
  1023.  
  1024.         Details:  If you use this option, any drive letters you specify here
  1025.                   must be specified using the DRIVES parameter.
  1026.  
  1027.                   This option tells CacheAll which drives to cache using
  1028.                   memory and the swap file (versus using only memory).
  1029.                   Normally as CacheAll replaces old data in the memory cache
  1030.                   with new data, the old data is passed through to the swap
  1031.                   file (thus becoming "new data in the swap file, in other
  1032.                   words the swap file is the most recent collection of the
  1033.                   memory's old data). Properly setting SLOW helps avoid the
  1034.                   pointless situation of caching a hard drive to itself and
  1035.                   dedicates your swap file to slower (relative to the drive
  1036.                   upon which the swap file is placed) storage devices such as
  1037.                   CD-ROMs and network drives.
  1038.  
  1039.    SMALLFILES
  1040.         Shortcut: SF
  1041.  
  1042.         Example:  SMALLFILES=Y
  1043.  
  1044.         Default:  Y is the default for this option.  
  1045.  
  1046.         Choices:  The available choices are Y to have CacheAll cache all
  1047.                   small files or N to have CacheAll ignore all small files.
  1048.  
  1049.         Details:  If use have an application which opens many small files
  1050.                   only once (such as Norton Desktop for Windows or Microsoft
  1051.                   Windows), you might want to set SMALLFILES=N. CUtil's LIST
  1052.                   command can be used to determine if small files are
  1053.                   monopolizing the cache and so SMALLFILES should be set to
  1054.                   N.
  1055.  
  1056.  
  1057.    CacheAll Evaluation Manual                                         Page 21 
  1058.    --------------------------------------------------------------------------
  1059.  
  1060.  
  1061.    UNLOAD (**Not available in the evaluation version**)
  1062.         Shortcut: U
  1063.  
  1064.         Example:  UNLOAD
  1065.                   Tells CacheAll to remove itself from memory.
  1066.  
  1067.         Details:  This option is used to unload CacheAll from memory. If
  1068.                   CacheAll was not the last program loaded into memory, it
  1069.                   will be disabled but not removed from memory. In either
  1070.                   case, CacheAll will stop caching data.
  1071.  
  1072.    VERBOSE
  1073.         Shortcut: V
  1074.  
  1075.         Example:  VERBOSE
  1076.                   Tells CacheAll to report the value of all options after
  1077.                   startup.
  1078.  
  1079.         Default:  This option is turned off by default
  1080.  
  1081.         Details:  This option causes CacheAll to display all of the option
  1082.                   settings when it starts up.
  1083.  
  1084.    @
  1085.         Shortcut: There is no shortcut for this option since it is only one
  1086.                   character.
  1087.  
  1088.         Example:  @CACHEALL.OPT
  1089.                   This will tell CacheAll to read its options from the file
  1090.                   CACHEALL.OPT in the current directory.
  1091.  
  1092.         Details:  This option allows you to specify the filename of an option
  1093.                   file which will provide the desired options settings for
  1094.                   CacheAll instead of their being typed on the command line.
  1095.                   In some cases this option will be a convenience, in other
  1096.                   cases an option file must be created because the command
  1097.                   line will not provide enough space to enter all the
  1098.                   necessary options. For full details on creating an option
  1099.                   file, see the section titled Creating a CacheAll Option
  1100.                   File.
  1101.  
  1102.  
  1103.    CacheAll Evaluation Manual                                         Page 22 
  1104.    --------------------------------------------------------------------------
  1105.  
  1106.  
  1107.    ;
  1108.         Shortcut: There is no shortcut for this option since it is only one
  1109.                   character.
  1110.  
  1111.         Example:  ; This is a comment
  1112.                   The above represents a comment section of a line in an
  1113.                   option file.
  1114.  
  1115.         Default:  There is no default for this option.
  1116.  
  1117.         Details:  This option allows comments to be placed in your option
  1118.                   file. When processing an option file the semicolon and all
  1119.                   characters following it on a line are ignored. It is
  1120.                   acceptable to place comments on the same line as option
  1121.                   settings so long as the comments are placed after (to the
  1122.                   right of) the option setting on that line. For full details
  1123.                   on creating an option file, see the section titled Creating
  1124.                   a CacheAll Option File.
  1125.  
  1126.  
  1127.    CacheAll Evaluation Manual                                         Page 23 
  1128.    --------------------------------------------------------------------------
  1129.  
  1130.  
  1131.                               CacheAll Option File
  1132.  
  1133.         CacheAll allows the use of an option file to specify the settings of
  1134.    it's options. The option file is a DOS TEXT file which contains a list of
  1135.    option settings for the CacheAll program. The CacheAll option file makes
  1136.    it easy to maintain a list of custom parameters. These files can be
  1137.    created with any text file editor such as DOS's EDLIN or EDIT (for DOS
  1138.    5.0+ users). The following is a sample option file: 
  1139.  
  1140.              ; Sample CacheAll Option file
  1141.              DRIVES=A-Z
  1142.              SLOW=D
  1143.              AF=R      ; This option tells CacheAll to cache ALL files on R:
  1144.              MS=4000   ; This option tells CacheAll to use 4000Kb for the
  1145.                        ; cache.
  1146.              DS=8000
  1147.              ; The below option tells CacheAll to display complete startup
  1148.              ; info
  1149.              VERBOSE
  1150.  
  1151.    Key points to notice in the example above: 
  1152.  
  1153.            - Comments may be used anywhere as long as a semi-colon is placed
  1154.              before the comment text.
  1155.            - Both full commands and abbreviations can be used 
  1156.            - Only one option may be specified per line.  If you specify more
  1157.              than one option per line, an error will result. 
  1158.  
  1159.    To use an option file, run CacheAll as follows:
  1160.  
  1161.                   CACHEALL @C:\CACHEALL\CACHEALL.OPT 
  1162.  
  1163.         This command line will load CacheAll with an option file called
  1164.    C:\CACHEALL\CACHEALL.OPT. The @ followed by a filename tells CacheAll to
  1165.    read all the options from that file.
  1166.  
  1167.  
  1168.    CacheAll Evaluation Manual                                         Page 24 
  1169.    --------------------------------------------------------------------------
  1170.  
  1171.  
  1172.                              CacheAll Error Messages
  1173.  
  1174.    BLOCKSIZE must be between 2-16.
  1175.         Reason:   Occurs when you specify a BLOCKSIZE outside the valid range
  1176.                   for BLOCKSIZE.
  1177.         Solution: Let CacheAll decide on the optimal BLOCKSIZE or choose a
  1178.                   value which is between 2 and 16, inclusive.
  1179.  
  1180.    CacheAll is already installed.
  1181.         Reason:   Occurs when you try to load CacheAll after CacheAll has
  1182.                   already been loaded. CacheAll will not load itself more
  1183.                   than once.
  1184.         Solution: If you want to reconfigure the parameters, use the UNLOAD
  1185.                   option to remove CacheAll from memory (the UNLOAD option
  1186.                   will release memory if CacheAll was the last
  1187.                   memory-resident program loaded, therefore remove other
  1188.                   programs before UNLOADing CacheAll) then "reload" (rerun)
  1189.                   CacheAll with the desired option settings.
  1190.         Notes:    Do not try to unload CacheAll from within Windows, a DOS
  1191.                   shell or other operating environment. Doing so may cause
  1192.                   your system to "hang".
  1193.  
  1194.    CacheAll is not installed!
  1195.         Reason:   Occurs when an error occurs during the startup of CacheAll.
  1196.         Solution: If you see this message, there are probably other error
  1197.                   messages shown. Refer to this section for details on the
  1198.                   other error messages. Once you fix the other errors this
  1199.                   error should disappear.
  1200.  
  1201.    Cache exceeds max allowable pages. Cache truncated. To use a larger cache
  1202.    increase the BLOCKSIZE.
  1203.         Reason:   Occurs when MEMSIZE and DISKSIZE are too large for the
  1204.                   specified BLOCKSIZE.
  1205.         Solution: Do not specify a BLOCKSIZE, let CacheAll automatically
  1206.                   choose a block size for acceptable values of MEMSIZE and
  1207.                   DISKSIZE values.
  1208.         Notes:    If you want to know complete details, refer to the
  1209.                   commercial CacheAll manual.
  1210.  
  1211.    Drive x is not valid
  1212.         Reason:   Occurs when swap file is placed on an invalid drive.
  1213.         Solution: Check the DISKPATH option to ensure the pathname specified
  1214.                   is valid.
  1215.  
  1216.  
  1217.    CacheAll Evaluation Manual                                         Page 25 
  1218.    --------------------------------------------------------------------------
  1219.  
  1220.  
  1221.    EMS driver is not responding. Tables will be in real memory.
  1222.         Reason:   Occurs when you ask CacheAll to use EMS memory and it
  1223.                   cannot find any EMS memory.
  1224.         Solution: To provide EMS memory, a memory manager such as QEMM or
  1225.                   EMM386 must be installed.
  1226.         Notes:    Lack of EMS memory will not affect CacheAll's operation but
  1227.                   additional conventional memory will be used. When using a
  1228.                   memory manager CacheAll will take as little at 22Kb of
  1229.                   conventional memory, and can be loaded high.
  1230.  
  1231.    Error (xxx) reading parameter file!
  1232.         Reason:   Occurs when CacheAll cannot read the option file specified
  1233.                   with the @ option. The xxx will be replaced by the DOS
  1234.                   error when CacheAll attempted to open and read the file.
  1235.                   The most common errors will be 2 (File not found) or 5
  1236.                   (Access denied).
  1237.         Solution: Check the filename specified for the option file to ensure
  1238.                   that it is valid and that CacheAll has exclusive access to
  1239.                   it (ie. be sure the file is not being used by another
  1240.                   network user).
  1241.  
  1242.    Error allocating cache pages.
  1243.         Solution: Contact C&D Programming's technical support staff.
  1244.  
  1245.    Error allocating file list.
  1246.         Solution: Contact C&D Programming's technical support staff.
  1247.  
  1248.    Error allocating EMS memory.
  1249.         Reason:   Occurs when CacheAll is told to use EMS memory but CacheAll
  1250.                   cannot find such memory.
  1251.         Solution: Try using another type of memory (by using the MEMTYPE
  1252.                   option) or ensure that a memory manager is properly loaded
  1253.                   and providing EMS memory.
  1254.  
  1255.    Error finding page frame.
  1256.         Solution: Contact C&D Programming's technical support staff.
  1257.  
  1258.    Incorrect DOS Version! Need DOS 3.30 or above.
  1259.         Reason:   Occurs when trying to run CacheAll using a version of DOS
  1260.                   before version 3.30.
  1261.         Solution: Upgrade to DOS 3.3 or higher.
  1262.  
  1263.    Invalid option 'xxx'
  1264.         Reason:   Occurs when an invalid option is specified on the command
  1265.                   line or in the option file.
  1266.         Solution: Check the command line parameters you have entered and try
  1267.                   running CacheAll again. When using an option file, be sure
  1268.                   all options within the file are valid and all comment lines
  1269.                   are prefixed with a semi-colon.
  1270.  
  1271.  
  1272.    CacheAll Evaluation Manual                                         Page 26 
  1273.    --------------------------------------------------------------------------
  1274.  
  1275.  
  1276.    Must have a MEMSIZE of at least 64.
  1277.         Reason:   Occurs when MEMSIZE is specified to be less than 64.
  1278.         Solution: Only use MEMSIZE settings from 64 to 64000 or let CacheAll
  1279.                   choose the MEMSIZE automatically.
  1280.  
  1281.    Multiplex Id xxx is already in use.
  1282.         Reason:   Occurs when the specified MPX is already in use.
  1283.         Solution: Let CacheAll choose the MPX value automatically. In most
  1284.                   cases CacheAll will choose an MPX which is available and
  1285.                   does not conflict with other software.
  1286.  
  1287.    Multiplex Id must be between C0-FF.
  1288.         Reason:   Occurs when a multiplex id (specified with the MPX option)
  1289.                   is outside the valid range of C0 through FF.
  1290.         Solution: Let CacheAll choose its own MPX or respecify the MPX
  1291.                   between the C0 through FF range, as a hexadecimal number.
  1292.  
  1293.    No available Multiplex Ids.
  1294.         Solution: Contact C&D Programming's technical support staff.
  1295.  
  1296.    No swap file!! Error (xxx)
  1297.         Reason:   Occurs when CacheAll cannot create a swap file.
  1298.         Solution: Be sure the pathname specified in the DISKPATH option is
  1299.                   valid and enough disk space is available for the value
  1300.                   specified in the DISKSIZE option.
  1301.  
  1302.    Out of Disk Space. Swap file has been disabled.
  1303.         Reason:   Occurs when CacheAll determines there is not enough disk
  1304.                   space to create a swap file.
  1305.         Solution: You should free some disk space for the swap file or
  1306.                   designate a smaller swap file with the DISKSIZE option.
  1307.  
  1308.    Out of Memory!! Error (xxx)
  1309.         Reason:   Occurs when CacheAll can not allocate enough memory to
  1310.                   satisfy the options specified.
  1311.         Solution: Free up some memory (extended, EMS, or XMS) and try running
  1312.                   CacheAll again. If possible add more memory to your
  1313.                   computer. If neither of these solutions work, lower the
  1314.                   value specified with MEMSIZE.
  1315.  
  1316.    Warning!!! swap file drive is not a local hard disk. This may result in
  1317.    slower response times.
  1318.         Reason:   This error message occurs when the DISKPATH option points
  1319.                   to a drive which is not local (such as a network drive).
  1320.         Solution: No change is necessary. This is only a warning message. If
  1321.                   you want to get the greatest performance from CacheAll, you
  1322.                   should put the swap file on the fastest storage device you
  1323.                   have available (usually your local hard drive).
  1324.  
  1325.    You may have a maximum of xxx files. Decreasing files.
  1326.         Reason:   Occurs when MAXFILES is specified to be greater than 400.
  1327.         Solution: Reduce MAXFILES setting to less than 400.
  1328.  
  1329.  
  1330.    CacheAll Evaluation Manual                                         Page 27 
  1331.    --------------------------------------------------------------------------
  1332.  
  1333.  
  1334.                              CUtil(TM) Introduction
  1335.  
  1336.         CUtil, which stands for CacheAll Utility, provides an interface to
  1337.    the CacheAll program. CUtil is used to view and control CacheAll's
  1338.    operation. CUtil provides the following:
  1339.  
  1340.         - Display of CacheAll statistics, such as Read Hit Rate, etc.
  1341.         - Resetting CacheAll statistics
  1342.         - Flushing CacheAll's cache
  1343.         - Display current CacheAll parameters
  1344.         - Modification of certain CacheAll parameters
  1345.         - Enabling and disabling the swap file
  1346.         - View which files CacheAll is caching and to what efficiency
  1347.  
  1348.         Just as we have made CacheAll easy to use by giving it the power to
  1349.    automatically examine your system and set it's own parameters, CUtil
  1350.    automatically detects whether it is run under DOS or Windows and provides
  1351.    a different operating mode for each. In the following section, the DOS and
  1352.    Windows modes of CUtil will be discussed.
  1353.  
  1354.  
  1355.    CacheAll Evaluation Manual                                         Page 28 
  1356.    --------------------------------------------------------------------------
  1357.  
  1358.  
  1359.                                   CUtil for DOS
  1360.  
  1361.    The DOS mode of CUtil has several command line parameters which are:
  1362.  
  1363.              FLUSH
  1364.                   Flushes specified drives from CacheAll's memory
  1365.  
  1366.              HELP
  1367.                   Displays a short help screen of the command line options
  1368.  
  1369.              LIST
  1370.                   Displays the list of files which are currently being cached
  1371.                   by CacheAll, and the hit rate for each file
  1372.  
  1373.              PARAMS
  1374.                   Displays the current parameters for CacheAll
  1375.  
  1376.              RESET
  1377.                   Resets the CacheAll's statistics
  1378.  
  1379.              STATS
  1380.                   Displays the current CacheAll statistics (this option is
  1381.                   assumed when no options are specified)
  1382.  
  1383.              SWAPFILE
  1384.                   Allows enabling or disabling of CacheAll's swap file
  1385.  
  1386.    Note that if no parameter is specified on the command line the STATS
  1387.    parameter is assumed.
  1388.  
  1389.  
  1390.    CacheAll Evaluation Manual                                         Page 29 
  1391.    --------------------------------------------------------------------------
  1392.  
  1393.  
  1394.                                   CUtil Options
  1395.  
  1396.         The next section describes all the options that CUtil supports. These
  1397.    command line options are valid only when CUtil is running in DOS mode. In
  1398.    Windows mode CUtil uses menus to implement the available options. Windows
  1399.    mode is documented in the section titled "CUtil for Windows." Unlike
  1400.    CacheAll, CUtil allows only one option on its command line. Some example
  1401.    command lines are:
  1402.  
  1403.              CUTIL FLUSH=D-G
  1404.              CUTIL F=D-G
  1405.  
  1406.         These lines are identical in CUtil. They tell CUtil to flush all
  1407.    cache data for drives D through G, (drives D:, E:, F:, G:).
  1408.  
  1409.              CUTIL PARAMS
  1410.              CUTIL P
  1411.  
  1412.         These lines are identical in CUtil. They tell CUtil to display the
  1413.    current value of CacheAll's options. Note that options which have a value
  1414.    after the equal sign must not include spaces around the equal sign. Note
  1415.    that if no option is specified on CUtil's command line then CUtil will
  1416.    assume the STATS option is desired.
  1417.  
  1418.         The next several pages detail each of CUtil's command line options.
  1419.    Each page consists of the option name in large bold characters followed by
  1420.    a series of sections describing the option.
  1421.  
  1422.  
  1423.    CacheAll Evaluation Manual                                         Page 30 
  1424.    --------------------------------------------------------------------------
  1425.  
  1426.  
  1427.    FLUSH
  1428.         Shortcut: F
  1429.  
  1430.         Example:  F=CE-G
  1431.                   This command will flush cache data originating from drives
  1432.                   C:, E:, F:, and G:.
  1433.  
  1434.         Choices:  Any drive letter from A through Z. To specify all drives a
  1435.                   wildcard of * is also allowed.
  1436.  
  1437.         Details:  To flush all cache data specify the command line as:
  1438.  
  1439.                     F  or  FLUSH
  1440.  
  1441.  
  1442.    HELP
  1443.         Shortcut: H or ?
  1444.  
  1445.         Example:  HELP
  1446.                   This command will display a short help screen which lists
  1447.                   all the commands CUtil supports.
  1448.  
  1449.    LIST
  1450.         Shortcut: L
  1451.  
  1452.         Example:  LIST
  1453.  
  1454.         Details:  This command will display the list of files which are
  1455.                   currently being cached by CacheAll along with the following
  1456.                   information for each file,
  1457.                     1) number of bytes read while file was in the cache
  1458.                     2) hit rate, percentage of requested bytes read from
  1459.                        cache.
  1460.                     3) size in bytes
  1461.                     4) filename (including complete path)
  1462.  
  1463.    PARAMS
  1464.  
  1465.         Shortcut: P
  1466.  
  1467.         Example:  PARAMS
  1468.                   This command will display the current value of CacheAll
  1469.                   options.
  1470.  
  1471.         Details:  All CacheAll command line options will be displayed.
  1472.         
  1473.  
  1474.  
  1475.    CacheAll Evaluation Manual                                         Page 31 
  1476.    --------------------------------------------------------------------------
  1477.  
  1478.  
  1479.    RESET
  1480.         Shortcut: R
  1481.  
  1482.         Example:  RESET
  1483.                   This command will reset the CacheAll's statistics.
  1484.  
  1485.         Details:  The statistics which are reset are Read Requests, Read
  1486.                   Hits, and Read Hit Rate.
  1487.  
  1488.    STATS
  1489.         Shortcut: S
  1490.  
  1491.         Example:  STATS
  1492.                   This command will show the current statistics for CacheAll.
  1493.  
  1494.         Details:  If you run CUtil for DOS without specifying any command
  1495.                   line options, the STATS option is assumed.
  1496.  
  1497.    SWAPFILE
  1498.         Shortcut: S
  1499.  
  1500.         Example:  SWAPFILE=E
  1501.                   This command will enable the swap file.
  1502.  
  1503.         Choices:  The available choices are E for enabling swap file and D
  1504.                   for disabling swap file.
  1505.  
  1506.         Details:  This option allows you to enable and disable the use of the
  1507.                   swap file "on the fly". Occasionally you might run into an
  1508.                   application which is time-critical, such as full motion
  1509.                   video. If time is taken to write data to the swap file,
  1510.                   your time-critical application might not work as desired.
  1511.                   In this case, you can leave CacheAll running, but disable
  1512.                   all the swap file activity. Another way to eliminate
  1513.                   possible undesirable effects is to be sure to place the
  1514.                   swap file on your fastest drive.
  1515.  
  1516.         Notes:    If a DISKSIZE of zero was specified on the CacheAll command
  1517.                   line, this option cannot be used.
  1518.  
  1519.  
  1520.    CacheAll Evaluation Manual                                         Page 32 
  1521.    --------------------------------------------------------------------------
  1522.  
  1523.  
  1524.                                 CUtil for Windows
  1525.  
  1526.         CUtil for Windows takes advantage of Microsoft Windows by providing
  1527.    graphical option settings and a "real-time" statistics display. With CUtil
  1528.    you can see CacheAll in action while you read and write to your cached
  1529.    drives! To add CUtil's icon to Windows, follow the steps below. These
  1530.    instruction assume the default directory settings were chosen during the
  1531.    installation procedure, if you didn't make this selection then you must
  1532.    specify the directory in which CacheAll is installed:
  1533.  
  1534.              - If you are in the Windows environment:
  1535.                     1) Activate the Program Manager window
  1536.                     2) Select the File menu.
  1537.                     3) Select the Run option.
  1538.                     4) Type:     C:\CACHEALL\MAKEGRP
  1539.                     5) Click on the OK button.
  1540.                     6) Once MAKEGRP starts, just follow the on-screen
  1541.                        prompts.
  1542.  
  1543.              - If you are not running Windows:
  1544.                     1) Execute the following command from the DOS prompt
  1545.                        while in your windows directory:
  1546.  
  1547.                             WIN C:\CACHEALL\MAKEGRP
  1548.  
  1549.                     2) Press ENTER
  1550.                     3) Once MAKEGRP starts, just follow the on-screen
  1551.                        prompts.
  1552.  
  1553.  
  1554.                            Executing CUtil for Windows
  1555.  
  1556.         When CUtil is executed under Windows the current CacheAll statistics
  1557.    will be displayed. Each field of this display gives important information
  1558.    about the current state of CacheAll. These fields are summarized below:
  1559.  
  1560.    - Memory Total
  1561.         The total cache memory CacheAll has allocated. This number is
  1562.         specified by the MEMSIZE option on the CacheAll command line. If you
  1563.         do not specify the option, CacheAll will automatically choose a
  1564.         value.
  1565.  
  1566.    - Memory Avail
  1567.         The amount of memory left for use by CacheAll. This number will
  1568.         always be less than or equal to Memory Total. The amount of memory in
  1569.         use would be Memory Total minus Memory Avail.
  1570.  
  1571.    - Disk Total
  1572.         The size of the swap file on your disk. This number is specified by
  1573.         the DISKSIZE option on the CacheAll command line. If you do not
  1574.         specify DISKSIZE, CacheAll will automatically choose a value.
  1575.  
  1576.  
  1577.    CacheAll Evaluation Manual                                         Page 33 
  1578.    --------------------------------------------------------------------------
  1579.  
  1580.  
  1581.    - Disk Avail
  1582.         The amount of swap file space left for use by CacheAll. This number
  1583.         will always be less than or equal to Disk Total. The amount of swap
  1584.         file space in use would be Disk Total minus Disk Avail.
  1585.  
  1586.    - File Total
  1587.         The maximum number of files CacheAll can manage at one time. This
  1588.         number is specified by the MAXFILES option on the CacheAll command
  1589.         line. If you do not specify the option, CacheAll will automatically
  1590.         choose a value.
  1591.  
  1592.    - File Avail
  1593.         The number of file slots available for use by CacheAll. If this
  1594.         number goes to zero (or close to zero) you may want to specify a
  1595.         larger value for the MAXFILES option to increase performance.
  1596.  
  1597.    - Read Requests
  1598.         Number of bytes which were read through CacheAll. This includes reads
  1599.         from all drives specified in the CacheAll DRIVES command line option.
  1600.         If you do not specify the DRIVES option, CacheAll will intelligently
  1601.         select which drives to cache.
  1602.  
  1603.    - Read Hits
  1604.         When some data is requested which is already stored in the cache
  1605.         memory, it is called a hit. The Read Hits value represents the number
  1606.         of bytes which were read from the data cached by CacheAll. The closer
  1607.         this value is to the Read Requests value, the more CacheAll is
  1608.         increasing your performance.
  1609.  
  1610.    - Read Hit Rate
  1611.         The percentage of read hits. This is simply the Read Hits divided by
  1612.         the Read Requests. The closer this value is to 100%, the more
  1613.         CacheAll is increasing your performance.
  1614.  
  1615.  
  1616.                            CUtil for Windows File Menu
  1617.  
  1618.    - Exit
  1619.         Exit is included for compatibility with all other Windows
  1620.         applications (and for those of you that are used to pressing Alt-F
  1621.         then X to exit a Windows program). Selecting Exit will cause the
  1622.         CUtil session to be closed, you may also use Alt-X to exit CUtil for
  1623.         Windows.
  1624.  
  1625.  
  1626.    CacheAll Evaluation Manual                                         Page 34 
  1627.    --------------------------------------------------------------------------
  1628.  
  1629.  
  1630.                          CUtil for Windows Options Menu
  1631.  
  1632.         The Options menu contains most of the "good stuff" which CUtil can
  1633.    do. Each option is discussed in detail on the following pages.
  1634.  
  1635.    - Select Drives to Flush...
  1636.         This option will show a dialog box with a check box for each drive. 
  1637.         You can select the drives you want to flush by clicking next to or on
  1638.         top of the desired drive letter. When you are through selecting
  1639.         drives, click on the "OK" button. If you decide not to flush any
  1640.         drives, press the "Cancel" button. If you want to clear all your
  1641.         drive selections, you can use the "Clear All" button. If you want to
  1642.         select all the drives, you can use the Select All button. If you want
  1643.         to flush all the drives, you should use the "Flush All Drives"
  1644.         option, since it is easier to select.
  1645.  
  1646.    - Flush All Drives
  1647.         Choosing Flush All Drives results in a conformation box. This option
  1648.         will flush all cache data from the cache but before doing so you will
  1649.         be asked if you really want to flush all data. If you click on the
  1650.         Yes button, all cache data will be flushed. If you click on the No
  1651.         button, you will return to CUtil with all cached data still in
  1652.         CacheAll.
  1653.  
  1654.    - Reset Statistics
  1655.         This option will reset the statistics which CUtil displays. This is
  1656.         useful if you want to see how much CacheAll improves the execution of
  1657.         a specific application. The information which is reset is the Read
  1658.         Requests, Read Hits, and Read Hit Rate.
  1659.  
  1660.    - Swap File Active
  1661.         The Swap File option will be in either of two states, active (on) or
  1662.         inactive (off). This option will either activate or deactivate the
  1663.         use of the swap file by CacheAll. If a small checkmark appears next
  1664.         to the menu option, that means the swap file is active, and when
  1665.         CacheAll decides data needs to be pushed from cache memory into the
  1666.         swap file, it will do so. If there is no checkmark next to the menu
  1667.         option, CacheAll will behave as if no swap file was defined.
  1668.  
  1669.         Why would you want to disable the swap file? If a swap file is being
  1670.         used by CacheAll, the drives specified by the SLOW option will be
  1671.         cached to the swap file. If you are also running a time sensitive
  1672.         application from one of these "slow" drives then the added delay of
  1673.         CacheAll writes to the swap file may be undesirable. Disabling the
  1674.         swap file will stop the added delay of the writes to the swap file.
  1675.         You may also wish to consider placing the swap file on a faster drive
  1676.         to reduce the delay instead of disabling the swap file.
  1677.  
  1678.  
  1679.    CacheAll Evaluation Manual                                         Page 35 
  1680.    --------------------------------------------------------------------------
  1681.  
  1682.  
  1683.    - Change Parameters
  1684.         This option allows you to change some of CacheAll's current settings.
  1685.         When you select this option, you will see a dialog box outlining each
  1686.         CacheAll option you can change and its current value.  Just select
  1687.         the option to want to modify and follow the prompts.
  1688.  
  1689.    - Show Parameters
  1690.         This option allows you to see, but not change, CacheAll's current
  1691.         settings. When you select this option, you will see a dialog box
  1692.         outlining each CacheAll option and its current value (Notice that
  1693.         each option displayed in this dialog box refers to an option used on
  1694.         the CacheAll command line).
  1695.  
  1696.         For the items which appear in the "Drive Selection" group box, you
  1697.         will notice buttons which say "Click here to view". When you click on
  1698.         one of these buttons a dialog box is displayed along with the
  1699.         currently selected drives for that option.
  1700.  
  1701.    - Show File List
  1702.         This command will display the list of files which are currently being
  1703.         cached by CacheAll along with the following information for each
  1704.         file,
  1705.              1)   number of bytes read while file was in the cache
  1706.              2)   hit rate, percentage of requested bytes read from cache.
  1707.              3)   size in bytes
  1708.              4)   filename (including complete path)
  1709.  
  1710.    - Refresh Rate
  1711.         This option allows you to change the update rate of CUtil's
  1712.         statistics display. The default rate is once every 5 seconds, and you
  1713.         may choose a value from 1 to 60 seconds.
  1714.  
  1715.  
  1716.                            CUtil for Windows Help Menu
  1717.  
  1718.    - About
  1719.         This box shows version and copyright information.
  1720.  
  1721.    - Product Support
  1722.         Choosing Product Support will show you information on how to get
  1723.         product support, including C&D Programming Corp.'s telephone number. 
  1724.         This dialog box will also show your serial number and the name you
  1725.         entered during the installation process.
  1726.  
  1727.  
  1728.    CacheAll Evaluation Manual                                         Page 36 
  1729.    --------------------------------------------------------------------------
  1730.  
  1731.  
  1732.                             Technical Specifications
  1733.  
  1734.                                    Benchmarks
  1735.  
  1736.         Tests 1 & 2 are network drive benchmarks using the industry standard
  1737.    PC Magazine LAN Labs Benchmark Version 3.03 with a one megabyte file size
  1738.    test (All numbers are megabits per second), 2 Meg RAM cache and 0 Meg swap
  1739.    file. Although not included, similar performance increases from local hard
  1740.    drives have been measured. Test 3 shows CD-ROM benchmark results using
  1741.    Aris Entertainment's MPC Wizard CD-ROM test. (All numbers are kilobytes
  1742.    per second).
  1743.  
  1744.           1) The setup for test 1 was a 386/40Mhz PC workstation connected
  1745.              with an Artisoft AE-2 Ethernet adapter to a 486/33Mhz LANtastic
  1746.              Server. This test shows CacheAll to improve the workstation's
  1747.              network drive access speed by 411%.
  1748.  
  1749.           2) The setup for test 2 was a 386/25Mhz PC workstation connected
  1750.              with a Xircom PE10B2-32K parallel port adapter to a 486/33Mhz
  1751.              LANtastic Server. This test shows CacheAll to improve the
  1752.              workstation's network drive access speed by 1759%.
  1753.  
  1754.           3) The setup for test 3 was a 386/25Mhz PC with a local Mitsumi
  1755.              CD-ROM drive (600 millisecond seek time and 150Kbytes/sec
  1756.              sustained throughput). This test shows CacheAll to improve the
  1757.              PC's local CD-ROM access speed by 2607%.
  1758.  
  1759.                                    Cache Size
  1760.  
  1761.         A maximum cache size of 64 Megabytes can be implemented. The 64
  1762.    Megabytes may be implemented totally in RAM, almost totally in a swap file
  1763.    (minimum MEMSIZE setting is 64 Kilobytes) or, may be partitioned between
  1764.    RAM and a swap file.
  1765.  
  1766.                                 Operating Systems
  1767.  
  1768.         MS-DOS 3.3+ and  DR DOS 5.x+ are supported.
  1769.  
  1770.                              Operating Environments
  1771.  
  1772.         DOS, Windows 3.0 and 3.1 and DESQview are supported.
  1773.  
  1774.                           Microprocessor Compatibility
  1775.  
  1776.         80286, 80386, 80486 and all 100% compatibles are supported.
  1777.  
  1778.  
  1779.    CacheAll Evaluation Manual                                         Page 37 
  1780.    --------------------------------------------------------------------------
  1781.  
  1782.  
  1783.                                   Program Size
  1784.  
  1785.         The program size for CacheAll varies depending on the parameters used
  1786.    at startup. In general, when CacheAll is loaded using a memory manager
  1787.    (such as Quarterdeck's QEMM or DOS 5.0+'s EMM386) which provides EMS
  1788.    memory, CacheAll will use 22Kb of conventional and 96Kb of EMS when you
  1789.    have EMS enabled.  If no EMS is enabled 22Kb of conventional and 30Kb-80Kb
  1790.    of UMB memory.  Loading in the presence of a memory manager is the
  1791.    recommended configuration (which is true of most programs these days!). If
  1792.    you do not have a memory manager, CacheAll will use from 59Kb to 159Kb of
  1793.    conventional memory depending on the configuration. To eliminate
  1794.    conventional memory usage, CacheAll can be loaded high, using a memory
  1795.    manager.
  1796.  
  1797.  
  1798.    CacheAll Evaluation Manual                                         Page 38 
  1799.    --------------------------------------------------------------------------
  1800.  
  1801.  
  1802.                      Caching only specific drive directories
  1803.  
  1804.         Through the use of DOS's substitute command ("SUBST.EXE") CacheAll
  1805.    may be configured to cache only part of a drive. Use CUtil's LIST command
  1806.    to determine which drive directories will benefit most by caching. Next,
  1807.    use DOS to substitute an unused drive letter for the directory to be
  1808.    cached. By caching the substituted drive and not the original drive, you
  1809.    focus the caching resources on files which will show the most benefit when
  1810.    cached. Be sure to properly set the LASTDRIVE option inside CONFIG.SYS to
  1811.    create "free" drive letters.
  1812.  
  1813.    Example:  You wish to cache your entire D: drive but only the "MYSTUFF"
  1814.              directory of your C: drive. One method would be:
  1815.  
  1816.           1) Include the line,
  1817.                   LASTDRIVE=E
  1818.              in your CONFIG.SYS
  1819.  
  1820.           2) Include the line,
  1821.                   SUBST E: C:\MYSTUFF
  1822.              before the call to CacheAll in your AUTOEXEC.BAT
  1823.  
  1824.           3) Use the following line in your CacheAll OPT file,
  1825.                   DRIVES=DE
  1826.  
  1827.           4) Use the MYSTUFF directory from the E: you have just created
  1828.  
  1829.    Since CacheAll will "not cache" the C: drive but will cache the E: drive
  1830.    you effective will cache only the MYSTUFF directory of the C: drive by
  1831.    accessing the MYSTUFF directory via the E: drive. In other words, do not
  1832.    bother accessing the C:\MYSTUFF directory because it will not be cached,
  1833.    access the E: drive instead because the E: drive will be cached.
  1834.  
  1835.         Some application cannot be broken up into multiple directories or
  1836.    across multiple drives. Therefore it may be necessary to cache their
  1837.    entire directory and not just an isolated few files within the directory.
  1838.  
  1839.  
  1840.    CacheAll Evaluation Manual                                         Page 39 
  1841.    --------------------------------------------------------------------------
  1842.  
  1843.  
  1844.                        Using CacheAll to Speed up Networks
  1845.  
  1846.         Installed on all network workstations and non-dedicated servers,
  1847.    CacheAll can dramatically reduce network traffic and server loading.
  1848.    CacheAll accomplishes this by locally caching as much as 64 Megabytes of
  1849.    data (Using RAM and a SWAP FILE) at the workstation -- after the first
  1850.    read, workstations obtain data from CacheAll's local copy instead of
  1851.    having to use the network. In the following example, workstations will
  1852.    accumulate local copies of server data, and therefore will no longer need
  1853.    to go through the network to the server to acquire frequently used data.
  1854.    This situation is shown in the diagrams below:
  1855.  
  1856.         Workstation's first access of specific server data:
  1857.                   ┌─────────────────────────┐            ┌──────────────┐
  1858.                   │      WORKSTATION (WS)   │            │NETWORK SERVER│
  1859.                   ├────┐   ┌────────┐   ┌───┤  Network   ├───┐   ┌──────┤
  1860.                   │ WS │<->│CacheAll│<->│NOS│<---------->│NOS│<->│Hard  │
  1861.                   │Apps│   │ cache  │   │   │ connection │   │   │Drive │
  1862.                   └────┴───┴────────┴───┴───┘            └───┴───┴──────┘
  1863.         Notice that to initially acquire the needed data the following data
  1864.         path must be taken:
  1865.                1. CacheAll monitors workstation application request
  1866.                2. Workstation Network Operating System (NOS) sends request to
  1867.                   network server.
  1868.                3. Network connection carries request to server.
  1869.                4. Server NOS receives request.
  1870.                5. Server hard drive reads data.
  1871.                6. Server NOS sends requested data to workstation.
  1872.         The requested data then traverses this path (noted by arrows) in the
  1873.         opposite direction. During the Workstation's second access to above
  1874.         data the following will occur:
  1875.                   ┌─────────────────────────┐            ┌──────────────┐
  1876.                   │      WORKSTATION        │            │NETWORK SERVER│
  1877.                   ├────┐   ┌────────┐   ┌───┤            ├───┐   ┌──────┤
  1878.                   │ WS │<->│CacheAll│   │NOS│            │NOS│   │Hard  │
  1879.                   │Apps│   │ cache  │   │   │            │   │   │Drive │
  1880.                   └────┴───┴────────┴───┴───┘            └───┴───┴──────┘
  1881.         Notice that the second time the workstation requests the server data,
  1882.         a much faster data path results:
  1883.                1. CacheAll interprets data request from application.
  1884.                2. CacheAll immediately returns the requested data.
  1885.  
  1886.         Thus CacheAll allows applications to run without going through the
  1887.    network and it's operating system, which can result in faster workstation
  1888.    operation, reduced network traffic and reduced server loading!
  1889.  
  1890.    NOTE TO NETWORK DATA BASE USERS -- To prevent potential loss of your data,
  1891.    CacheAll will not cache shared data files which are simultaneously updated
  1892.    by multiple users across a network UNLESS you are able to set these files
  1893.    to read only status.
  1894.  
  1895.  
  1896.    CacheAll Evaluation Manual                                         Page 40 
  1897.    --------------------------------------------------------------------------
  1898.  
  1899.  
  1900.         CUtil's LIST command allows viewing the cache activity of each
  1901.    workstation. Using this command allows you to see CacheAll cache local and
  1902.    network drives and also see which files are being cached!
  1903.  
  1904.  
  1905.    CacheAll Evaluation Manual                                         Page 41 
  1906.    --------------------------------------------------------------------------
  1907.  
  1908.  
  1909.                              Swap Files for CacheAll
  1910.  
  1911.                               What is a swap file?
  1912.  
  1913.         A swap file is an area of your hard drive which you set aside for use
  1914.    as additional "memory". Applications, such as CacheAll and Microsoft
  1915.    Windows, use a swap file to create the illusion that your PC has more
  1916.    memory than it really does.
  1917.  
  1918.         CacheAll is the first disk caching program that allows you to take
  1919.    advantage of a swap file to caching your storage devices. Using your hard
  1920.    drive as additional memory is inexpensive and can be quite beneficial,
  1921.    especially when using CacheAll to cache devices which are slower than your
  1922.    hard drive. For example,
  1923.  
  1924.      1) Dedicating your RAM to cache your fast devices, such as your hard
  1925.         drives, and dedicating a swap file to slow devices, such as CD-ROMs,
  1926.         allows you to provide a balanced performance increase across all of
  1927.         your devices. In this example, your hard drives would be made to
  1928.         appear almost as fast as RAM drives and your CD-ROMs appear to be
  1929.         almost as fast as hard drives.
  1930.  
  1931.         Note that you are always free to dedicate RAM to fast and slow
  1932.         devices, you must examine each CacheAll application on a case-by-case
  1933.         basis to determine the optimal caching method. Remember, when RAM is
  1934.         used for both fast and slow devices (i.e. Hard Drives & CD-ROMs) the
  1935.         slower devices can potentially monopolize the RAM cache at the
  1936.         expense of "fast" device performance gains.
  1937.  
  1938.      2) By installing CacheAll on each workstation of a network and creating
  1939.         very large caches through the use of RAM and SWAP FILE, a network
  1940.         manager can substantially reduce network traffic and server loading.
  1941.         This occurs because CacheAll will keep local copies of frequently
  1942.         used server data at each workstation. Therefore workstations do not
  1943.         need to go through the network to obtain data.
  1944.  
  1945.                       How does CacheAll use the swap file?
  1946.  
  1947.         To understand how CacheAll uses the swap file let's review basic
  1948.    cache operation. Caches maintain a copy of the most recently accessed
  1949.    data, and provide its copied data to applications much faster than the
  1950.    media on which the data was originally stored. When the cache program
  1951.    determines that new data should be added to the cache, data may have to be
  1952.    removed in order to make room for this new data. To achieve absolute
  1953.    maximum performance, we would prefer no data to be removed from the cache,
  1954.    but this is impossible since all computers have finite resources and so
  1955.    eventually run out of room. CacheAll addresses this issue by putting data
  1956.    removed from the cache RAM into a cache swap file (please refer to
  1957.    CacheAll's SLOW option in section entitled CacheAll Options).
  1958.  
  1959.         Classical cache programs are only capable of using your computer's
  1960.    expensive RAM, and compete with other programs for this valuable resource.
  1961.    This is another example of CacheAll's advantages over other cache
  1962.  
  1963.  
  1964.    CacheAll Evaluation Manual                                         Page 42 
  1965.    --------------------------------------------------------------------------
  1966.  
  1967.  
  1968.    programs. CacheAll can use a swap file to effectively extend the amount of
  1969.    memory your computer contains. This also allows CacheAll to cache data
  1970.    other cache programs would have to throw away. This particular aspect of
  1971.    CacheAll is most useful for slow devices (slow relative to the speed of
  1972.    drive on which the swap file is placed), such as CD-ROMs, slow network
  1973.    adapters, and when CacheAll is used to reduce network I/O by implementing
  1974.    large local data caches.
  1975.  
  1976.                         Defining a swap file for CacheAll
  1977.  
  1978.         When CacheAll is started, it examines your C: drive for its available
  1979.    disk space. Unless you specify otherwise, CacheAll will automatically use
  1980.    50% of your available disk space (up to 4 Meg) for the swap file. You may
  1981.    use the DISKPATH option (See CacheAll's option section) to place the swap
  1982.    file anywhere on any of your writable drives. The default location is the
  1983.    root directory of your C: drive.
  1984.  
  1985.              Note: to prevent potential loss of data, you should
  1986.              avoid placing the swap file on a compressed drive. You
  1987.              may use the DISKSIZE option to override the automatic
  1988.              setting and specify the desired size of the swap file.
  1989.              Note: to disable the swap file, simply specify a
  1990.              DISKSIZE of zero.
  1991.  
  1992.         Place the swap file on the fastest device you have connected to your
  1993.    system to achieve maximum cache speed. Note that it is wasteful to place
  1994.    the swap file on a RAM drive! It will work, but you will get better
  1995.    performance from CacheAll if you dedicate the memory used for the RAM
  1996.    drive to CacheAll directly as cache RAM. Use DRIVES and SLOW to cache
  1997.    specific drives to the SWAP FILE.
  1998.  
  1999.    EXAMPLE:  You wish to place the SWAP FILE in the TEMP directory of the E:
  2000.              drive, and you wish to use the SWAP FILE to cache networked
  2001.              CD-ROMs H: & J:, network drives K: & V:, and no other drives are
  2002.              to be cached using the SWAP FILE.
  2003.  
  2004.    Option file or command line option settings:
  2005.  
  2006.                   DISKPATH=E:\TEMP
  2007.                   DRIVES=C-Z
  2008.                   SLOW=HJKV
  2009.  
  2010.  
  2011.    CacheAll Evaluation Manual                                         Page 43 
  2012.    --------------------------------------------------------------------------
  2013.  
  2014.  
  2015.                    Removing the swap file from your hard drive
  2016.  
  2017.                      ABSOLUTELY DO NOT REMOVE THE SWAP FILE
  2018.                            WHILE CACHEALL IS RUNNING!
  2019.  
  2020.         When CacheAll creates the swap file, it sets the "hidden" attribute
  2021.    of the file to keep it from being inadvertently deleted. You can remove
  2022.    the file by using the DOS ATTRIB command BUT DON'T DO IT WHEN CacheAll IS
  2023.    RUNNING! If you use the default CacheAll settings for the swap file, you
  2024.    can execute the following commands to delete the swap file:
  2025.  
  2026.              ATTRIB  -H  C:\CACHEALL.SWP
  2027.              ATTRIB  -S  C:\CACHEALL.SWP
  2028.              DEL  C:\CACHEALL.SWP
  2029.  
  2030.         If you chose a different swap file path with the DISKPATH option, you
  2031.    will have to substitute that path for C:\ (as used in the example).
  2032.  
  2033.  
  2034.    CacheAll Evaluation Manual                                         Page 44 
  2035.    --------------------------------------------------------------------------
  2036.  
  2037.  
  2038.                         Maximizing CacheAll's Performance
  2039.  
  2040.  
  2041.         To achieve maximum CacheAll performance there are several things to
  2042.    consider when "tweaking" CacheAll's options. Some guidelines are listed
  2043.    below:
  2044.  
  2045.       - Use DOS's FASTOPEN program to help minimize the time it takes to open
  2046.         a file. Refer to your DOS manual for instructions to setup up
  2047.         FASTOPEN.  NOTE: This does not apply to CD-ROM's or networks.
  2048.  
  2049.       - Make sure that BUFFERS is set to a minimum of 30 in CONFIG.SYS
  2050.  
  2051.       - Install a memory manager.
  2052.  
  2053.       - Specify TABLES=REAL on CacheAll's command line or in your .OPT file.
  2054.         This will also cause CacheAll to use more memory when installed.
  2055.  
  2056.       - Use the swap file to cache slow devices like CD-ROMs, and when doing
  2057.         so use the DISKSIZE option to specify the largest swap file size
  2058.         possible. Doing this increases speed because more of the slow
  2059.         device's data will be read from the faster swap file drive.
  2060.  
  2061.       - BE SURE CACHEALL IS NOT RUNNING WHEN PERFORMING THE FOLLOWING
  2062.         PROCEDURE! To maximize access speed to the swap file run a drive
  2063.         defragmentation program so that CacheAll's swap file will be
  2064.         contiguous.
  2065.  
  2066.       - Use the SMALLFILES=N option. If you are working with many small files
  2067.         (files which are smaller than the BLOCKSIZE used by CacheAll), this
  2068.         option can increase your performance by telling CacheAll not to cache
  2069.         small files. An example of when this would is useful is when running
  2070.         Norton Desktop for Windows.
  2071.  
  2072.       - If you are caching very large files, greater than 128Mb, be sure your
  2073.         BLOCKSIZE is large enough. (Full details in commercial manual).
  2074.  
  2075.       - Use CUtil's LIST function to determine when and which files are being
  2076.         used by your applications (use CUtil's FLUSH=* to flush the cache and
  2077.         erase the file list). In this way the LIST command can help you to
  2078.         determine which files are most frequently used and so are most
  2079.         beneficial to cache. By grouping these frequently accessed files
  2080.         together in a directory and only caching that directory you may be
  2081.         able to substantially increase your system performance by focusing
  2082.         cache resources on that directory. See manual regarding caching
  2083.         specific areas of a drive to see how to cache specific directories.To
  2084.         achieve maximum CacheAll performance there are several things to
  2085.         consider when "tweaking" CacheAll's options. Some guidelines are
  2086.         listed below:
  2087.  
  2088.  
  2089.    CacheAll Evaluation Manual                                         Page 45 
  2090.    --------------------------------------------------------------------------
  2091.  
  2092.  
  2093.                             What CacheAll will not do
  2094.  
  2095.    Issue:    CacheAll will not negotiate RAM use under Windows.
  2096.    --------> Conserve RAM use by setting MEMSIZE to the maximum desired value
  2097.              under Windows and use a large SWAP FILE to cache CD-ROMs and
  2098.              network drives.
  2099.  
  2100.  
  2101.    Issue:    ************ FOR NETWORK DATA BASE USERS ONLY ***********
  2102.              To prevent potential loss of your data, CacheAll will not cache
  2103.              shared data files which are simultaneously updated by multiple
  2104.              users across a network UNLESS you set these files to read only
  2105.              status.
  2106.    --------> To cache such files, make them read only where possible.
  2107.  
  2108.  
  2109.    Issue:    CacheAll does not perform delayed writes.
  2110.    --------> If you wish to perform delayed writes for your local hard drive
  2111.              you can use CacheAll with another cache, such as SmartDrive. 
  2112.              Since delayed writes have no meaning for CD-ROMs or networks,
  2113.              simply use CacheAll to cache those drives and the other cache to
  2114.              cache your local drives.
  2115.  
  2116.  
  2117.    Issue:    CUtil's LIST command reports certain files are not always cached
  2118.    --------> This can be caused when a file is shared by multiple users or
  2119.              applications. Note, EXE's are not always cached but their
  2120.              overlays are usually cached.
  2121.  
  2122.  
  2123.    CacheAll Evaluation Manual                                         Page 46 
  2124.    --------------------------------------------------------------------------
  2125.  
  2126.  
  2127.                           CacheAll's Automatic Settings
  2128.  
  2129.    CacheAll will,
  2130.  
  2131.    Setting:  use 50% of available RAM (Extended, XMS or EMS)
  2132.    Override: use MEMSIZE to specify a different setting
  2133.  
  2134.    Setting:  place SWAP FILE in the root of your C: drive, if the SLOW option
  2135.              is used or a CD-ROM is detected.
  2136.    Override: use DISKPATH to specify a different drive and/or directory,
  2137.              remember to avoid placing SWAP FILE on a compressed or network
  2138.              drive
  2139.  
  2140.    Setting:  use 50% of available drive space on C: up to 4 Megabytes
  2141.    Override: use DISKPATH to specify a different drive and/or, DISKSIZE to
  2142.              specify a different setting, set DISKSIZE=0 to disable SWAP
  2143.              FILE.
  2144.  
  2145.    Setting:  not cache floppy drives (usually A: and B:)
  2146.    Override: use DRIVES to select drives to cache
  2147.  
  2148.    Setting:  cache only local CD-ROMs to the SWAP FILE
  2149.    Override: use the SLOW command to select the drives which should be cached
  2150.              using the swap file
  2151.    Note:     CacheAll does not typically "see" CD-ROMs accessed over a
  2152.              network and so may require the user to manually specify these
  2153.              CD-ROMs.
  2154.  
  2155.    Setting:  choose BLOCKSIZE (based on value of MEMSIZE) to minimize RAM
  2156.              usage
  2157.    Override: use BLOCKSIZE to specify a different value, BUT REMEMBER --
  2158.              setting BLOCKSIZE to its maximum value of 16 WILL NOT
  2159.              necessarily maximize performance, to maximize performance you
  2160.              must slowly increase and decrease the BLOCKSIZE setting for your
  2161.              particular application, "when in doubt, leave it out!"
  2162.  
  2163.  
  2164.    CacheAll Evaluation Manual                                         Page 47 
  2165.    --------------------------------------------------------------------------
  2166.  
  2167.  
  2168.                                  Common Problems
  2169.  
  2170.    CacheAll Not installed:
  2171.         Check your AUTOEXEC.BAT
  2172.              Example -- LANtastic installs a line similar to below,
  2173.  
  2174.                   C:\LANTASTI\STARTNET.BAT
  2175.  
  2176.              in your AUTOEXEC.BAT. This line runs STARTNET.BAT but after
  2177.              execution any lines which follow, such as CacheAll's install
  2178.              line, are not executed. To correct this simply do what
  2179.              CacheAll's installation program does and use a CALL statement to
  2180.              change the above line to:
  2181.  
  2182.                   CALL C:\LANTASTI\STARTNET.BAT
  2183.  
  2184.              Now after STARTNET.BAT is completed, control will return to
  2185.              AUTOEXEC.BAT.
  2186.  
  2187.    Starting Networks from BATch file other than AUTOEXEC.BAT:
  2188.         CacheAll must be installed AFTER your network. To correct this,
  2189.         unload CacheAll before starting your network and add CacheAll's
  2190.         installation line to the end of the BATch file that installs your
  2191.         network. This line may be copied from your AUTOEXEC.BAT after
  2192.         CacheAll is installed.  It should look something like this:  CALL
  2193.         C:\CACHEALL\RUNCA.BAT
  2194.  
  2195.    Local Hard drives are slower using CacheAll
  2196.      1) CacheAll's automatic setting use 50% of available RAM, your previous
  2197.         cache was probably set to use more RAM. Set CacheAll RAM cache size
  2198.         to the same value as your previous cache using the MEMSIZE option.
  2199.      2) This may occur when using CacheAll to replace a cache which had been
  2200.         providing delayed writes (CacheAll does not support delayed writes).
  2201.         If you wish to continue performing delayed writes, use CacheAll in
  2202.         conjunction with a cache program such as SmartDrive.  But remember,
  2203.         delayed writes have no meaning for CD-ROMs. Also remember that no
  2204.         other cache program can cache network drives.
  2205.      3) CacheAll performs read aheads to improve file access performance. In
  2206.         some cases the value of BLOCKSIZE may be too large for the type of
  2207.         data you typically work with. To improve performance, reduce the
  2208.         value of block size until maximum performance is achieved. If you
  2209.         wish to tweak BLOCKSIZE do so by SLOWLY increasing and decreasing its
  2210.         value until the optimal setting is found.
  2211.      4) Be sure that BUFFERS is set to a minimum of 30 in CONFIG.SYS
  2212.      5) Starting up Microsoft Windows with many fonts. This slowdown can be
  2213.         avoided by setting SMALLFILES=N in ".OPT" file or on CacheAll's
  2214.         command line.
  2215.  
  2216.    My computer has recently become unstable.
  2217.         This problem can occur when using a batch file other than
  2218.         AUTOEXEC.BAT to startup your network. When starting your network in
  2219.         this manner, unload CacheAll at the beginning of the BATCH file and
  2220.         load CacheAll at the end of the file. Also, when starting CacheAll
  2221.  
  2222.  
  2223.    CacheAll Evaluation Manual                                         Page 48 
  2224.    --------------------------------------------------------------------------
  2225.  
  2226.  
  2227.         manually be sure to do so AFTER all device drivers, redirectors and
  2228.         network software is installed!
  2229.  
  2230.  
  2231.    CacheAll Evaluation Manual                                         Page 49 
  2232.    --------------------------------------------------------------------------
  2233.  
  2234.  
  2235.    CacheAll provides no benefit to my BBS's or CD-ROMs.
  2236.  
  2237.    Do the following,
  2238.  
  2239.      1) Set the DRIVES parameter exclusively to all of your CD-ROM drives.
  2240.      2) Set BLOCKSIZE=16
  2241.      3) Set MAXFILES to be equal to,
  2242.  
  2243.              (the number of multi-tasked BBS nodes on your BBS) + 2
  2244.  
  2245.         Note:     If you are providing BBS nodes via individual workstations
  2246.                   on a network then the above procedure is ILLEGAL (unless
  2247.                   you have purchased enough copies for each node), CacheAll
  2248.                   is licensed per computer!
  2249.  
  2250.      4) Set READAHEAD=A-Z:n, where n is slowly increase for 1 to 99. "Maxing
  2251.         out" n is NOT optimal! The optimal value of 'n' is a function of,
  2252.  
  2253.              a) CD-ROM speed (streaming and access latency)
  2254.              b) Number of BBS nodes and the speeds at which they are running
  2255.              c) Number of files being concurrently access from a single
  2256.    drive.
  2257.  
  2258.         Our Beta tester have found that 'n' values around 8 work well and
  2259.         that "
  2260.  
  2261.      5) Set MEMSIZE equal to or greater than,
  2262.  
  2263.              (16) x (n) x ( Value_of_MAXFILES + 2 )
  2264.  
  2265.      6) Set DISKSIZE=0
  2266.  
  2267.    Repeat this procedure until satisfactory results are achieved; reduction
  2268.    in CD-ROM "thrashing around", significant reduction in download
  2269.    "choppiness". In the words of a Beta tester,
  2270.  
  2271.              ... user accessing the CD-ROM server would be hard pressed to
  2272.              tell they were getting data from a CD-ROM and not a relatively
  2273.              high speed hard drive.
  2274.                                            Janice Stevens
  2275.                                            Rain Corporation
  2276.  
  2277.  
  2278.    CacheAll Evaluation Manual                                         Page 50 
  2279.    --------------------------------------------------------------------------
  2280.  
  2281.  
  2282.                                 Common Questions
  2283.  
  2284.    How is CacheAll different than other caches?
  2285.         Other cache programs only cache local hard drives, floppy drives and
  2286.         sometimes CD-ROMs, but CacheAll can cache ANY device which can be
  2287.         accessed as a drive letter (such as C: or D: or R:). CacheAll will
  2288.         cache CD-ROM drives, network drives, hard drives, floppy drives,
  2289.         optical drives and any other drive you can normally access from your
  2290.         PC. CacheAll is also the only cache that allows you to use a SWAP
  2291.         FILE to cache any device. It is also the only cache that allows you
  2292.         to cache only a section of a storage device rather than the entire
  2293.         drive.
  2294.  
  2295.    What about CacheAll benchmarking?
  2296.         Be careful using benchmarking programs to determine CacheAll's true
  2297.         performance. Many benchmarking programs say that CacheAll provides no
  2298.         performance increase because they are designed to test cache programs
  2299.         such as SmartDrive. CacheAll uses a completely new technology that
  2300.         many benchmark programs were not designed to test. When this happens
  2301.         no difference is noted. The best way to test CacheAll is to run a
  2302.         scenario of tests (such as doing CD-ROM searches) without CacheAll
  2303.         and then do the same series of tests with CacheAll loaded and note
  2304.         how much faster the test is when CacheAll is running. Remember -- as
  2305.         with other cache programs CacheAll will show greater performance
  2306.         benefits when you perform an operation more than once.
  2307.  
  2308.         Many CacheAll users have requested that we provide a benchmarking
  2309.         program which is capable of benchmarking CacheAll. We have therefore
  2310.         included a VERY SIMPLISTIC benchmarking tool, FILETEST.EXE, with
  2311.         CacheAll. See the section entitled "FILETEST -- A simplistic cache
  2312.         benchmarking program".
  2313.  
  2314.    Is CacheAll installed in my CONFIG.SYS or AUTOEXEC.BAT?
  2315.         In most cases CacheAll should be installed at the end of your
  2316.         AUTOEXEC.BAT.
  2317.  
  2318.    I only use a network sometimes, should I install for standalone or
  2319.    network?
  2320.         When installing CacheAll for standalones, CacheAll will refer to the
  2321.         STDALONE.OPT file for it's option settings. This ".OPT" file contains
  2322.         the statement ALLFILES=A-Z which should not be used for networks (see
  2323.         ALLFILES in CacheAll Options section)! When running your network,
  2324.         change RUNCA.BAT to run NETWORK.OPT instead of STDALONE.OPT, and for
  2325.         maximum standalone performance remember to switch it back when not
  2326.         using the network. You may wish to perform this operation by writing
  2327.         a batch file.
  2328.  
  2329.  
  2330.    CacheAll Evaluation Manual                                         Page 51 
  2331.    --------------------------------------------------------------------------
  2332.  
  2333.  
  2334.    Is CacheAll Windows compatible?
  2335.         Yes! If you are running Microsoft Windows 3.0, you must add the line:
  2336.  
  2337.                   InDOSPolling=1
  2338.  
  2339.         to the [386Enh] section of SYSTEM.INI. If you do not know how to
  2340.         modify the SYSTEM.INI file, please refer to your Microsoft Windows
  2341.         documentation. If you are using Microsoft Windows 3.1, you do not
  2342.         need to make any changes.
  2343.  
  2344.    What do I need to do to configure CacheAll?
  2345.         Nothing! In fact we suggest that you don't set any options but, if
  2346.         you must, only adjust the MEMSIZE, SLOW, and DISKSIZE options.
  2347.         Remember --adjusting options incorrectly will degrade performance.
  2348.  
  2349.  
  2350.                               Notes to CD-ROM Users
  2351.  
  2352.    CD-ROM applications which have large files (greater than 128Mb)
  2353.         If you are using a CD-ROM application which has large files, you
  2354.         might need to increase the BLOCKSIZE setting to increase performance.
  2355.  
  2356.    Maximizing Performance
  2357.         Set DISKSIZE's value as large as possible (refer to MANUAL.TXT for
  2358.         maximum value of approx. 64 Megabytes). This will cause most CD-ROM
  2359.         accesses to occur from your hard drive.
  2360.  
  2361.    Silver Platter
  2362.         Set to network and turn off buffers.
  2363.  
  2364.  
  2365.    CacheAll Evaluation Manual                                         Page 52 
  2366.    --------------------------------------------------------------------------
  2367.  
  2368.  
  2369.                              Notes to Network Users
  2370.  
  2371.    Licensing errors when using CacheAll on a network.
  2372.         CacheAll has built-in license tracking to allow you to stay in
  2373.         compliance with your CacheAll licenses. If you see the message
  2374.         "CacheAll is not installed due to a license failure!", you probably
  2375.         have other copies of CacheAll already running on the network. If this
  2376.         is the case, you will have to call our sales department at
  2377.         800-847-5676 to order additional copies of CacheAll. If you do not
  2378.         have other copies of CacheAll running on the network, make a note of
  2379.         the number which appears after the error message and call our
  2380.         technical support department at 516-434-3214.
  2381.  
  2382.         Even if you purchased two or more copies of CacheAll, you must make
  2383.         sure that each license number is assigned to a particular PC (or
  2384.         node) on the network.
  2385.  
  2386.         If you are installing CacheAll on a diskless workstation, you will
  2387.         have to provide a special directory on the server to hold the copy of
  2388.         CacheAll for that workstation.  You will not be able to put a single
  2389.         copy of CacheAll on the network boot drive for execution by all
  2390.         diskless workstations.
  2391.  
  2392.         CUtil, the CacheAll monitor program, does not have license tracking
  2393.         built-in.  A single copy of CUtil can be used by anyone on the
  2394.         network. 
  2395.  
  2396.    Novell Netware
  2397.         If you want to use CacheAll to cache your network drives on a Novell
  2398.         Netware network, you must login to a server and then run CacheAll. 
  2399.         When you logout of the server, CacheAll will be disabled.  If you
  2400.         want to reenable CacheAll, you will have to do the following:
  2401.  
  2402.              1.   Unload CacheAll with the UNLOAD parameter.
  2403.              2.   Login to a Netware server
  2404.              3.   Run CacheAll
  2405.  
  2406.    Artisoft LANtastic(TM)
  2407.         LANcache DOES NOT cache network drives, only local hard drives.
  2408.         CacheAll caches all drives... network, hard drives, CD-ROM, etc. 
  2409.         CacheAll is designed to be run on the workstations, not the SERVER
  2410.         (as LANcache does).  You can think of CacheAll as a complement to
  2411.         LANcache, not a replacement.
  2412.  
  2413.  
  2414.    CacheAll Evaluation Manual                                         Page 53 
  2415.    --------------------------------------------------------------------------
  2416.  
  2417.  
  2418.    Diskless Workstations
  2419.         CacheAll can be used on diskless workstations (sometimes called
  2420.         remote boot workstations).  It will work best if you disable the swap
  2421.         file using the DISKSIZE=0 option.  You can put the swap file on a
  2422.         network drive, but you might sacrifice some performance benefits,
  2423.         depending on how you use CacheAll.  The following steps outline one
  2424.         way of installing CacheAll onto a diskless workstation (this
  2425.         procedure is geared towards LANtastic, but should apply to most other
  2426.         networks):
  2427.  
  2428.              1.   Install CacheAll onto the file server.
  2429.              2.   Create a resource/alias for CacheAll called CACHE1.
  2430.              3.   Boot the diskless workstation.
  2431.              4.   Now, do one of the following:
  2432.                   a.   Modify the AUTOEXEC.BAT for the diskless workstation
  2433.                        to connect to the resource CACHE1 and run the CACHEALL
  2434.                        program.
  2435.                   or
  2436.  
  2437.                   b.   Run CACHEALL directly from the CACHE1 resource
  2438.  
  2439.         This procedure should get CacheAll up and running on a diskless
  2440.         workstation.  
  2441.  
  2442.         If you are installing CacheAll on a diskless workstation, you will
  2443.         have to provide a special directory on the server to hold the copy of
  2444.         CacheAll for that workstation.  You will not be able to put a single
  2445.         copy of CacheAll on the boot image (network boot drive) for execution
  2446.         by all diskless workstations, unless you only have ONE diskless
  2447.         workstation on your network.
  2448.  
  2449.    Where should CacheAll be loaded?  My Server or Workstation?
  2450.         CacheAll is designed to be run on each workstation on your network.
  2451.  
  2452.    CacheAll Increases Network Performance
  2453.         Running CacheAll on ALL workstations or non-dedicated servers of a
  2454.         network provides several important benefits by reducing network I/O
  2455.         requests:
  2456.  
  2457.              1. Reduced network traffic
  2458.              2. Increased workstation speed
  2459.              3. Reduced server load
  2460.              4. Use CUtil's LIST command to view cache file listing
  2461.  
  2462.    Maximizing Network Performance
  2463.         When using CacheAll on a network, we recommend setting all program
  2464.         files to be read only.  This can usually be done using the DOS ATTRIB
  2465.         command.  You can say the following:
  2466.  
  2467.                   ATTRIB +R *.EXE
  2468.                   ATTRIB +R *.COM
  2469.                   ATTRIB +R *.DLL
  2470.  
  2471.  
  2472.    CacheAll Evaluation Manual                                         Page 54 
  2473.    --------------------------------------------------------------------------
  2474.  
  2475.  
  2476.         Those two lines will force all files with the extensions EXE, DLL,
  2477.         and COM in the current path to be set as READ ONLY files and thus
  2478.         will be   cached by CacheAll without needing to set ALLFILES.  You
  2479.         might find other files, such as overlays, which can also have the
  2480.         READ ONLY attribute set.
  2481.  
  2482.    DEDICATED Servers
  2483.         If you have a dedicated server you should continue running programs
  2484.         such as SmartDrive as these programs will increase the servers "serve
  2485.         speed" to the network.  BUT, these programs should be removed from
  2486.         your workstations and replaced by CacheAll.
  2487.  
  2488.    Networks versus Standalone operation: ALLFILES!
  2489.         Unless directed otherwise, using the ALLFILES option, CacheAll will
  2490.         only cache files which are opened in EXCLUSIVE or DENY WRITE modes.
  2491.  
  2492.         1) Network user
  2493.              If you are using CacheAll on a drive which is used exclusively
  2494.              by one user (or not on a network), you can use the ALLFILES
  2495.              option for this drive. The ALLFILES option will force CacheAll
  2496.              to cache all the files on the specified drives, regardless of
  2497.              how they are opened. YOU MUST BE SURE NO ONE ELSE CAN MODIFY THE
  2498.              FILES WHILE THEY ARE BEING CACHED WITH THE ALLFILES OPTION.
  2499.  
  2500.         2) When not connected to a Network (i.e. "Standalone")
  2501.              Set
  2502.                   ALLFILES=A-Z
  2503.              For maximum performance. This will be done automatically if you
  2504.              told the installation program that your PC was a standalone
  2505.              PC.
  2506.  
  2507.    Shared files
  2508.         CacheAll will only cache files which are opened in EXCLUSIVE or DENY
  2509.         WRITE modes.  If you are using CacheAll on a drive which is used
  2510.         exclusively by one user (or not on a network), you can use the
  2511.         ALLFILES option for this drive. The ALLFILES option will force
  2512.         CacheAll to cache all the files on the specified drives, regardless
  2513.         of how they are opened.  YOU MUST BE SURE NO ONE ELSE CAN MODIFY THE
  2514.         FILES WHILE THEY ARE BEING CACHED WITH THE ALLFILES OPTION. Use
  2515.         CUtil's LIST command at each workstation to determine who is using
  2516.         what and when.
  2517.  
  2518.  
  2519.    CacheAll Evaluation Manual                                         Page 55 
  2520.    --------------------------------------------------------------------------
  2521.  
  2522.  
  2523.              FileTest(tm) -- A simplistic cache benchmarking program
  2524.  
  2525.         Many CacheAll users have asked that we provide a benchmarking program
  2526.    capable of benchmarking CacheAll. While we would prefer that CacheAll be
  2527.    compared to other caches using the software of an un-biased author we now
  2528.    provide a benchmarking program with CacheAll called FILETEST.EXE.
  2529.  
  2530.         FileTest provides a very basic and simplistic figure of merit for the
  2531.    read throughput of a file or files of any storage device. The test results
  2532.    provided by this program in no way predict the actual performance gains
  2533.    you will see during normal operation of your computer when using CacheAll
  2534.    or any other Cache.  We recommend only using FileTest to prove to yourself
  2535.    that CacheAll is really working.  If you want to perform thorough testing
  2536.    of CacheAll look around for a benchmarking program, such as those authored
  2537.    by PC Magazine, etc.
  2538.  
  2539.                                FileTest Operation
  2540.  
  2541.    FileTest reads a file or files in a sequential or random form.  If has
  2542.    several options which allow you to test different types of read patterns. 
  2543.    All output from the FileTest program can be routed to a file using
  2544.    standard DOS redirection (using the > sign, example: FILETEST
  2545.    F=BIGFILE.TXT >cache.txt).
  2546.  
  2547.                                 FileTest Options
  2548.  
  2549.    F=[filename]   File to test with, any valid filename or pathname.  Some
  2550.                   examples of valid options would be:
  2551.                     F=C:\WINDOWS\*.*
  2552.                     F=C:\DOS\XCOPY.EXE
  2553.                     F=G:\DATA\BIGFILE.TXT
  2554.  
  2555.    BS=size        The block size of each read in bytes (maximum is 32767). 
  2556.                   When FileTest reads a block of data, it will use the block
  2557.                   size specified with this option.  If you specify a zero
  2558.                   block size (BS=0), FileTest will use a random block size
  2559.                   for each read.  The smallest block being 1 and the largest
  2560.                   being 32767.
  2561.  
  2562.    P=[n]          The number of passes FileTest will make across the files
  2563.                   specified with the F= option.  The default is three passes.
  2564.  
  2565.    M=[R,S]        The mode which FileTest will read the files in.  M=R
  2566.                   specifies Random mode, will do random seeks when reading
  2567.                   the files.  M=S will read the file sequentially from the
  2568.                   start of the file to the end of the file.  M=S if the
  2569.                   default.
  2570.  
  2571.  
  2572.    CacheAll Evaluation Manual                                         Page 56 
  2573.    --------------------------------------------------------------------------
  2574.  
  2575.  
  2576.  
  2577.    S=[n]          If in random mode (M=R), specifies the number of seeks to
  2578.                   do within each file.  The default is 200 seeks per file.
  2579.  
  2580.    L=[Y,N]        If you specify wildcards in the F= option, the L=Y option
  2581.                   will show a listing of all the files which will be read. 
  2582.                   The default is to not show the file listing.
  2583.  
  2584.    The output of FileTest when run with the options F=*.hlp BS=4096 will look
  2585.    something like this:
  2586.  
  2587.    ┌──────────────────────────────────────────────────────────────────────┐
  2588.    │ FileTest v1.1.                                                       │
  2589.    │ Copyright (c) 1993 by C & D Programming Corp.  All Rights Reserved.  │
  2590.    │                                                                      │
  2591.    │ Sequential read mode                                                 │
  2592.    │ 3 passes will be made                                                │
  2593.    │ The file(s) "*.hlp" will be used for testing                         │
  2594.    │ Read block size is 4096                                              │
  2595.    │                                                                      │
  2596.    │                                                                      │
  2597.    │         Block Size  Read Time   Bytes Read   Throughput              │
  2598.    │ Pass #    (Bytes)   (Seconds)      (Kb)       (Kb/Sec)               │
  2599.    │ ------  ----------  ---------   ----------   ----------              │
  2600.    │     1     4096           3.19         1443       451.64              │
  2601.    │     2     4096           0.65         1443      2213.19              │
  2602.    │     3     4096           0.65         1443      2213.19              │
  2603.    │ ======              =========   ==========   ==========              │
  2604.    │ Average:                 1.50         1443       962.44              │
  2605.    └──────────────────────────────────────────────────────────────────────┘
  2606.    Each pass represents the total time it took to read through all the *.HLP
  2607.    files in the current directory (which totalled about 1,443Kb).
  2608.  
  2609.              Be careful interpreting FileTest results when a file(s) is (are
  2610.              cumulatively) larger than the memory used by the cache being
  2611.              tested. While this is a valid test to perform this does not test
  2612.              the cache under the conditions to which it is meant to be used
  2613.              for!
  2614.  
  2615.  
  2616.    CacheAll Evaluation Manual                                         Page 57 
  2617.    --------------------------------------------------------------------------
  2618.  
  2619.  
  2620.       AppTrack(TM) Makes Software audits a nuisance rather than a concern -
  2621.  
  2622.                              AppTrack 1.0 Features:
  2623.  
  2624.    AppTrack is a full-featured license management and program restrictor for
  2625.    LANtastic networks that reduces network management headaches by
  2626.    guaranteeing you pass every software audit!
  2627.  
  2628.                         Application Management Features:
  2629.  
  2630.    1)   Without workstation TSR's, AppTrack manages and restricts program
  2631.         usage,
  2632.            ∙ Allows network managers to guarantee software license adherence
  2633.              across a network
  2634.            ∙ An unlimited number of Microsoft Windows and DOS applications
  2635.              can be managed simultaneously
  2636.            ∙ Applications can be managed across multiple servers
  2637.  
  2638.    2)   Provides maximum security for your licenses,
  2639.            ∙ End user cannot copy applications
  2640.            ∙ Fully encrypted network packets and database
  2641.            ∙ System manager privileges are required for management access and
  2642.              control
  2643.  
  2644.    3)   Includes easy to use, Microsoft Windows based, Console as a control
  2645.         center
  2646.  
  2647.                            AppTrack Console Features:
  2648.  
  2649.    1)   "At-a-glance" application display,
  2650.            ∙ Displays currently executing applications and who is running
  2651.    them
  2652.            ∙ Shows peak usage of an application
  2653.            ∙ Easily spot excessive licensing
  2654.                   - Reduce software costs!
  2655.  
  2656.    2)   Extensive data collection. Data and it's views,
  2657.            ∙ Can be exported to several formats
  2658.                 - fully documented custom exporting facility
  2659.            ∙ Can be included in reports to Management
  2660.            ∙ Can be customized & saved for later retrieval
  2661.            ∙ Includes application transaction history
  2662.                 - Application & User name, Start & Stop time, ...
  2663.  
  2664.        To order AppTrack, contact C&D Programming Corp. at (800)847-5676 
  2665.                           (outside U.S. (801)582-0503)
  2666.  
  2667.  
  2668.    CacheAll Evaluation Manual                                         Page 58 
  2669.    --------------------------------------------------------------------------
  2670.  
  2671.  
  2672.               Reseller Qualification Form: C&D Welcomes Resellers!
  2673.  
  2674.         C&D thanks you for your interest in reselling our products!  Our
  2675.    screening process protects your business by making it simple for
  2676.    legitimate applicants to establish reseller status, and preventing end-
  2677.    users from obtaining reseller discounts. What We Need From You,
  2678.  
  2679.      1) Proof that your company exists. Simply supplying requested numbers is
  2680.         not sufficient! Please provide,
  2681.            ∙ A copy of your CURRENTLY VALID Sales Tax Licenses or Resale
  2682.              permit.
  2683.            ∙ Or, a copy of your CURRENTLY VALID Tax Exemption Certificate or
  2684.              Goods and Services Tax Certificate.
  2685.            ∙ Or, a copy of a CURRENTLY VALID Employer Identification.
  2686.            ∙ Or, a completed and VALID IRS W-9 form.
  2687.  
  2688.      2) Proof that you resell computer products and/or services. Please
  2689.         provide,
  2690.            ∙ Your company brochure for a product you design, manufacture, or
  2691.              sell.
  2692.            ∙ Or, a recent advertisement for your company and it's products or
  2693.              services. This can be a page from a recent newspaper, magazine,
  2694.              Yellow Pages (computer-oriented section), or other publication.
  2695.  
  2696.      3) Signature of Owner, or Corporate Officer, and Company Information -
  2697.  
  2698.    Company Name____________________________________________________________
  2699.  
  2700.    Address_________________________________________________________________
  2701.  
  2702.    City ____________________________  State _____________ Zip _____________
  2703.  
  2704.    Phone _________________________________ FAX_____________________________
  2705.  
  2706.    Contact_________________________________________________________________
  2707.  
  2708.    D&B Account # _________________________ Date ______________ Rating _____
  2709.  
  2710.    How did you hear about C&D?_____________________________________________
  2711.  
  2712.    I certify that the above company is a legitimate reseller of computer
  2713.    products and/or services.
  2714.  
  2715.    Signature _______________________________________ Date__________________
  2716.  
  2717.    Printed Name ____________________________________ Title_________________
  2718.    To receive a reseller package, mail (or Fax to 801-581-0883) this
  2719.    completed form with the requested information to:
  2720.                        C&D Programming Corp.
  2721.                        New Accounts (CAEVAL1.0H)
  2722.                        P.O. Box 581012
  2723.                        Salt Lake City, Utah 84158 USA