7.12.7 -XX:HitachiAutoExplicitMemoryFile

Description

-XX:HitachiAutoExplicitMemoryFile specifies the file path for the automatic placement configuration file used by the functionality for automatically placing Explicit memory blocks.

Prerequisite option

• -XX:+HitachiAutoExplicitMemory

Syntax

-XX:HitachiAutoExplicitMemoryFile:character_string

Specifiable values

character_string

Type: String

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

Note that you can specify only one file as the automatic placement configuration file.

If you specify one or more characters, the default automatic placement setting for the explicit memory management functionality and the file settings specified for this option are enabled.

Default value

If the definition item is omitted:

-XX:HitachiAutoExplicitMemoryFile:<null character>

Notes

• Specify class names, method arguments, and java.lang package classes by using fully qualified class names.

  Example of incorrect specification:

  String

  Example of correct specification:

  java.lang.String

• You cannot specify class names that use generics (general names). Specify class names (raw type) that are not parameterized.

  Example of incorrect specification:

  java.util.HashMap<java.lang.String, java.lang.Object>

  Example of correct specification:

  java.util.HashMap

• For nested classes, specify their names by using the delimiter $ instead of ..

  Example of incorrect specification:

  java.util.AbstractMap.SimpleEntry

  Example of correct specification:

  java.util.AbstractMap$SimpleEntry

• To specify a constructor, specify the same class name and method name, or specify <init>. The following is an example for specifying the constructor of the class MyMain.

  Example:

  MyMain.MyMain() or MyMain.<init>()

• If there is a method that has the same name as the class name, it will be impossible to determine whether a constructor is specified or a method is specified. For this reason, in such cases, both the constructor and the method are considered to be specified.

  Example:

  If MyMain.MyMain(int) is specified, both the constructor that possesses the argument int of the class # MyMain, and the method # MyMain(int) are treated as generation points.

• To specify a static initializer, specify <clinit>. The following is a specification example of the static initializer for the class MyMain.

  Example:

  MyMain.<clinit>()

• To specify the point where objects are generated by substituting values in field declarations as the generation point, specify the default constructor in the generation point.

• Arrays cannot be specified for the fully qualified class names of user-specified objects.

  Example:

  java.lang.String[]

• If there is a line that contains a class or a method name that does not exist, or a line that contains a method ("native" method or "abstract" method) that does not have a byte code, that line is ignored.

• If a J2SE internal class is specified for the class name of a user-specified object, the explicit memory management functionality sometimes changes the class name to the correct name. For example, java.util.HashMap$Entry is changed to java.util.HashMap.