C function __uheapreport() storage report

To generate a user-created heap storage report use the C function, __uheapreport(). Use the information in the report to assist with tuning your application's use of the user-created heap.

Figure 1 shows a sample storage report generated by __uheapreport(). For more information on the __uheapreport() function, see z/OS XL C/C++ Runtime Library Reference. For tuning tips, see z/OS Language Environment Programming Guide.

Figure 1. Storage report generated by __uheapreport()
Storage Report for Enclave  12/26/09 11:42:23 AM
Language Environment V01 R12.00

    HeapPools Statistics:
      Pool 1 size:    32
        Successful Get Heap requests:     1-   32          11250
      Pool 2 size:   128
        Successful Get Heap requests:    97-  128           3306
      Pool 3 size:   512
        Successful Get Heap requests:   481-  512            864
      Pool 4 size:  2048
        Successful Get Heap requests:  2017- 2048            216
      Pool 5 size:  8192
        Successful Get Heap requests:  8161- 8192             54
      Pool 6 size: 16384
        Successful Get Heap requests: 16353-16384             27
      Requests greater than the largest cell size:             0
    HeapPools Summary:
      Cell  Extent   Cells Per  Extents    Maximum     Cells In
      Size  Percent  Extent     Allocated  Cells Used  Use
      ----------------------------------------------------------
         32   15        3750           1        3750           0
        128   15        1102           1        1102           0
        512   15         288           1         288           0
       2048   15          72           1          72           0
       8192   15          18           1          18           0
      16384   15           9           1           9           0
      ----------------------------------------------------------
      Suggested Percentages for current Cell Sizes:
        32,15,128,15,512,15,2048,15,8192,15,16384,15
      Suggested Cell Sizes:
        32,,128,,512,,2048,,8192,,16384,
End of Storage Report