Technote (troubleshooting)
Problem
Custom Java IFX throwing a java.lang.OutOfMemoryError
Symptom
After enabling the Viewer trigger file, c:\wpf.pel, you will see an error in the masqform.log or java.log:
"Viewer : java.lang.OutOfMemoryError: Java heap space at ..."
During Viewer operation the Viewer may crash or show other errors.
Cause
The Java IFX requires more memory then the Viewer is allowing it to allocate.
Resolving the problem
To resolve the Out-of-Memory error you can increase the JVM heapsize. This is done by following these steps:
Navigate to the prefs.config of the Viewer (<Viewer installation location>\Prefs\prefs.config).
Open the prefs.config in a text editor and add these two lines.
jvmOptions.1=-Xmx512M
jvmOptions.2=-Xms512M
Xmx is for the maximum heap and Xms is for the minimum. The default is 256. In order to confirm the change took affect you can query the memory size through the IFX.
This link will provide documentation that will assist in printing out the Java heap size.
Note: this is a client-side configuration and the change would have to be made for every system where the problem is experienced. As an organization you could standardize the configuration settings and then deploy the prefs.config file to each user's system, placing it in the directory specified above.
Related information
IBM Forms Support
IBM Forms Documentation
Rate this page:
Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.