BLILSTFRG()                   List CA-Clipper Summer '87 memory blocks
------------------------------------------------------------------------------

 Function : List CA-Clipper Summer '87 memory blocks

 Syntax   : BLILSTFRG([nuHandle])

 Return   : None

 This function is used to list each block of CA-Clipper's dynamic memory to
 show the degree of fragmentation. Each block is listed on a separate line
 with its address in memory, its size and whether it is in use or not. The
 function takes as an optional parameter the output destination file handle.

 Note that the CA-Clipper free pool is allocated from DOS on an 'as-needed'
 basis, and unless MEMORY(0), BLIMEMPAK(-1) or BLIMEMBLK() are executed
 (which cause CA-Clipper to allocate all available memory to the free pool
 from DOS), this function will reflect only the currently allocated free
 pool.

 Example:

    * List the Fragmentation
    *
    BLILSTFRG(4)   && Send to the printer

 An example of the output:

    Address        Size     In Use
    8198:0000      00018    Y
    8198:0014      00184    N
    8198:00EA      00058    Y
    8198:0120      00920    N