The value returned by ESL for the freesize function is the byte size of the singe largest available block of memory free to be used by the ESL program. This function can be used to monitor memory use within your program.

Example

The following example illustrates how you might use the freesize function.

response to start

 set low memory threshold to 2000 

...

 

response to low memory

 squeeze memory

 if (freesize < 2000) then

         change to program Alternate_Choice 

 end if

When freesize is used directly after the squeeze memory statement, as shown in the example, its value includes the sum of all available memory, since the squeeze memory statement creates one large block of free memory from all the fragmented pieces.