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

SET CLIPPER    Runtime configuration of Clipper programs


Syntax:        SET CLIPPER=[V<num1>][;R<num2>][;E<num3>][;X<num4>][;F<num5>]

Arguments:     V (memory variables) restricts the amount of memory
               allocated for the memory variable table to <num1>
               Kbytes.  If not specified, Clipper automatically
               allocates 20 percent--up to a maximum of 44K bytes--of
               available memory for the memory variable table.

               . Note: Each variable requires 22 bytes of memory for
                 its name, type, and value (or memory location if a
                 character type).

               . Caution: If <num1> is larger than 44K, Clipper
                 allocates the requested memory; any amount, however,
                 above 44K bytes becomes unavailable for any processing.

               R (index and RUN buffers) reserves a shared area of
               memory for index and RUN buffers.  When RUN executes the
               "R" buffers are relinquished for the external program as
               executes.

               If <num2> is larger than available memory, the error
               message "System error - not enough memory" displays and
               the application QUITs.

               If Expanded memory is installed, memory allocated by the
               "R" is used only for RUN statements.  Index buffers are
               moved to Expanded Memory unless you specify "E000."

               Note: The term buffers here does not refer to DOS
               buffers set in CONFIG.SYS.

               E (expanded memory) identifies <num3> as the maximum
               amount of Expanded Memory to use for index buffers.  If
               this parameter is not specified Expanded Memory is
               allocated, up to one megabyte.  The minimum <num3> value
               is 16K bytes ("E016;").

               X (exclude memory) excludes <num4> Kbytes of memory
               from being allocated and used except for the RUN
               statement.  For example, specifying "X128" with a RAM
               configuration of 640K, memory is allocated as though the
               computer contains only 512K of memory.

               Note: Memory is excluded before other memory is
               allocated.  The amounts allocated for other purposes are
               diminished accordingly (unless separately controlled by
               the "V" and/or "R" parameters.)

               F (open files) specifies <num5> as the maximum number
               of files that can be open at any one time within the
               current Clipper program and is used in conjunction with
               the CONFIG.SYS "FILES" command.  Clipper determines the
               number of files that can be opened using the smaller of
               the two parameters.  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 <num5> is 5 greater than specified with the FILES
               command and an odd number.

               . Note: Only DOS 3.3 allows more than 20 files to be
                 opened.  The maximum files supported by DOS 3.3 is 255.

               . Caution: The "F" parameter should be set
                 judiciously.  It must be large enough to allow the use
                 of all needed files and yet not so large that valuable
                 memory space is unnecessarily taken up.

               S (suppress snow) suppresses snow on CGA monitors.

Description:   Clipper provides the ability to control allocation of
               memory by using a DOS environmental variable to contain
               configuration information.  At load time, a Clipper
               program looks for any values contained in the
               environmental variable "CLIPPER" and then allocates
               memory and/or file handles in accordance with each
               parameter.  The "CLIPPER" variable can be entered at the
               DOS prompt or included it in AUTOEXEC.BAT.


----------------------------------- Example --------------------------------

   The following batch file uses the CLIPPER environmental variable to
   configure the Clipper program runtime environment to the following:

   . Enough memory variable memory for 256 memory variables (suitable
     for dBASE III PLUS programs)
   . No RUN statements
   . No expanded memory
   . RAM is excluded to test as if only 400K is available on the target
     machine
   . 40 open files in the application


   REM PROG.BAT
   REM
   SET CLIPPER=V6;R16;E0;X240;F45
   APPLICATION.EXE