MEMCHECK VHM environment variables
The MEMCHECK VHM environment variables control the tool, the call levels of the Heap Leak Report and Trace Report, the Overlay Analysis, the pad length added in the user heap allocation for overlay analysis, and the output file name for the reports. They should be activated through the ENVAR runtime option, the file specified by the _CEE_ENVFILE (or _CEE_ENVFILE_S) environment variable, or using the export command from the z/OS UNIX shell before any user code gets control (prior to the HLL user exit, static constructors, or main getting control). Setting these environment variables after the user code has begun execution will not activate them and the default values will be used.
- _CEE_MEMCHECK_DEPTH
- Description: Controls the number of call-levels to be generated
on the Heap Leak Report.
Valid settings: integer value : the minimum is 1 and the maximum is 100. If the value specified is not valid, the default will be used.
Default: 10.
- _CEE_MEMCHECK_OVERLAY
- Description: Activates the storage overlays analysis beyond
the end of the malloc'd storage.
Valid settings: ON to activate the analysis, OFF to deactivate. If an invalid value is specified, the default value will be used.
Default: OFF
- _CEE_MEMCHECK_OVERLAYLEN
- Description: Sets the pad length added in the user heap
allocation for overlay analysis. This environment variable will be
used only if _CEE_MEMCHECK_OVERLAY is active.
Valid settings: integer value, multiple of 8: the minimum is 8 and the maximum is 80. Non-multiples of 8 will be rounded up to the next multiple.
Default: 8
- _CEE_MEMCHECK_TRACE
- Description: Enables tracing of all heap storage allocation
and deallocation and a Trace Report will be generated at Language Environment® Termination.
Valid settings: ON to activate the analysis, OFF to deactivate. If an invalid value is specified, the default value will be used.
Default: OFF
- _CEE_MEMTRACE_DEPTH
- Description: Controls the number of call-levels to be generated
in the Trace Report, on each call to a library function that deals
with heap. This environment variable will be used only if _CEE_MEMCHECK_TRACE
is active.
Valid settings: integer value: the minimum is 1 and the maximum is 100. If the value specified is not valid, the default value will be used.
Default: 10
- _CEE_MEMCHECK_OUTFILENAME
- Description: Sets the name of the fully qualified path
name of the file in which the Heap Leak Report and Trace Report should
be directed. The report name could be any valid name used in C-RTL
fopen() function, then it could also generates the reports in a Data
Set.
Valid settings: string value. If an invalid value is specified, the default value will be used.
Default: standard error output