7.12.4 -XX:ExplicitMemoryNotExcludeClassListFile

Description

-XX:ExplicitMemoryNotExcludeClassListFile specifies the file path for the configuration file that disables exclusions from the explicit memory management functionality. This file is used by the functionality that excludes classes from the explicit memory management functionality. The functionality that excludes classes from the explicit memory management functionality is not applied to the classes specified in this file, even if those classes are also specified in the explicit memory management functionality exclusion configuration file.

When Java VM starts, the file whose path is specified for this option is loaded as the configuration file that disables exclusions from the explicit memory management functionality. If you omit this option or specify a null character for this option, the file in the default file path is loaded as the configuration file that disables exclusions from the explicit memory management functionality.

Prerequisite options

• -XX:+HitachiUseExplicitMemory

• -XX:+ExplicitMemoryUseExcludeClass

Related options

• -XX:ExplicitMemoryFullGCPolicy

• -XX:HitachiAutoExplicitMemory

• -XX:ExplicitMemoryExcludeClassListFile

Syntax

-XX:ExplicitMemoryNotExcludeClassListFile:character_string

Specifiable values

character_string

Type: String

Specify a relative path from the current directory for the Java VM process or an absolute path. You can specify a path that includes directory names.

Note that you can specify only one file as the configuration file that disables exclusions from the explicit memory management functionality. In addition, use ASCII code as the character encoding for the file.

Default value

If the definition item is omitted:

-XX:ExplicitMemoryNotExcludeClassListFile:<null character>

The path of the file to be loaded when <null character> is specified is as follows:

installation_directory_for_JDK/usrconf/exmemnotexcludeclass.cfg

Notes

• If the specified file cannot be opened or loaded, a warning message is output to the event log for the explicit memory management functionality, and then the configuration file in the default path is loaded. If the file in the default path cannot be opened or loaded, the functionality that excludes classes from the explicit memory management functionality does not become disabled.

• If the format of the specified file is incorrect, a warning message is output to the event log for the explicit memory management functionality, and then syntax analysis processing continues from the next line.

• If the same class name is specified in both the explicit memory management functionality exclusion configuration file and the configuration file that disables exclusions from the explicit memory management functionality, the configuration file that disables exclusions from the explicit memory management functionality has priority. In such cases, the functionality that excludes classes from the explicit memory management functionality is disabled for those classes.