home *** CD-ROM | disk | FTP | other *** search
/ CD Shareware Masterblend / cdsharewaremasterblend.iso / utils / adj-ramd / adjram.doc next >
Text File  |  1987-05-01  |  41KB  |  846 lines
  1.  
  2.  
  3.  
  4.                           ADJRAM -- Adjustable RAM Disk
  5.  
  6.                                 by Gary Cramblitt
  7.  
  8.                                    Version 3.0
  9.  
  10.         (c) Copyright 1986 by Gary Cramblitt.  All rights reserved.
  11.             Permission is granted to copy and use this software for
  12.             non-commercial purposes only.
  13.  
  14.             NOTICE:  This program is provided on an "as is" basis
  15.             without warranty of any kind, expressed or implied,
  16.             including but not limited to the implied warranties of
  17.             mercantability and fitness for a particular purpose.  The
  18.             entire risk as to quality and performance of this program is
  19.             with you, the user.  Should the program prove defective, you
  20.             assume the entire cost of all necessary repair, servicing,
  21.             or correction.  In no event will the author be liable to you
  22.             for any damages, including any lost profits, lost savings,
  23.             or other incidental or consequential damages arising out of
  24.             the use or inability to use this program.
  25.  
  26.  
  27.         This program, although copyrighted, may be freely copied and
  28.         used, so long as it is not used for commercial purposes.  It is
  29.         NOT shareware or user-supported software.  You are not expected
  30.         to make a donation to the author for using this program.  Enjoy
  31.         -- and try to do the same for others some day.
  32.  
  33.  
  34.         What Is ADJRAM?
  35.         ---------------
  36.         ADJRAM is a RAM disk program.  Sometimes, RAM disks are called
  37.         "virtual disks" like the VDISK supplied with PC-DOS.  Sometimes
  38.         they are called "memory disks" like MEMBRAIN.  Whatever you call
  39.         it, a RAM disk is a program that makes a section of the Random
  40.         Access Memory (RAM) of your computer look like a floppy disk
  41.         drive to DOS.  The advantage is that RAM is many hundreds of
  42.         times faster than a floppy disk -- even faster than a hard disk.
  43.  
  44.         Why use ADJRAM, when you already have VDISK or MEMBRAIN or some
  45.         other RAM disk?  Because ADJRAM allows you to vary the size of
  46.         the RAM disk without rebooting, and without loss of existing
  47.         data stored in the RAM disk.  For example, you can start out
  48.         with 64K of your memory allocated for the RAM disk, expand it
  49.         later to 320K, copy a document file of 60K to the RAM disk, and
  50.         still later reduce the RAM disk capacity back down to 128K --
  51.         without losing your document file.
  52.  
  53.         ADJRAM is ideal for those who do not have a hard disk.
  54.  
  55.  
  56.         Requirements
  57.         ------------
  58.         ADJRAM is designed to run under MS-DOS version 2 or greater.  It
  59.         has been tested on the following machines:
  60.  
  61.              1.  Zenith Z100 under MS-DOS version 2.21
  62.              2.  Zenith Z171 (an IBM PC compatible) under MS-DOS version
  63.                  2.11
  64.              3.  KayPro 16 also under MS-DOS 2.11
  65.              4.  Zenith Z158 (another IBM PC compatible) under MS-DOS
  66.                  3.1 with a 2 Mbyte JRAM 3 card
  67.  
  68.         It is the author's belief that it will run under PC-DOS version
  69.         2 or higher, but this has not been tested.  It requires
  70.         approximately 10K bytes of disk space.  Memory usage is, of
  71.         course, a function of the RAM disk's size, but it requires a
  72.         minimum of 65K free RAM.
  73.  
  74.  
  75.         Installation
  76.         ------------
  77.         Note: If you have a computer with LOTUS/INTEL/Microsoft Expanded
  78.               Memory and you want ADJRAM to use the Expanded Memory,
  79.               please read the section below entitled "Expanded Memory
  80.               Support" before you install ADJRAM.
  81.  
  82.         Copy the following files to your boot disk:
  83.  
  84.              AMDISK.DVD
  85.              ADJRAM.EXE
  86.  
  87.         Edit your CONFIG.SYS file and place the following line in it:
  88.  
  89.              device = amdisk.dvd
  90.  
  91.         Reboot your computer.  If all goes well, you should see the
  92.         following message appear near the beginning of your boot
  93.         sequence:
  94.  
  95.              AMDISK v3.0 (c) Copyright 1986 by Gary Cramblitt--
  96.                     Initialized as disk C:
  97.  
  98.         The disk drive letter will vary according to your system
  99.         configuration.  Remember that drive letter, since it is that
  100.         disk which is your RAM disk.
  101.  
  102.         If you use any memory resident programs, such as Sidekick (a
  103.         trademark of Borland International), load them before attempting
  104.         to change the size of the RAM disk (as explained in the next
  105.         section).
  106.  
  107.  
  108.         Using the RAM Disk
  109.         ------------------
  110.         The RAM disk is used just like any floppy disk drive.  You can
  111.         copy files to or from it, create directories on it, erase files,
  112.         etc.  You may NOT do the following things with the RAM disk:
  113.  
  114.              1.  You may not FORMAT the RAM disk.
  115.              2.  You may not DISKCOPY from or to the RAM disk.
  116.              3.  You may not run SYS against the RAM disk.
  117.              4.  You may not boot from the RAM disk.
  118.              5.  You may not use any program on the RAM disk that
  119.                  accesses the disk controller circuitry directly.  Some
  120.                  anti-copy protection programs fall into this category.
  121.              6.  You may not use any program that depends upon IBM
  122.                  standard disk media codes.  One such program is CHKDSK.
  123.                  My version of CHKDSK will report that my RAM disk is a
  124.                  non-standard format and ask me if I wish to continue.
  125.                  If I say yes, everything works normally thereafter.
  126.  
  127.         Restrictions 1 through 5 are generally true of any RAM disk.
  128.         Restriction 6 is unique to the Adjustable RAM Disk because it
  129.         uses a non-standard disk media code.  This shouldn't cause great
  130.         hardship though.
  131.  
  132.         Also, keep in mind that anything stored in the RAM disk can
  133.         potentially be lost.  For example, should your power fail and
  134.         you don't have an Uninterruptible Power Source (UPS), then
  135.         everything in the RAM disk will be lost.  If you reboot (by
  136.         pressing CTRL-ALT-DEL for example), the contents of the RAM disk
  137.         are lost.  It is a good idea to periodically copy important
  138.         files to a more permanent medium, such as floppy disk.
  139.  
  140.         The RAM disk defaults to a size of 64K bytes when you first boot
  141.         the system.  The ADJRAM program is used to change this size.
  142.         For example, to increase the size of the RAM disk by 64K bytes,
  143.         enter the following command to the DOS prompt:
  144.  
  145.              ADJRAM C: +64
  146.  
  147.         The spaces after "ADJRAM" and after "C:" are required.  The
  148.         drive letter (C:) will vary according to your system's
  149.         configuration.  Use whatever letter was displayed by AMDISK when
  150.         you booted the system.
  151.  
  152.         When ADJRAM is run, you should see something like this displayed
  153.         on your screen:
  154.  
  155.              Adjust Memory Disk (c) Copyright 1986 by Gary Cramblitt
  156.              Drive C:   Total Size: 64K        Free Space: 61K
  157.                       Desired Size: 128K    Desired Change: 64K
  158.              Allocating new 32K memory block #1
  159.              Allocating new 32K memory block #2
  160.  
  161.                         Memory Block Table
  162.              Block #      Paragraph      Size(sectors)
  163.              --------     ---------      -------------
  164.                 0            604              128
  165.                 1           26A9               64
  166.                 2           2EAA               64
  167.  
  168.         The drive letter displayed will vary, as I've already explained.
  169.         The exact paragraph numbers will also vary according to your
  170.         system configuration and whatever other software is loaded.
  171.  
  172.         ADJRAM always increments its size in 32K junks, called "memory
  173.         blocks".  The change you specify is always rounded up to the
  174.         next closest multiple of 32.  In the example above, two new 32K
  175.         memory blocks are created for th