IBM Streams 4.2

Java out-of-memory error when using streamtool commands

When you use streamtool commands, you can encounter a Java™ out-of-memory error if the command calls the java command with insufficient memory allocation settings.

Symptoms

You encounter a Java out-of-memory error message, for example:

JVMDUMP039I Processing dump event "systhrow", detail "java/lang/OutOfMemoryError"
...
Exception in thread "P=627353:O=0:CT" java.lang.OutOfMemoryError: Java heap space

Causes

The streamtool command fails if there is not sufficient memory in the Java heap.

Resolving the problem

Increase the maximum amount of memory that can be allocated to the Java environment by the streamtool commands. This value is set in the STREAMTOOL_MAX_JVM_SIZE environment variable. For example:

export STREAMTOOL_MAX_JVM_SIZE=size

The new size cannot exceed the amount of memory that is available on the host where the streamtool commands are run. For example, specify a size of 256m for 256 megabytes or 1g for 1 gigabyte.