Click above to get retro games delivered to your door ever month!

 EXOSPACE PACKAGE
------------------------------------------------------------------------------

 Synopsis

     Cause specified protected-mode support packages to be included in .EXE.

 Syntax

     EXOSPACE PACKAGE <PackageList>

 Examples

     # Include mouse & video BIOS packages
     EXOSPACE PACKAGE MOUSE,INT10

     # Exclude Virtual Memory package
     EXOSPACE PACKAGE NOVM

 Description

     Specifies one or more packages to be included in the .EXE.  Packages
     provide protected-mode support for certain low-level (C or Assembler)
     operations.  Specifically, packages provide CA-Clipper programs
     transparent access to software interrupts that are unsupported by the
     protected-mode kernel.  Packages are more suitable than libraries for
     this purpose because they are much more automatic, much less error
     prone, and require no source changes.

     For example, if you are linking a library that provides mouse support,
     you will need to include the MOUSE package to ensure correct operation
     under CA-Clipper/ExoSpace.  For further information, see the Packages
     section later in this chapter.

 Disabling VM

     The EXOSPACE PACKAGE command can also be used to prevent the default
     Virtual Memory (VM) package from being included.  Normally, the VM
     package is automatically included in a CA-Clipper/ExoSpace application.
     This ensures that CA-Clipper/ExoSpace applications can run on a wide
     variety of target machines, even those which do not have enough physical
     RAM--in such cases, the VM system will automatically swap data to disk
     as necessary.

     However, if you are certain that a particular application will always be
     run on a machine with sufficient RAM, you can exclude the VM package
     using the EXOSPACE PACKAGE NOVM command.  Applications linked in this
     way may load and initialize somewhat faster, but they will fail if there
     is not enough RAM on the target machine to hold the entire .EXE and all
     of its data.

     Determining how much RAM a particular application requires may require
     some trial and error.  In general, it is recommended that use of this
     option be limited to special circumstances.  For more information about
     CA-Clipper/ExoSpace built-in packages, see the Packages section later in
     this chapter.