Skip to content

CAUTION: This site hosts draft documentation for the next release. For published content of the latest release, visit www.eclipse.org/openj9/docs

-Xmcrs

Sets an initial size for an area in memory that is reserved within the lowest 4 GB memory area for any native classes, monitors, and threads that are used by compressed references.

You can use the -verbose:sizes option to find out the value that is being used by the VM.

Notes:

  • Native memory OutOfMemoryError exceptions might occur when using compressed references if the lowest 4 GB of address space becomes full, particularly when loading classes, starting threads, or using monitors.
  • If you are not using compressed references and this option is set, the option is ignored and the output of -verbose:sizes shows -Xmcrs0.
  • This option is overridden by the -Xgc:suballocatorInitialSize option, irrespective of the order of the options on the command line. If the -Xmcrs option is thus overridden, the -Xmcrs output of -verbose:sizes shows the suballocatorInitialSize value.

Syntax

    -Xmcrs<size>

For more information about the <size> parameter, see Using -X command-line options.