home *** CD-ROM | disk | FTP | other *** search
/ Boston 2 / boston-2.iso / DOS / HILFEN / SYSTEM / RAMDISK3 / XDISK.DOC < prev    next >
Text File  |  1993-12-01  |  38KB  |  807 lines

  1.          ┌─────────────────────────────────────────────────────────────┐
  2.          │ Trademarked names are the property of the respective owners │
  3.          └─────────────────────────────────────────────────────────────┘
  4.               Copyright (c) 1989, 1990, 1991, F.M. de Monasterio
  5.                      Licensed Material - All rights reserved
  6.  
  7.                               xDISK version 3.00
  8.                               ------------------
  9.  
  10.   SUMMARY
  11.  
  12.   xDISK generates RAM disks in expanded memory and permits to vary the amount
  13.   of memory allocated to the disk(s) without rebooting the computer when used
  14.   with expanded memory conforming to the LIM 3.0+ specification (EMS). If DOS
  15.   version 3.xx or higher is used, the RAM disk can be collapsed completely to
  16.   free all of its EMS to another process (with DOS 2.10, the disk can be made
  17.   as small as 16 kbyte [an EMS page]).  Also, the RAM disk can be expanded to
  18.   use all of the available EMS or any intermediate size multiple of 16 kbyte,
  19.   sector size and number of root directory entries can be changed, and it can
  20.   be made to show visual clues of its activity.
  21.  
  22.   Security features include making the disk a Read-Only or Read-Write device,
  23.   locking/unlocking DOS access to the disk, and the enforcing of user-defined
  24.   password checks before the implementation of any command to the disk.
  25.  
  26.   Requires DOS 2.1 or later and expanded memory conforming to the LIM EMS 3.0
  27.   or later.  It is available in 086+, 286+, and 386+ CPU-type versions.
  28.  
  29.                                ----------------
  30.  
  31.   1.  GENERAL INFORMATION
  32.  
  33.   xDISK is a virtual-device driver system to generate (and modify) RAM disks in
  34.   expanded memory conforming to Lotus/Intel/Microsoft specification version 3.0
  35.   or higher.  Disk parameters can be modified without having to reboot the CPU,
  36.   although the data on the disk are lost during any disk resizing.
  37.  
  38.   This system consists of two programs: (1) XDISK.SYS, a block device driver to
  39.   be installed via CONFIG.SYS, after an EMS manager has been installed, and (2)
  40.   XDISK.EXE, a utility to communicate with the device driver via DOS and, thus,
  41.   to permit changing of one or more parameters of the specified xDISK RAM disk.
  42.  
  43.   The XDISK.SYS and XDISK.EXE files of a given version are matched and will not
  44.   work with those of other versions of the program.  Requires MS DOS/IBM-PC DOS
  45.   version 2.1 or later, and an EMM complying with the EMS LIM 3+ specification.
  46.   The 286 version of the program requires an 80286 CPU or higher; it is smaller
  47.   and faster than the 086 version (any 80x86 CPU).  The 386 version requires an
  48.   80386 CPU or higher; it is faster than the 286 and 086 versions.
  49.  
  50.   xDISK RAM disks are compatible with the CHKDSK utility of DOS as well as with
  51.   other disk utilities (such as NDD) that sometimes encounter difficulties with
  52.   other resizable RAM disks. Starting with version 2.50, the boot sector of the
  53.   xDISK RAM disks complies with the DOS 4.0x format.
  54.  
  55.  
  56.   1.1  RAM DISK IDENTIFICATION & DOS VERSION
  57.  
  58.   DOS assigns the first available drive letter to a RAM disk within the default
  59.   range A to E or, for DOS ≥3.00, the range A to Z if the command <LASTDRIVE=Z>
  60.   is included in CONFIG.SYS. Such a letter is shown by XDISK.SYS when using DOS
  61.   ≥3.00, but it is not shown when using an earlier DOS version. xDISK disks can
  62.   be identified by the volume label and time of creation, as well as by the OEM
  63.   identification in the boot sector, all of which are determined by the version
  64. | of xDISK.  When executed in a CPU i286 or higher, the date of creation of the
  65. | RAM disk is the current date in the CMOS chip; for an 8088/8086 CPU, the date
  66. | of creation is that of the assembly of the xDISK version.
  67.  
  68.  
  69.   1.2  DIRECT DRIVER COMMUNICATION
  70.  
  71.   Starting with version 2.52, the device header of each XDISK.SYS installed has
  72.   the string:
  73.  
  74.                           [-1]xDISK[0]unit:[0]<d>[-1]
  75.  
  76.   where the start and ending delimiter bytes [-1] contain the hexadecimal value
  77.   of 0FFh, the null separator bytes [0] contain 0, and the drive designator <d>
  78.   is the upper-case letter assigned to this RAM disk (DOS ≥ 3.0) or a null byte
  79.   (DOS < 3).
  80.  
  81.   The identifying string is used to locate the driver for direct communications
  82.   between XDISK.EXE and XDISK.SYS.  Note that when this string does not contain
  83.   a designator letter (as when using DOS 2.10), switches /A, /P, /R, and /V can
  84.   only be assigned to the first XDISK.SYS driver found in memory.
  85.  
  86. | When XDISK.EXE is executed, the program searches memory for the corresponding
  87. | identifying string. When the correct drive is not specified or the driver has
  88. | been installed in upper-conventional memory, the search may extend as high as
  89. | the initial 1 Mb of memory (see below).
  90.  
  91.                                ----------------
  92.  
  93.   2.0  COMMAND SYNTAX
  94.  
  95.   A. XDISK.SYS must be installed via the CONFIG.SYS file on the boot disk after
  96.   the LIM-3+ EMS manager has been installed (the filename of such an EMS driver
  97.   varies with the manufacturer, but its code must include the string EMMXXXX0):
  98.  
  99.              Device=[d:][\path\]XDISK.SYS [/B][/C][/D][/E][/L][/S]
  100.  
  101.   where <d:> and <\path\>, when specified, are the drive and path specification
  102.   for the XDISK.SYS file. See below for an explanation of the switches.
  103.  
  104.  
  105.   B. After the xDISK driver has been loaded and the RAM disk created, XDISK.EXE
  106.   allows for modification of the RAM disk parameters from the DOS command line:
  107.  
  108.            XDISK [x:] [/A][/B][/C][/D][/E][/N][/P][/Q][/R][/S][/V][[/]?]
  109.  
  110.   x   This is the drive designator letter, followed by <:>, that identifies the
  111.       xDISK drive. The use of letters for non-xDISK drives and for non-existing
  112.       drives generates separate error messages (IOctl error 1 and F). Defaults:
  113.       Null drive, no colon or x=<ASCII 21-40> = Current drive letter.
  114.  
  115.                                ----------------
  116.  
  117.   2.1  SWITCHES
  118.  
  119.   The switches are not case sensitive and most must be preceded by a slash [/].
  120.   If the RAM disk is being resized (i.e., /Bn/Sn/Dn/C/E), non-resizing switches
  121.   must be specified AFTER the resizing switch(es).
  122.  
  123.   NOTE:  When xDISK is invoked without any switch (or when the switches are not
  124.   preceded by slashes [and thus are ignored]), the status of the xDISK drive is
  125.   displayed on the DOS command line.  Except during the XDISK.SYS installation,
  126.   such a null-switch call does not change any RAM disk parameters. During xDISK
  127.   installation, however, default values for switches /B, /D, and /S are used if
  128.   the corresponding switch is not specified.
  129.  
  130.   ----------------------------------------------------------------------------
  131.       Asterisks mark switches available only in registered copies of xDISK
  132.   ----------------------------------------------------------------------------
  133.  
  134. * A±  Open [+] and close [-] the DOS-mediated access to the specified RAM disk.
  135.       Defaults: /A = /A+.
  136.  
  137.                                    -------
  138.  
  139.   Bn  Disk size in kilobytes, where <n> is in the range between 16 and 32768 in
  140.       16-kbyte steps; when <n> is not a 16-kbyte multiple, size is increased to
  141.       the nearest larger multiple available. Unless switch /Q or /N is enabled,
  142.       this resizing change necessitates confirmation by the user.
  143.  
  144.       Defaults: In the CONFIG.SYS file, null switch or null <n> = /B64. In the
  145.       command line of DOS, /B = /B64; null switch is ignored.
  146.  
  147.                                    -------
  148.  
  149. * C   Collapses the RAM disk to a size of 0 kb (DOS ≥3.0) or 16 kb (DOS <3.0).
  150.       Unless switch /Q or /N is enabled, collapse necessitates confirmation by
  151.       the user; a 0-kb collapse does not change the existing /D and /S values,
  152.       but a 16-kb collapse also sets /D=4 and /S=128.
  153.  
  154.       If a 0-kb collapse has occurred, a DOS-mediated request to the disk will
  155.       trigger an error message of the following type for DOS 3.XX:
  156.  
  157.                      Not ready error reading drive E
  158.                      Abort, Retry, Fail?
  159.  
  160.       whereas for DOS 4.0X some disk-access commands will trigger this message
  161.       (e.g. 'CHKDSK E:'):
  162.  
  163.                      Invalid drive specification
  164.                      Invalid media type
  165.  
  166.       and others this message (e.g. 'DIR E:'):
  167.  
  168.                       Not ready reading drive E
  169.                       Abort, Retry, Fail?
  170.  
  171.       Answer the "Abort, Retry, Fail?" by pressing <A> to quit the DOS critical
  172.       error handler and return to the DOS prompt. The "not ready" error message
  173.       is a remainder that the RAM disk exists, but is collapsed.
  174.  
  175.  
  176.       The 0-kbyte collapse can be restored only by using switch /B or /E; other
  177.       switches do not change the disk size. The following EMS measurements were
  178.       obtained as described by the headers:
  179.  
  180.          Upon booting with /B16/S128/D4:     2800 kbytes total EMS
  181.                                               576 kbytes used by process  0
  182.                                                16 kbytes used by process  1 <-
  183.                                               768 kbytes used by process  2
  184.                                              1440 kbytes free
  185.  
  186.          Upon collapsing disk with /C:       2800 kbytes total EMS
  187.                                               576 kbytes used by process  0
  188.                                               768 kbytes used by process  2
  189.                                              1456 kbytes free
  190.  
  191.          Upon expanding disk with /E:        2800 kbytes total EMS
  192.                                               576 kbytes used by process  0
  193.                                              1456 kbytes used by process  1 <-
  194.                                               768 kbytes used by process  2
  195.                                                 0 kbytes free
  196.  
  197.                                    -------
  198.  
  199.   Dn  Number of allowed entries (files) in the root directory, where <n> is in
  200.       the range between 4 and 512.  If the minimum value of 4 entries has been
  201.       selected, the number of entries is increased to 8 or 16 when a sector of
  202.       size 256 or of 512 bytes is also selected.  Unless switches /Q or /N are
  203.       enabled, this resizing change necessitates confirmation by the user.
  204.  
  205. |     NOTE
  206. |     If a sufficient number of entries is not available, commands to write to
  207. |     the disk will trigger critical error messages of a 'File Creation Error'
  208. |     To decrease this possibility, expanding the disk to the maximum EMS size
  209. |     via switch /E changes the number of root directory entries to 512.  If a
  210. |     smaller number of entries is needed, follow switch /E with /Dn.
  211.  
  212.       Defaults: In the CONFIG.SYS file, null switch or null <n> = /D64. In the
  213.       command line of DOS, /D = /D64; null switch is ignored.
  214.  
  215.                                    -------
  216.  
  217. * E   Expands the disk to the maximum available EMS size. If switch /Dn is not
  218. |     also specified, it sets the directory entries to /D512. Unless switch /Q
  219.       or /N is enabled, this expansion necessitates confirmation by the user.
  220.  
  221.                                    -------
  222.  
  223. * Ln  Instructs the program to load its resident in high memory between 640 kb
  224. |     and 1,024 kb, i.e. below the 1 Mb boundary of conventional RAM but above
  225. |     the memory area normally controlled by DOS.  The switch requires that an
  226. |     extended memory manager (XMM) supporting the services of the XMS 2.00 is
  227. |     installed and that a free upper memory block (UMB) of a little less than
  228. |     2 kb is available. The XMM must support functions 10h (Allocate UMB) and
  229. |     11h (Free UMB).
  230. |
  231. |     Unlike the high-memory loading provided by 386 memory managers, the size
  232. |     of the free UMB is that of the resident, and not that of the entire code
  233. |     of XDISK.SYS; a few additional bytes are used by XMS when allocating the
  234. |     UMB.  (See High Memory Installation section.)
  235. |
  236. |     A low high-memory limit for the UMB can optionally be specified via <n>,
  237. |     a hexadecimal number between A000 (640 kb) and FFFF (1,024 kb), so as to
  238. |     avoid specific areas of upper memory with a slow access time. UMB access
  239. |     times are provided by some memory managers, e.g., QEMM386 (Quarterdeck),
  240. |     386MAX (Qualitas), but not by others, e.g., HIMEM.SYS (Microsoft).  More
  241. |     detailed UMB-access timings are provided by the utility TIMEM.EXE, which
  242. |     is enclosed in this software release of xDISK (see also TIMEM.DOC).
  243. |
  244. |     Defaults:  Lower-memory installation, if any errors are found during the
  245. |     UMB loading.  High-memory installation below requested lower limit if no
  246. |     UMB is available above such limit.
  247.  
  248.                                    -------
  249.  
  250. * N   Nulls the displaying of disk status, user confirmation request, and error
  251.       messages; errors can still be detected within a batch file with the ERROR
  252.       LEVEL command. Because the disk status display is generated by the driver
  253.       via BIOS calls, the messages cannot be redirected by DOS; use of switch N
  254.       produces the same result as a redirection to the NUL device. The RAM disk
  255.       configuration parameters are preserved.
  256.  
  257.                                    -------
  258.  
  259. * Px± Demand password before implementing changes; password consists of 1 to 15
  260.       lower-case, pure alphanumeric characters followed by <Enter>.  Use /Px to
  261.       (re)define a password, where <x> is 1 to 15 alphanumeric lower-case [0-9,
  262.       a-z] characters followed by a space; use /P- to disable and /P+ to enable
  263.       the password requirement.  Defaults: /P = /P+.
  264.  
  265. |     Pressing <Esc> or <Break> during password testing returns the user to the
  266. |     DOS command line. The typing of an incorrect character during the testing
  267. |     vitiates prior accepted (correct) characters, and the entire password has
  268. |     to be retyped. Note that warmbooting via <Ctrl-ALt-Del> is not suppressed
  269. |     during password testing (rebooting destroys the RAM disk data).
  270. |
  271. |     The password is useful in situations when more than one user has acces to
  272. |     the RAM disk (i.e., a server) and, after copying the common-access files,
  273. |     the disk is made Read-Only to protect its contents.
  274.  
  275.                                    -------
  276.  
  277.   Q   Quiet resizing. Disables the default prompt for user's confirmation prior
  278.       to disk resize/format operations that destroy all data on the RAM disk.
  279.  
  280.                                    -------
  281.  
  282. * R±  Make the disk a Read-Only [+] or Read-Write [-] device; the current write
  283.       status is indicated by [RO] or [RW] icons in the configuration message. A
  284.       Read-Only status does not allow for file changes or resizing of the disk.
  285.       RAM disk configuration parameters are preserved.  Defaults: /R = /R+.
  286.  
  287.                                    -------
  288.  
  289.   Sn  Sector size in bytes, where <n> is 128, 256, or 512. Select a small value
  290.       if storing small files; large values will reduce reading and writing time
  291.       if storing larger files. Unless switch /Q or /N is enabled, this resizing
  292.       change necessitates confirmation by the user.
  293.  
  294.       Defaults: In the CONFIG.SYS file, null switch or null <n> = /S256. In the
  295.       command line of DOS, /S = /S256; null switch is ignored.
  296.  
  297.                                    -------
  298.  
  299. * V±  Turn ON [+] or OFF [-] the display of a "" on the top-left corner of the
  300.       screen whenever xDISK is active due to a DOS request. The disk parameters
  301.       are preserved. If the display is on, the icon "" is displayed along with
  302.       the drive status in answer to the switch /? or <d:>? (see below).
  303.  
  304.                                    -------
  305.  
  306.   ?   When preceded by a valid xDISK designator, ? or /? displays the status of
  307.       the RAM disk. In the absence of a drive designator, ? displays the syntax
  308.       help panel, while /? attempts to display the status of the default drive.
  309.       It is the only switch that preserves a Read-Only status for the RAM disk.
  310.  
  311.                                ----------------
  312.  
  313.   2.2  COMMENTS
  314.  
  315.   Comments may be added in the command after the desired switches. The comments
  316.   (which may be useful in batch files) must be preceded by a semicolon (;), and
  317.   are ignored by xDISK.
  318.  
  319.   NOTE: Do not use DOS redirection (<>) and pipe (|) characters in comments, as
  320.   DOS will attempt to implement the implied redirection/pipe request.
  321.  
  322.                                 ----------------
  323.  
  324.   3.0  DOS ERRORLEVEL
  325.  
  326.   XDISK.EXE passes to DOS execution status values that can be tested in batch
  327.   files via the ERRORLEVEL command; the following are values for version 2.52
  328.   or later:
  329.  
  330.                 Value   Condition
  331.                 -----   --------------------------------------
  332.                   255   Cyclical Redundancy Check failure
  333.                   254   286 version executed in non-286+ machine
  334.                    16   Invalid expanded memory manager/version
  335.                     8   Unknown or invalid switch request
  336.                     4   DOS access to driver has been closed
  337.                     2   Invalid character is password string
  338.                     1   Resize attempt of Read-Only disk
  339.                     0   Succesful execution
  340.  
  341.                                 ----------------
  342.  
  343.   4. DRIVER INSTALLATION
  344.  
  345.   XDISK.SYS must be installed via CONFIG.SYS.  In the registered licensed copy,
  346.   the installation of XDISK.SYS can be skipped by pressing the <Esc> key before
  347.   the initialization of the driver is completed, e.g., before the xDISK message
  348.   is displayed. Such a keypress interrupts the installation until the following
  349.   abort query in answered by pressing <Y> for 'YES' or <N> for 'NO':
  350.  
  351.                XDISK.SYS: <Esc> pressed ─ Abort installation? [yn]
  352.  
  353.   The avoidance of installation produces no memory penalty in DOS versions 3.30
  354.   or higher, and uses 80 bytes (286+ or 386+ version) of conventional memory in
  355.   earlier DOS versions.
  356.  
  357. | When XDISK.EXE is executed and the corresponding driver identification string
  358. | found, the memory segment of the (selected disk) xDISK driver is displayed in
  359. | the Help Status panel preceded by the initials UMB if the driver is installed
  360. | upper conventional memory.  The memory segment of a lower-memory installation
  361. | is displayed only when the <F10>+<Alt> keys are pressed simultaneously.
  362.  
  363.                                     --------
  364.  
  365.    4.1 INSTALLATION ERRORS
  366.  
  367.    The following errors fail the installation of the driver:
  368.  
  369.         A. Invalid CRC - Driver has been corrupted
  370. |       B. Invalid CPU type - Needs i286/i386 or higher
  371.         C. Invalid DOS version - Needs 2.1 or later
  372.         D. Failure to detect presence of an EMM driver
  373.         E. Expanded memory allocation error (LIM code)
  374.         F. Expanded memory EMM status error (LIM code)
  375.         G. Expanded memory page frame error (LIM code)
  376.  
  377. |  See below for an explanation of driver error messages (section 6).
  378.  
  379.                                     --------
  380.  
  381.    4.2  HIGH-DOS MEMORY INSTALLATION
  382.  
  383.    DIRECT UMB LOADING
  384.  
  385. |  Starting with version 3.00, xDISK can load itself directly in high memory
  386. |  (RAM addresses between 640 kb and 1,024 kb) via switch /L. Such a loading
  387. |  is mediated by an XMS manager (XMM) version 2.0, such as the driver HIMEM
  388. |  .SYS (Microsoft), which must be installed prior to the loading. Some 386-
  389. |  memory managers (386MAX version 4.09, and QEMM version 5.11, for example)
  390. |  provide XMS support as well.  All XMMs require DOS version 3.0 or later.
  391. |
  392. |  For the loading to be successful, an upper memory block (UMB) of the size
  393. |  of the resident part of XDISK.SYS (about 2 kb) plus an additional 48-byte
  394. |  block used by the XMM must be available.
  395. |
  396. |  Switch /Ln, where A000 ≤ n ≤ FFFF (hexadecimal), allows the specification
  397. |  of a lower high-memory bound for the UMB, to avoid high-memory areas with
  398. |  a very slow access time.
  399. |
  400. |  Hence, compared to the high-memory installation provided by some (but not
  401. |  all) memory managers, direct UMB loading has two major advantages: (1) it
  402. |  does not need an initial free block of high memory the size of the entire
  403. |  program, as opposed to the resident size, to be available, and (2) allows
  404. |  some user control on the selection of the high-memory block.
  405.  
  406.                                     --------
  407.  
  408.    LOADING VIA 386-MEMORY MANAGERS
  409.  
  410.    The XDISK.SYS driver can also be loaded into high memory via 386-specific
  411.    memory managers, provided that there is enough high-memory for the entire
  412.    size of the driver plus any additional memory that may be required by the
  413.    loading utility.
  414.  
  415.  
  416.    4.3  HIGH-DOS MEMORY UPDATING
  417.  
  418.    Updating the xDISK driver is accomplished either via DOS-mediated requests
  419.    to the driver or via a direct updating of the driver by XDISK.EXE (without
  420.    the intervention of high-DOS memory utilities).
  421.  
  422.                                 ----------------
  423.  
  424. |  5.  MESSAGES of XDISK.EXE
  425. |
  426. |
  427. |  5.1   "Bad CRC: Code corrupted ─ Execution cancelled"
  428. |  A failure of the 32-bit cyclical redundancy check was encountered when the
  429. |  program was executed.
  430. |
  431. |                                   --------
  432. |
  433. |  5.2a  "Cannot execute 286 code ─ Execution cancelled"
  434. |  286+ program versions cannot be executed in 8088, 8086 or (most) 80186 CPU
  435. |  machines.
  436. |
  437. |                                   --------
  438. |
  439. |  5.2b  "Cannot execute 386 code ─ Execution cancelled"
  440. |  386+ program versions cannot be executed in 8088, 8086, 80186 or 80286 CPU
  441. |  machines.
  442. |
  443. |                                   --------
  444. |
  445. |  5.3   "Needs DOS 2.10 or later ─ Execution cancelled"
  446. |  An MS-DOS/IBM-PC DOS version equal to or greater than 2.10 is required for
  447. |  proper execution.
  448. |
  449. |                                   --------
  450. |
  451. |  5.4   "Needs LIM EMS 3.00 or higher ─ Execution cancelled"
  452. |  An extended-memory manager version equal to or greater than version 3.0 of
  453. |  the Lotus/Intel/Microsoft extended memory specification (EMS) is needed for
  454. |  proper execution.
  455. |
  456. |                                   --------
  457. |
  458. |  5.5   "Unknown video card/Incompatible CRT controller"
  459. |  The type of video adapter could not be determined, or the video controller
  460. |  chip was found to be incompatible. Execution is cancelled.
  461. |
  462. |                                   --------
  463. |
  464. |
  465. |  5.6   "Driver parameter(s) updated"
  466. |  The program was successfully executed, and the (selected disk) XDISK.SYS
  467. |  driver parameters specified by the requested switches were updated.
  468. |
  469. |                                   --------
  470. |
  471. |  5.7   "Invalid switch '/Xx' ─ Execution aborted"
  472. |  An invalid switch designator (X) or switch parameter (x) was selected.
  473. |  Execution is cancelled.
  474. |
  475. |                                   --------
  476. |
  477. |  5.8   "Drive 'd:' is not an xDISK RAM disk"
  478. |  The selected drive <d:> is not a RAM disk created by XDISK.SYS. Execution
  479. |  is cancelled.
  480. |
  481. |                                   --------
  482. |
  483. |  5.9   "'d:' is an invalid drive designator"
  484. |  The selected drive <d:> does not exist or DOS does not consider it a valid
  485. |  disk drive designator. Execution is cancelled.
  486. |
  487. |                                   --------
  488. |
  489. |  5.10  "Device driver XDISK.SYS is corrupted or not loaded"
  490. |  XDISK.EXE was unable to find the resident code signature of an XDISK RAM
  491. |  disk driver. Execution is cancelled.
  492. |
  493. |                                   --------
  494. |
  495. |  5.11  "XDISK.SYS malfunction ─ [Error XXh]"
  496. |  The (selected disk) XDISK.SYS driver has passed back to XDISK.EXE an error
  497. |  code indicating a driver malfunction (xx). The following hexadecimal codes
  498. |  may be passed:
  499. |
  500. |        Code 00h: Write-protect violation
  501. |        Code 01h: Unknown unit
  502. |        Code 02h: Drive Not Ready
  503. |        Code 03h: Unknown Command
  504. |        Code 08h: Sector Not Found
  505. |
  506. |                                   --------
  507. |
  508. |  5.12  "Unable to access XDISK.SYS ─ [IOctl error XXh]"
  509. |  XDISK.EXE communicates with the XDISK.SYS driver via IOCTL (Input/Output
  510. |  Control) DOS function calls.  The message is displayed if DOS encounters
  511. |  any error during the IOCTL call; a number of hexadecimal error codes are
  512. |  possible, but those more likely to be found are listed below:
  513. |
  514. |        Code 01h: Invalid Function Code (a non-xDISK drive was selected)
  515. |        Code 0Fh: Invalid Disk Drive (a non-existing drive was selected)
  516. |        Code 05h: Access denied (drive corrupted)
  517. |        Code 0Dh: Data invalid (drive corrupted)
  518. |
  519. |                                   --------
  520. |
  521. |  5.13  "DOS access to XDISK.SYS is closed ─ Use switch /A"
  522. |  Access to the (selected disk) XDISK.SYS driver was previously closed via
  523. |  switch /A-; access can be restored via switch /A[+].
  524. |
  525. |                                   --------
  526. |
  527. |  5.14  "Cannot resize RAM disk with Read-Only status - Use switch /R"
  528. |  The status of the (selected disk) XDISK.SYS driver was previously set to
  529. |  Read-Only via switch /R[+]; the status must be changed to Read-Write via
  530. |  switch /R- before the disk can be resized.
  531. |
  532. |                                   --------
  533. |
  534. |  5.15  "Resizing of drive 'd:' failed ─ [xDISK error XXh]"
  535. |  Requested resizing could not be accomplished.  The (selected disk) XDISK
  536. |  .SYS driver passes a hexadecimal error code reflecting the nature of the
  537. |  error (see 6.1).
  538. |
  539. |                                   --------
  540. |
  541. |  5.16  "Data in drive 'd:' will be lost upon resizing ─ Continue? [yN] "
  542. |  This prompt is displayed before any disk resizing operation if switch /N
  543. |  or /Q (see above).
  544. |
  545. |                                   --------
  546. |
  547. |  5.17  "DOS unable to access xDISK drive"
  548. |  This message is displayed when the (selected disk) XDISK.SYS driver was
  549. |  made inactive (/A-) and the status of the disk is requested by entering
  550. |  'XDISK d: ?'
  551. |
  552. |                                   --------
  553. |
  554. |  5.18  "xDISK drive(s) installed ─ d:, d:,..., d:"
  555. |  This message, listing the xDISK drives installed, is displayed when the
  556. |  global status of the XDISK.SYS driver is requested by entering 'XDISK ?'
  557. |
  558. |                                   --------
  559. |
  560. |  5.19  "Invalid character in password string: x"
  561. |        "Use lower case alphanumeric (a-z 0-9) characters only"
  562. |  An invalid character (i.e., neither a-z nor 0-9) was entered as part of
  563. |  the requested password.  Execution is cancelled.
  564. |
  565. |                                   --------
  566. |
  567. |  5.20  "Password assigned to first xDISK driver installed"
  568. |  This message is displayed only when running xDISK under a DOS version less
  569. |  than 3.00, and a password to access xDISK was specified.
  570.  
  571.                                 ----------------
  572.  
  573.  
  574. |  6.  MESSAGES of XDISK.SYS
  575. |
  576. |  6.1   "CRC failure: Code is corrupted"
  577. |  See message 5.1 above.
  578. |
  579. |                                   --------
  580. |
  581. |  6.2a  "This CPU cannot execute 286 code"
  582. |  See message 5.2a above.
  583. |
  584. |                                   --------
  585. |
  586. |  6.2b  "This CPU cannot execute 386 code"
  587. |  See message 5.2b above.
  588. |
  589. |                                   --------
  590. |
  591. |  6.3   "Needs DOS version 2.1 or higher"
  592. |  See message 5.3 above.
  593. |
  594. |                                   --------
  595. |
  596. |  6.4   "Failed to detect presence of an EMM driver"
  597. |        "Installation aborted"
  598. |  xDISK failed to determine presence of an expanded memory manager (EMM)
  599. |  compatible with the LIM EMS version 2.0, and failed the installation.
  600. |
  601. |                                   --------
  602. |
  603. |  6.5   "Expanded memory allocation error [EMS code XXh]"
  604. |  6.6   "Expanded memory page frame error [EMS code XXh]"
  605. |  6.7   "Expanded memory EMM status error [EMS code XXh]"
  606. |  The EMS manager encountered an error in allocating expanded memory for
  607. |  the xDISK driver (6.5), in setting up the page frame (6.6), or the EMS
  608. |  manager (EMM) itself malfunctioned (6.7).  A number of hexadecimal EMS
  609. |  error codes are possible, but those more likely to be found are listed
  610. |  below:
  611. |
  612. |        Code 80h: EMM internal error (manager corrupted)
  613. |        Code 81h: EMS hardware error
  614. |        Code 82h: EMM is busy
  615. |        Code 85h: Handles are exhausted
  616. |        Code 86h: Error in saving or restoring mapping context
  617. |        Code 87h: Requested more pages than physically available
  618. |        Code 88h: Requested more pages than currently available
  619. |
  620. |                                   --------
  621. |
  622. |  6.8   "Error in allocating upper memory block [XMS code xxh]"
  623. |        "Install in lower conventional memory? [Yn] "
  624. |  The XMS manager encountered an error in allocating a UMB for the upper-
  625. |  memory self-loading, or the XMS manager is not present.  The following
  626. |  hexadecimal error codes may be displayed:
  627. |
  628. |        Code 80h: Function was not implmented
  629. |        Code 8Eh: General driver error (also XMM not present)
  630. |        Code 8Fh: Unrecoverable driver error occurred
  631. |        Code A9h: Parity error was detected
  632. |        Code B0h: Smaller UMB is available
  633. |        Code B1h: No UMBs are available
  634. |        Code B2h: UMB segment number is invalid
  635. |
  636. |                                   --------
  637. |
  638. |  6.9   "XMM failed to allocate UMB above requested limit"
  639. |  An free upper-memory block was not available above the lower high-memory
  640. |  limit specified by switch /Ln; xDISK installed the driver at a lower UMB
  641. |  whose value is displayed in the installation message.
  642. |
  643. |                                   --------
  644. |
  645. |  6.10    "<Esc> was pressed ─ Cancel installation? [Yn] "
  646. |  The <Esc> key was pressed during the installation of an XDISK.SYS driver
  647. |  before it could be completed.  Press <Enter> or <Y> if you want to abort
  648. |  the installation, or <N> to continue installing the driver.
  649.  
  650.  
  651.  ------------------------------------------------------------------------------
  652.  
  653.                   SINGLE USER (BBS-DISTRIBUTED) LICENSE AGREEMENT
  654.  
  655.    REGISTRATION
  656.  
  657.    These programs and the documentations (the "Software") are the copyrighted
  658.    property of FM de Monasterio (the "author"), who provides the Software and
  659.    licenses its use.  Neither the title to nor ownership of this Software are
  660.    transferred to you by such a license, and both are retained by the author.
  661.    All rights are reserved.
  662.  
  663.    The Software is user-supported; the enclosed release, although lacking the
  664.    options marked by asterisks, is a fully usable program.  You may test this
  665.    release for (in)compatibilities with your system, but after the testing is
  666.    completed you are requested to order a registered release of this Software
  667.    from the address below.
  668.  
  669.    Alternatively, to continue use of this unregistered copy, send to the same
  670.    address a US$5.00 check marked "For Deposit Only," and payable to "PATIENT
  671.    CARE FUND, CHILDREN'S HOSPITAL" of Washington, DC.  Unregistered users who
  672.    donate to this fund may legally keep such a copy under the injunctions and
  673.    limitations described below.
  674.  
  675.    A form needed for the registration or upgrade of this Software is provided
  676.    in the file XDISK.REG.  Refer all inquiries about the Software to:
  677.  
  678.                                                    FM de Monasterio
  679.                                                    P.O. Box 219
  680.                                                    Cabin John, MD 20818-0219
  681.    LICENSE
  682.  
  683.    Upon registration you receive a non-exclusive, non-transferable license to
  684.    use the Software. Two types of license are available:
  685.  
  686.    Single User License:
  687.    Upon registration/upgrade you are granted a nontransferable license to use
  688.    the Software in a single computer at a time. You may transfer the Software
  689.    physically to another computer provided that the Software is then not used
  690.    on more than one computer at any time. This particular Software may NOT be
  691.    installed on a network server under this license.
  692.  
  693.    Site/10-Computer License:
  694.    Upon registration/upgrade you are granted a nontransferable license to use
  695.    the Software in a single site or a set of sites provided that the Software
  696.    is not used in more than ten computers at any time and that such computers
  697.    are located exclusively within the registered site(s). Installation of the
  698.    Software in a network server requires a site license.  Special licenses at
  699.    are available for sites with a larger number of computers (see xDISK.REG).
  700.    
  701.  
  702.    UPGRADES
  703.  
  704.    Within the same major version:  Registered Software users can upgrade free
  705.    of charge within the same major version (e.g., 2.00 through 2.99).
  706.  
  707.    Outside the same major version:  Registered users can upgrade for half the
  708.    the license fee for a different version of the Software.
  709.  
  710.    To upgrade send a self-addressed stamped diskette mailer with the original
  711.    360 kb diskette to the address above, along with the upgrade form.
  712.  
  713.  
  714.    SUPPORT
  715.  
  716.    Limited technical support is provided to registered users. If you discover
  717.    a problem, please try to replicate it under the same conditions and, then,
  718.    in the absence of other resident programs. (Changes in the order residents
  719.    are installed sometimes solve conflicts.) If the problem can be replicated
  720.    please write at the address above providing:
  721.  
  722.                 - Your name and address.
  723.                 - Program version number (see the Syntax/Help panel).
  724.                 - Computer model and configuration, and hardware used.
  725.                 - A sufficiently detailed description of the problem.
  726.                 - A list of resident and nonresident programs in use,
  727.                   and their sequence of loading into memory.
  728.  
  729.  
  730.    Messages may be left c/o Sysop at:    The DC Information Exchange BBS
  731.                         ~~~              202-433-6639, Sysop: Bill Walsh
  732.                                          (2400+ baud).
  733.  
  734.  
  735.    INJUNCTIONS
  736.  
  737.    You may distribute this Software via magnetic and/or electronic means, but
  738.    you are specifically prohibited from:
  739.  
  740.                 - Charging fees or asking donations in exchange of or payment
  741.                   for copies of the Software.
  742.                 - Distributing this Software with commercial products without
  743.                   the written permission from the author.
  744.                 - Distributing this Software via a for-profit organization or
  745.                   group, either alone or with other Software.
  746.  
  747.    The unauthorized copying, decompiling or disassembling of this Software is
  748.    prohibited; any other use of this Software is prohibited without a written
  749.    permission in advance from the author.
  750.  
  751.  
  752.    LIMITED WARRANTY
  753.  
  754.    The author-copyright owner warrants for a period of thirty (30) days from
  755.    the date of delivery that, under normal use and without any modification,
  756.    the programs substantially conform to the accompanying specifications and
  757.    that the documentation is substantially complete and contains information
  758.    the author deems necessary to use the programs. If, during the thirty-day
  759.    period, a demonstrable defect in the programs, magnetic medium upon which
  760.    they are distributed, or documentation should appear, you may return this
  761.    Software for repair or replacement, at the author's option. If the defect
  762.    cannot be repaired, or the Software replaced with functionally equivalent
  763.    software, within sixty (60) days of the author's receipt of the defective
  764.    software, then you shall be entitled to a full refund of the license fee,
  765.    but not of the mailing/handling costs described in the registration form.
  766.  
  767.    All other warranties of any kind, either express or implied,including but
  768.    not limited to the implied warranties of  merchantability and fitness for
  769.    for as a particular purpose, are expressly excluded.
  770.  
  771.    The author cannot and does not warrant that any function contained in the
  772.    programs will meet your requirements, or that the operation will be error
  773.    free. The entire risk as to the Software performance or quality, or both,
  774.    is solely with the user, and not with the author.
  775.  
  776.  
  777.    LIMITATION OF REMEDIES
  778.  
  779.    You assume responsibility for the selection of the program to achieve your
  780.    intended results, and for the installation, use, and results obtained from
  781.    the Software.
  782.  
  783.    The author makes no warranty, either implied or expressed, including with-
  784.    out limitation any warranty with respect to this Software documented here,
  785.    its quality, performance, or fitness for a particular purpose. In no event
  786.    shall the author be liable to you for damages, whether direct or indirect,
  787.    incidental, special, or consequential arising out the use of or any defect
  788.    in the Software, even if the author has been advised of the possibility of
  789.    such damages, or for any claim by any other party.
  790.  
  791.    The author's entire liability, and your exclusive remedy shall be: (1) the
  792.    replacement of an original Software diskette not meeting the above Limited
  793.    Warranty and which is returned to the author along with proof of purchase,
  794.    or (2), if the author is unable to deliver a replacement diskette which is
  795.    free of defects, you may terminate the License Agreement by returning this
  796.    Software and the corresponding license fee will be returned.
  797.  
  798.  
  799.    GENERAL
  800.  
  801.    By using the Software, you acknowledge (1) to have read and understood all
  802.    parts of this document and (2) to have agreed with and accepted all of its
  803.    provisions without any reservation.
  804.  
  805.  ------------------------------------------------------------------------------
  806.    [END]
  807.