IBM Streams 4.2.1

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. You can set this value by using the STREAMTOOL_MAX_JVM_SIZE environment variable, for example:

export STREAMTOOL_MAX_JVM_SIZE=size

Notes:

The size that you specify cannot exceed the amount of memory that is available on the resource where you run streamtool commands. For a size of 256 megabytes, specify 256m. For a size of 1 gigabyte, specify 1g.
If the STREAMTOOL_MAX_JVM_SIZE environment variable is not set, IBM® Streams selects a maximum JVM size based on the system default size.