SWPADDENV()                   Increase size of child environment block.
------------------------------------------------------------------------------

 Function : Increase size of child environment block.

 Syntax   : niValue = SWPADDENV(NumberOfBytes)

 Return   : The previous setting

 By default, when the DOS EXEC function starts a process (SWPRUNCMD()

 uses this DOS function), the environment that is created for the child is
 truncated so that there is very little, if any, free space.

 This function can be used to increase the size of the child program's
 environment by the number of bytes passed as a parameter. This is necessary
 if the program (or batch file) that will be run as a child process needs to
 add or change environment variables. The maximum size of an environment
 block is 32 KB.

 Note that this function increases the size of the child environment at the
 time the child process is executed, it does not modify the parent
 environment in any way.

 The child environment is destroyed when the child process terminates.

 Example:

    // Ensure 128 bytes free in environment
    OldSize = SWPADDENV(128)