home *** CD-ROM | disk | FTP | other *** search
/ DOS Wares / doswares.zip / doswares / DATABASE / CLIPPER5 / EXO-UTG.ZIP / READ.ME < prev    next >
Encoding:
Text File  |  1993-06-01  |  8.1 KB  |  199 lines
  1.  
  2.                              ExoSpace (tm)
  3.                              -------------
  4.  
  5.                            Copyright (c) 1993
  6.             SofDesign International, Inc. and ObjecTech, Inc.
  7.                            All Rights Reserved
  8.  
  9.  
  10.  
  11.   Contents
  12.   ========
  13.  
  14.   This file contains the following sections:
  15.  
  16.   * Installation
  17.   * File List
  18.   * Known Limitations
  19.   * Addendum
  20.   * Errata
  21.  
  22.  
  23.   Installation
  24.   ============
  25.  
  26.   To install ExoSpace, create a directory for it on your hard disk, using
  27.   a command similar to the following:
  28.  
  29.     MKDIR C:\EXOSPACE
  30.  
  31.   Then copy all the files (including subdirectories) from the ExoSpace
  32.   distribution diskette into the new EXOSPACE directory on the hard
  33.   disk, using a command similar to the following:
  34.  
  35.     XCOPY A:\*.* C:\EXOSPACE /S
  36.  
  37.   There are a few files that are contained in self-extracting archives.
  38.   They are the UTILS.EXE archive and the EXONG.EXE archive.  If you need
  39.   the contents of either then you should execute them after copying them.
  40.  
  41.   Now you need to ensure that ExoSpace can find the files that it needs
  42.   when it executes.  When ExoSpace executes, it must be able to find
  43.   the files EXO1.EXE and EXO2.EXE, as well as the library EXOSPACE.LIB.
  44.  
  45.   ExoSpace will look for executable files in the directory from which
  46.   EXOSPACE.EXE is loaded, as well as in the directories specified by the
  47.   PATH environment variable.  We suggest that you add the EXOSPACE
  48.   directory to your path using the DOS PATH command in your AUTOEXEC.BAT
  49.   file, for example:
  50.  
  51.     PATH=C:\DOS;C:\CLIPPER\BIN;C:\EXOSPACE
  52.  
  53.   ExoSpace will look for libraries in the current directory, as well as
  54.   in the directory specified by the LIB environment variable.  We suggest
  55.   that you add the EXOSPACE directory to the LIB environment variable
  56.   using the SET LIB command in your AUTOEXEC.BAT file, for example:
  57.  
  58.     SET LIB=C:\CLIPPER\LIB;C:\EXOSPACE
  59.  
  60.   Now ExoSpace should be correctly installed on your computer.
  61.  
  62.  
  63.   File List
  64.   =========
  65.  
  66.   Filename            Description
  67.   --------            -----------
  68.  
  69.   EXOSPACE.EXE        ExoSpace
  70.   EXOSPACE.LIB        Library used by ExoSpace during linking
  71.   EXONG.EXE           Norton Guide for ExoSpace in a self-extracting archive
  72.   EXO1.EXE            Utility used by ExoSpace during linking
  73.   EXO2.EXE            Utility used by ExoSpace during linking
  74.   3RDPARTY.TXT        Third-party library compatibility listing
  75.   READ.ME             This file
  76.  
  77.   ExoSpace Utilities (in UTIL subdirectory)
  78.  
  79.   UTILS.EXE is a self extracting archive that contains the following 
  80.   utilities:
  81.  
  82.   PMINFO.EXE          Tests and reports protected-mode characteristics.
  83.   RMINFO.EXE          Informational utility for use if PMINFO fails.
  84.   MULTI16M.EXE        For sharing memory among multiple ExoSpace applications
  85.                       under the DOS 5 Task Switcher and similar task switchers.
  86.   PRIVATXM.EXE        Used to provide an ExoSpace application with a pool
  87.                       of "private memory" which cannot be used by other
  88.                       applications while the ExoSpace application is running.
  89.  
  90.  
  91.   Known Limitations
  92.   =================
  93.  
  94.   Stack overflow in link scripts
  95.   ------------------------------
  96.  
  97.   Link scripts containing large numbers of consecutive FILE, MODULE
  98.   or similar commands may produce a "stack overflow" error message
  99.   when linking.  Such link scripts are usually used when overlaying
  100.   Clipper or third-party libraries with other linkers.  The workaround
  101.   for this limitation is to avoid including such link scripts when
  102.   linking with ExoSpace.  Since the MODULE command is not required and
  103.   thus ignored by ExoSpace, this should have no effect on the operation
  104.   of an application.  Another workaround is to specify multiple filenames
  105.   on each command, eg. "FILE mod1, mod2, mod3", instead of specifying
  106.   a single filename with each command.
  107.  
  108.  
  109.   Addendum
  110.   ========
  111.  
  112.   Temporary link files
  113.   --------------------
  114.  
  115.   ExoSpace may create temporary files while linking an application.  By
  116.   default, these files will be created in the current directory, but
  117.   their location can be controlled by setting a DOS environment variable
  118.   called TMP to refer to the directory in which temporary files should
  119.   be created.  For example:
  120.  
  121.     SET TMP=C:\TEMP
  122.  
  123.   This would cause ExoSpace, when linking, to create temporary files in
  124.   a directory called \TEMP on the C: drive.
  125.  
  126.   NOTE: the TMP environment variable has no effect on an application
  127.   linked with ExoSpace.  To control the location of temporary files
  128.   created during execution of an application linked with ExoSpace, use
  129.   the Clipper environment variable settings SWAPPATH and TEMPPATH, as
  130.   described in the Clipper documentation.
  131.  
  132.  
  133.   CLIPPER environment variable
  134.   ----------------------------
  135.  
  136.   Four parameters have been added to the CLIPPER environment variable
  137.   to control the virtual memory (VM) system.  Each of these parameters
  138.   can be set in the DOS environment, burned into the .EXE, or specified
  139.   at runtime when preceded by "//" on the command line.
  140.  
  141.   VMSIZE:nnnn  Sets the amount of virtual memory the VM system should
  142.                provide.  The default is 8096K which is more than
  143.                sufficient for the vast majority of Clipper applications.
  144.                This default may be increased in the future.  As an
  145.                example, to change the VM size to 16384K (16MB) use
  146.                "VMSIZE:16384".
  147.  
  148.   MAXMEM:nnnn  Sets the maximum amount of physical memory to use before
  149.                swapping to disk.  The default is 8096K which is more
  150.                than sufficient for the vast majority of Clipper
  151.                applications.  This default may be increased in the
  152.                future.  In a task switching environment you may want to
  153.                lower this value.  As an example, to change the maximum
  154.                amount of memory to use to 2048K (2MB) use "MAXMEM:2048".
  155.  
  156.   MINMEM:nnnn  Sets the minimum amount of physical memory that must be
  157.                available to run the program.  If there is not enough
  158.                memory available an error message is generated and the
  159.                application quits back to DOS.  The default is 1024K which
  160.                is the recommended minimum.  As an example, to change the
  161.                minimum amount of memory to 1536K (1.5MB) use "MINMEM:1536".
  162.  
  163.   LOWMEM:nnnn  Sets the amount of low DOS memory to reserve for allocation
  164.                by third party libraries for interrupt routines.  The
  165.                default is 0.  Ignore this unless your third party library
  166.                documentation recommends that you set it.
  167.         
  168.  
  169.   Errata
  170.   ======
  171.  
  172.   Page 16 : At the bottom of page 16, reference is made to two files,
  173.             EXOLINK.EXE and SPLICE.EXE, which do not in fact exist.  The
  174.             files which EXOSPACE.EXE requires during execution are
  175.             called EXO1.EXE and EXO2.EXE.
  176.  
  177.   Page 25 : In the sample link script on page 25, one of the comment
  178.             lines states that "the following library, EXOSPACE.LIB, is
  179.             required."  This is misleading.  The EXOSPACE.LIB library
  180.             will be included by default, and does not need to be
  181.             explicitly specified.  If, however, it is explicitly
  182.             specified for any reason, it must be specified before any of
  183.             the Clipper libraries.
  184.  
  185.   Page 80 : Occurrences of "100h" should read "200h".  The relevant
  186.             paragraph should thus read as follows: "Unless your
  187.             application is running under DPMI (e.g., in a Microsoft
  188.             Windows DOS box), a selector value less than 200h indicates
  189.             an error in the ExoSpace code. Selector values greater than
  190.             200h indicate a bug in the application code - either in a
  191.             third party library, or other C or Assembler code."
  192.  
  193.             In addition, it should be noted that it is also possible
  194.             (although rare) for errors at selector values greater than
  195.             200h to be due to problems in Clipper itself.
  196.  
  197.  
  198. <*** End of File ***>
  199.