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

 SET CLIPPER
 Runtime configuration of CA-Clipper-compiled programs
------------------------------------------------------------------------------

     Environment Variable:

     SET CLIPPER=
        [//BADCACHE]
        [//CGACURS]
        [//DYNF:<nHandles>]
        [//E:<nExpandedKbytes>]
        [//F:<nHandles>]
        [//INFO]
        [//NOIDLE]
        [//SWAPK:<nBytes>]
        [//SWAPPATH:'<path>']
        [//TEMPPATH:'<path>']
        [//X:<nKbytes>]

     Application Command Line:

     C><app> [//<setting> ... ] [<app arguments>]

     You should adhere to the following rules when specifying these
     environment settings regardless of whether they are specified on the
     application command line or in the CLIPPER environment variable.

     .  Preface each setting with a double-slash

     .  Place a single blank space between settings

     .  Place a colon between setting and argument with no intervening space

 Description

     CA-Clipper provides runtime configuration control of CA-Clipper-
     compiled programs with a number of settings.  You can specify settings
     in the DOS environment variable CLIPPER or on the command line used to
     invoke an application.  You can enter the CLIPPER variable at the DOS
     prompt or include it in the AUTOEXEC.BAT file.  If the user will be
     accessing the application from a network, you can also add the SET
     CLIPPER command to the user's login script.

     Settings that you specify on the application program command line must
     precede application arguments.  If you wish to use the command line
     method instead of the CLIPPER environment variable but want to hide the
     complexity from your end user, use an application batch file to invoke
     the application with the configuration settings.

 Settings

     BADCACHE causes the Virtual Memory Manager (VMM) to preserve and
     restore the state of the EMM page frame before and after every EMM
     access (the EMM page frame is an area in real address space through
     which EMM data is accessed).  This setting can be used to correct
     problems when there are conflicts with other programs that use EMM.

     Note that on some EMM systems, the BADCACHE setting may adversely
     affect VMM performance.  It should only be used if you experience disk
     or file corruption because of a conflict with a disk cache or other
     resident software.

     CGACURS prevents the use of the extended cursor capability of the
     EGA/VGA.  Specifying this setting may preclude some cursor modes by
     some display adaptors.  The CGACURS prevents the cursor weirdness when
     a CA-Clipper program is executed in some multitasking and TSR
     environments.

     DYNF:<nHandles> specifies the number of file handles the dynamic
     overlay system is allowed to use.  Valid settings range from 1 to 8
     inclusive.  If not specified, the default is 2.

     E:<nExpandedKbytes> restricts the amount of expanded memory
     automatically allocated to <nExpandedKbytes>.  CA-Clipper-compiled and
     linked programs can use expanded memory to speed up processing as well
     as some disk-based operations.  CA-Clipper can use memory configured
     as expanded memory according to the Lotus-Intel-Microsoft (LIM)
     Expanded Memory Specification (EMS) version 4.0 or higher.

     Expanded memory is automatically allocated in its entirety at startup;
     there is no dynamic allocation as execution proceeds.  The maximum
     amount allocated is limited by four factors:

     .  The amount available
     .  The SET CLIPPER=//E:nnn environment setting
     .  A theoretical maximum of 32MB
     .  The amount of conventional memory available

     Note that a certain amount of conventional memory must be used to
     contain management tables for the virtual memory system--the more total
     memory (both conventional and expanded), the more space taken up by
     this control information.  The amount of expanded memory used may be
     less than the amount available if there is insufficient conventional
     memory to hold the tables.

     F:<nHandles> is used in combination with the value specified with
     the FILES command in CONFIG.SYS to inform CA-Clipper of the maximum
     number of file handles to use.  This setting is only valid for
     application programs using more than 20 files and running under DOS
     3.3 or greater.  When specified, CA-Clipper determines the number of
     files that can be opened using the smaller of the F setting and the
     CONFIG.SYS FILES value.  For example, if the FILES command is set to
     120 and the F parameter is set to 50, the maximum number of files that
     can be opened is 50.  The ideal <nHandles> is an odd number and 5 less
     than specified with the FILES command.

     INFO Provides the following information about CA-Clipper's memory
     usage at startup of an application.

     .  The first line describes the general product version, revision,
        and international version.

     .  DS=<offset>:0000 is the address for the data segment or DGROUP.

     .  DS avail=<memory>KB reflects the amount of DGROUP available.

     .  OS avail=<memory>KB represents the amount of conventional
        memory available for VMM swap space.

     .  EMM avail=<EMM memory>KB shows the amount of EMM (expanded
        memory) allocated to the current application.

     .  Fixed Heap=<fixed heap>KB/<number of fixed segments> shows the
        size of the fixed heap in kilobyte increments in addition to the
        number of fixed segments.

     NOIDLE prevents CA-Clipper from detecting and taking advantage of idle
     time during execution of compiled applications.  CA-Clipper detects
     idle states (e.g. keyboard wait states) during execution of compiled
     applications.  When an idle condition is detected, the system uses the
     slack time to perform garbage collection, file updates, and other
     routine housekeeping duties.  This increases system performance by
     performing this work while the application is waiting for user input.

     Note: NOIDLE is provided for applications in which idle time processing
     is unacceptable.  Since it reduces overall system performance, its use
     is generally not recommended.

     SWAPK:<nBytes> specifies the maximum allowable size of the disk
     swap file used for the virtual memory (VM) system.  Settings are
     specified in kilobyte increments.  Valid settings range from 256 to
     65,535 inclusive.  If this setting is not specified, the default is
     16,384 (16 MB).

     Note: Swap space is only allocated as needed--a particular setting
     does not guarantee that the swap file will get that big.  Suppressing or
     restricting disk swapping may cause an application to fail.

     SWAPPATH:'<path>' specifies the location of the virtual memory swap
     file.  If not specified, the swap file is created in the current DOS
     drive and directory.

     TEMPPATH:'<path>' controls the placement of temporary files created
     during sorting and indexing.  By default these files are placed in
     the current DOS directory.

     Note: Temporary files created during sorting and indexing can be quite
     large.  Setting TEMPPATH to a small volume (e.g. a ram disk) may cause
     these operations to fail.  In general, the volume where these temporary
     files will be written should have an available capacity at least twice
     the size of the largest index to be created or database file to be
     sorted.

     X:<nKbytes> specifies the amount of memory to exclude from being
     allocated, except for the RUN command.  Specified in kilobytes, valid
     values range from zero to 64 inclusive.  If not specified, the default
     value is zero.

 Examples

     This example shows a series of settings using the CA-Clipper
     environment variable:

     SET CLIPPER=//F:50 //DYNF:4 //SWAPK:4096 //NOIDLE

     This example shows how the same settings can be used on the
     application's command line:

     C>ACCOUNTS //F:50 //DYNF:4 //SWAPK:4096 //NOIDLE