Enabling Java heap dump generation to troubleshoot low memory exceptions for AMQP

To enable automatic generation of a Java heap dump when the AMQP service reports a low memory exception, you need to modify the AMQP Java Virtual Machine (JVM) configuration file amqp_java.properties.

About this task

Note: After you have modified the configuration file, you need to restart the AMQP service for any changes to come into effect.

Procedure

Modify the amqp_java.properties file by using the following command:

setamqp properties -m <QueueManager> -k -Dcom.ibm.mq.MQXR.GenerateHeapDump -v true

Restart the AMQP service.

Results

A Java heap dump is generated automatically when the AMQP service reports a low memory exception. Only one Java heap dump file is generated. To enable the creation of another file, simply restart the service.

The newly generated Java heap dump file can be found in the IBM® MQ errors directory at WMQ data directory\errors.