SWPFREXMS()                   Limit use of XMS memory for swapping
------------------------------------------------------------------------------

 Function : Limit use of XMS memory for swapping

 Syntax   : niValue = SWPFREXMS(niValue)

 Return   : The previous setting

 This function can be used to limit the amount of XMS used by the swap system
 for program image storage, so that the specified amount can be left free for
 the child program.

 Please note that this function only restricts the amount of XMS used by
 SWPRUNCMD(), it does not cause any XMS in use by the application to be
 freed. The amount of XMS specified as a parameter to this function must
 already be free at the time SWPRUNCMD() is executed.

 Example:

    SWPUSEXMS(TRUE)      // Enable use of XMS (default) but leave
    SWPFREXMS(512)    // at least 512 Kb free if possible