Increasing the Java heap size for the Security Discovery editor

The Security Discovery editor tends to use much more memory than other CICS Explorer® plug-ins. If you use the editor to analyze security definitions, it's likely the default maximum Java heap size is not sufficient. Increase the Java heap size to avoid out of memory exceptions.

About this task

For more information about the Security Discovery editor, see Security Discovery editor.

Procedure

  1. Open the zosexplorer.ini file in a text editor.
    On Windows, it's in the same directory where the zosexplorer.exe file is located.
    On macOS, right-click the installed CICS Explorer application and select Show Package Contents. It's in Contents > Eclipse.
    Figure 1. Showing package contents of CICS Explorer
    Right-click menu of the CICS Explorer application file
  2. In the zosexplorer.ini file, after the -vmargs line, append the following line:
    -Xmx2048m

    This increases the maximum heap size from the default 512 MB to 2 GB. CICS Explorer will not use the extra heap size unless needed.

  3. If you still see an out of memory error after increasing the heap size to 2 GB, consider increasing it further, such as 3 GB:
    -Xmx3072m