SWPFREEMS()                   Limit use of EMS memory for swapping
------------------------------------------------------------------------------

 Function : Limit use of EMS memory for swapping

 Syntax   : niValue = SWPFREEMS(niValue)

 Return   : The previous setting

 This function can be used to limit the amount of EMS 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 EMS used by
 SWPRUNCMD(), it does not cause any EMS in use by the application to be
 freed. The amount of EMS specified as a parameter to this function must
 already be free at the time SWPRUNCMD() is executed.

 Example:

    SWPUSEEMS(TRUE)      // Enable use of EMS (default) but leave
    SWPFREEMS(512)    // at least 512 Kb free if possible