syntax:

   void

seGarbageCollect(secontext se,int action);

where:

se the context to collect

action the garbage collection action to perform

return:

None

description:

This routine allows you to manipulate and invoke garbage collection on a given context. action can be one of the following:

SE_GARBAGE_COLLECT

Perform a garbage collection immediately, even if it has been disabled.

SE_GARBAGE_OFF

Disable garbage collection. Instead of collecting to free up unused memory, more memory is always allocated from the system whenever existing storage is exhausted.

SE_GARBAGE_ON

Re-enable garbage collection.

Note that each SE_GARBAGE_OFF must be paired with one SE_GARBAGE_ON. If SE_GARBAGE_OFF has been invoked several times, garbage collection will not be restarted until SE_GARBAGE_ON has been invoked the same number of times. However, a garbage collection can always be forced using the SE_GARBAGE_COLLECT action.

see:

None