The Memory Profiling settings are part of the Runtime Analysis node of the Configuration Settings dialog box, which allows you to configure settings for each node.
By default, the settings of each node are inherited from those of the parent node. When you override the settings of a parent node, changes are propagated to all child nodes within the same Configuration. Overridden fields are displayed in bold.
Detect File in Use (FIU): When the application exits, this option reports any files left open. See File in Use (FIU).
Detect Memory in use (MIU): When the application exits, this option reports allocated memory that is still referenced. See Memory in Use (MIU).
Free Invalid Memory (FIM): This option activates the detection of invalid free memory instructions. See Freeing Invalid Memory (FIM).
Detect Signal (SIG): This option indicates the signal number received by the application forcing it to exit. See Signal Handled (SIG).
Detect Freeing Freed Memory (FFM) and Detect Free Memory Write (FMWL): Select Yes to activate detection of these errors. See Freeing Freed Memory (FFM) and Late Detect Free Memory Write (FMWL).
Free queue length (blocks): specifies the number of memory blocks that are kept free.
Free queue size (bytes): specifies the total buffer size for free queue blocks. See Freeing Freed Memory (FFM) and Late Detect Free Memory Write (FMWL).
Largest free queue block size (bytes): Specifies the size of the largest block to be kept in the free queue.
Detect Array Bounds Write (ABWL): Select Yes to activate detection of this error. See Late Detect Array Bounds Write (ABWL).
Red zone length (bytes) specifies the number of bytes added by Memory Profiling around the memory range for bounds detection.
Number of functions in call stack: specifies the maximum number of functions reported from the end of the CPU call stack. The default value is 6.
Line number link: Select Statement to link the line number in the report to the corresponding allocation or free statement in the function. Select Function to link only to the function entry and to improve performance.
Trace File Name (.tpf): This setting allows you to specify a filename for the generated .tpf trace file.
Excluded global variables: Specifies a list of global variables that are not to be inspected for memory leaks. This option can be useful to save time and instrumentation overhead on trusted code. Use the Add and Remove buttons to add and remove global variables.
Exclude variables from directories: Specifies a list of directories from which any variables found in files are not to be inspected for memory leaks.
Break on error: Use this option to break the execution when an error is encountered. The break point must be set to priv_check_failed in debug mode.
ABWL and FMWL check frequency: Use this to check for ABWL and FMWL errors:
Each time the memory is dumped (by default).
Each time a manual check macro is encountered in the code.
Each function return.
These checks can be performed either on all memory blocks or only a selection of memory blocks. See Checking for ABWL and FMWL errors for more information.
Preserve block content: Set this setting to Yes to preserve the content of memory blocks freed by the application. Use this setting to avoid application crashes with Memory Profiling is engaged. However, reads to freed blocks of memory are no longer detected.
Object hashtable size: Specifies the size of hashtables for objects where <size> must be 64, 256, 1024 or 4096 values.
Class hashtable size: Specifies the size of hashtables for classes where <size> must be 64, 256, 1024 or 4096 values.
Generate snapshot: You can select one of the following options:
On method entry, return, or snapshot button: Uses a specified method to perform snapshot or the GUI snapshot button as specified in the Enable dump Snapshot button setting.
After each garbage collection: Takes a snapshot each time the JVM garbage collector runs.
Enable snapshot button: Specifies whether the manual snapshot button is enabled in GUI.
Delay Snapshot until next Garbage Collection: Specify the trigger method.
Hostname used by snapshot button: Use this option to specify a hostname for the JVMPI Agent to communicate with the GUI.
Port number used by snapshot button: Use this option to specify a port number for the JVMPI Agent to communicate with the GUI.
TPF file name (.tpf): Specifies the name of the Memory Profiling trace dump file produced by the JVMPI Agent.
TXF file name (.txf): Specifies the name of the Memory Profiling static trace dump file.
Display only listed packages: Use this setting to filter out of the report the packages that do not match the specified full package name (package and class).
Display only listed classes: Use this setting to filter out of the report the classes that do not match the specified full classes.
Display only listed methods: Use the Add and Remove buttons to add and remove methods to be listed by the Java Memory Profiling report.
Display call stack for listed methods: Use this setting to list the methods for which the call stack is to be displayed in the Java Memory Profiling report.
Collect referenced objects: Sets the filter to be used with the Java Memory Profiling Report.
To edit the Memory Profiling settings for one or several nodes:
In the Project
Explorer, click the Settings button.
Select a node in the Project Explorer pane.
In the Configuration Settings list, expand Runtime Analysis and select Memory Profiling.
Select either Instrumentation Control, Misc. Options or JVMPI.
When you have finished, click OK to validate the changes.
Related Topics
About Memory Profiling | JVMPI Technology | About Configuration Settings