home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / s / simic104.zip / INSTALL.DOC < prev    next >
Text File  |  1993-01-29  |  7KB  |  172 lines
  1.          MS-DOS 386/486 Installation Guide for SIMIC Program
  2.          ---------------------------------------------------
  3.  
  4. **** IMPORTANT - This package contains two SIMIC executables.  Read this
  5. documentation to install the correct version for your configuration.  In
  6. order for either program to operate properly, you cannot disable EMS.
  7. For example, if you are using EMS386, do not use the NOEMS option.
  8.  
  9. Overview - Installing SIMIC Version 1.0
  10. ---------------------------------------
  11.  
  12. The Student Version of SIMIC comes in two flavors, DPMI and VCPI.
  13.  
  14. The recommended version to install is DPMI.  The DPMI version uses the DPMI
  15. memory management scheme for virtual memory.  A test program TESTENV.EXE
  16. is provided to determine whether your configuration is compatible with
  17. this version.  If you are running Windows, the DPMI version is manditory.
  18.  
  19. If your computer is configured with a VCPI manager, then this manager may
  20. prevent the DPMI version from executing, due to lack of available memory.
  21. The QEMM manager supports a QDPMI driver extension that allows both memory
  22. management schemes to coexist well together.  To run the DPMI version under
  23. Desqview (or Desqview/X) the QDPMI driver extension must be
  24. installed, and the Desqview utility NODESQ.COM must be run prior to
  25. running SIMIC.
  26.  
  27. If the test program TESTENV shows that your configuration is incompatible
  28. with the DPMI version, then you must either change the configuration, or
  29. use the VCPI version.  Installation of the VCPI version is covered at
  30. the end of this document.  The VCPI version has been benchmarked to
  31. be 50% slower than the DPMI version and cannot run under windows or OS/2.
  32.  
  33. Installing the DPMI version
  34. ---------------------------
  35.  
  36. The DPMI version is found in the DPMI directory, along with any supporting
  37. programs for this version.
  38.  
  39.     (1)    Run the TESTENV program. If no errors occur, then continue to Step
  40.            (2), otherwise see TESTENV description below to determine the
  41.            course of action. You may delete TESTENV.EXE and TESTPENV.EXE from
  42.            your hard disk as they are no longer needed.
  43.  
  44.     (2)    If you plan to run SIMIC under windows and do not have a floating
  45.            point coprocessor, you must install the floating point emulator,
  46.            VEMD.386.  Add this device to the system.ini windows file.  For
  47.            example:
  48.  
  49.                 device=c:\simic\vemd.386
  50.  
  51.        You must then re-start windows to complete installation.  You must
  52.        also create the appropriate .pif file for SIMIC.
  53.  
  54. Configuration Tests (TESTENV.EXE)
  55. --------------------------------
  56.  
  57.     Intel provides configuration tests to verify that your current system 
  58.     configuration is compatible with the C Code Builder run-time environment. 
  59.     If the tests show that you have an incompatible processor or coprocessor, 
  60.     we recommend replacing the component.
  61.  
  62.     To run the configuration tests, enter the following command at the DOS 
  63.     prompt:
  64.     TESTENV
  65.  
  66.     Do not execute the TESTPENV.EXE file directly; the TESTENV program calls
  67.     the TESTPENV program for some of the tests.
  68.  
  69.     You also can run the tests under Windows 3.0 in 386 enhanced mode, 
  70.     although some tests are skipped.
  71.  
  72.     By default, TESTENV displays an abbreviated listing of the test results. 
  73.     To get extended reporting of tests and test results, use the /e control 
  74.     as follows:
  75.     TESTENV /e
  76.  
  77.     To force tests to run that ordinarily are skipped, use the /f control: 
  78.     TESTENV /f
  79.  
  80.     You can use both controls at once and save the output in a file: 
  81.     TESTENV /e /f > testres.txt
  82.  
  83.    It has been found that TESTENV does not run properly under QDPMI Version
  84.    1.00.  However, SIMIC seems to run correctly under this configuration.
  85.    If configuration changes cannot be undertaken to correct any problems
  86.    shown by TESTENV, then the VCPI version must be used.
  87.  
  88. Virtual Memory Usage
  89. -------------------
  90.  
  91.     The maximum linear (virtual) accessible address space (region size) for 
  92.     SIMIC is 256 megabytes, in any combination of physical extended memory 
  93.     and swap file space. The maximum physical extended memory is 32 megabytes.
  94.  
  95.     When loading under a DOS Protected Mode Interface (DPMI) host such as 
  96.     Windows, the DPMI host provides the virtual memory management services 
  97.     rather than the DOS extender.
  98.  
  99.     SIMIC, by default, creates the swap file: "\xmswap.tmp", if needed. You 
  100.     may change the name (and location) of this file by assigning the SWAP 
  101.     environment variable to the desired name. For example:
  102.      SET SWAP=C:\TMP\SWAP.TMP
  103.     This is usually done in your AUTOEXEC.BAT file.
  104.  
  105.     If a large SWAP space is needed, it will take SIMIC a little time to 
  106.     initialize the SWAP file. You may generate a permanent swap file to 
  107.     significantly reduce this overhead (see VMADJUST below). The available 
  108.     SWAP space size is defined by the region size and SWAP file size. If 
  109.     SIMIC does not have enough swap space then an Out of Memory message 
  110.     will be displayed. In this event, you may increase the SWAP size as 
  111.     described below.
  112.  
  113.  
  114.  
  115. Utility for Manipulating the Region Size and Swap File (VMADJUST.EXE)
  116. --------------------------------------------------------------------
  117.  
  118.     Genashor provides the VMADJUST utility to modify the region size of the 
  119.     SIMIC program, or to modify the size of the swap file for executing under 
  120.     stand-alone DOS.
  121.  
  122.     The virtual memory manager uses a disk file (swap file) as an extension 
  123.     to physical memory. (If you are running under Windows 3.0, see your 
  124.     Windows documentation for information about modifying Windows' swap 
  125.     file with the Windows 3.0 "swapfile" utility.)
  126.  
  127.     To modify the region size of SIMIC, invoke the utility as follows:
  128.      VMADJUST SIMIC.EXE
  129.     The VMADJUST program is menu-driven.
  130.  
  131.     Be certain that the device on which the swap file is allocated is not 
  132.     corrupted; run the DOS "chkdsk" program from time to time to verify the 
  133.     integrity of the device.
  134.  
  135.     You should remove extended-memory resident utilities such as VDISK to 
  136.     free up more extended memory, if necessary.
  137.  
  138.  
  139.  
  140. Using Ctrl-C Under Windows
  141. -------------------------
  142.  
  143.     If you want to use Ctrl-C to terminate the SIMIC program when executing 
  144.     under Windows, be sure to use a batch file (.bat) or a program information
  145.     file (.pif) for SIMIC. See Chapter 12 in the Microsoft Windows Graphical 
  146.     Environment User's Guide for how and why to use .pif files.
  147.  
  148.  
  149.  
  150. Installing the VCPI version
  151. ---------------------------
  152.  
  153. The VCPI version of SIMIC is located in the VCPI directory.  The GO32.EXE
  154. and SIMIC.EXE should be placed in a directory found in your PATH.  If you
  155. require 387 emulation (you do not have a floating point coprocessor),
  156. add the following line to your AUTOEXEC.BAT:
  157.  
  158.    SET GO32 EMU=<explicit path>\EMU387
  159.  
  160. where <explicit path> is the path where the EMU387 driver is located.
  161. For example, if EMU387 where in the \BIN directory, then the line should
  162. be:
  163.    SET GO32=EMU \BIN\EMU387
  164.  
  165. The directory for the paging file is set by setting the either the GO32TMP,
  166. TEMP, or TMP variable in the AUTOEXEC.BAT file to point to the directory.
  167. For example, to put the paging file in \WINDOWS\TEMP:
  168.  
  169.    SET GO32TMP=\WINDOWS\TEMP
  170.  
  171. NOTE:  The VCPI version cannot be run under WINDOWS or OS/2.
  172.