garbcoll - release memory space to system (BS2000)

Syntax	#include <stdlib.h> void garbcoll(void);
Description	The calloc(), malloc(), realloc() and free() functions comprise the C-specific memory management package. This package essentially consists of an internal free memory management facility. Memory released by free() is not returned to the system (RELM-SVC), but is acquired by this free memory management facility. All the memory request functions (calloc(), malloc(), realloc()) will first attempt to allocate the required memory via the free memory management facility and only then from the operating system (REQM-SVC). If no memory is available even from the system, the memory administered by the free memory management facility is returned (page-wise if possible) to the system (garbage collection). This garbage collection mechanism is effective in the address space <= 2 GB and can also be called explicitly with the garbcoll() function.
Notes	All memory areas which were previously released with free() and which can be combined to form free pages are returned to the system by garbcoll().
See also	calloc(), malloc(), realloc(), free().