IBM Support

How to resolve MQJMS2005 errors with reason code 2059 on WebSphere Application Server

Troubleshooting


Problem

Your JMS application runs on IBM® WebSphere® Application Server to connect to a WebSphere MQ messaging system receives an MQJMS2005 error with reason code 2059.

Cause

Reason code 2059 means that the queue manager is not available.

The most likely cause of the problem is that the queue manager is not running or that the queue manager listener is not running. Another possible cause is that the queue manager name that is specified on the JMS connection factory is incorrect.

Resolving The Problem

These are some steps to take to try to resolve the cause of the 2059 error.

Confirm that the queue manager is up and running and that the listener is running

  1. Ensure that the queue manager is running. You can use the dspmq command to verify this. The status of the queue manager should be Running.
  2. Check the MQ FDC files in the MQ_install_root/errors and MQ_install_root/qmgrs/queue_manager_name/errors directories to see what relevant error messages may be logged there.
  3. Check that the queue manager is the default queue manager. If there is no default queue manager, then define one. This can be set in the mqs.ini file. See the WebSphere MQ System Administration Guide for more information.
  4. Ensure that the queue manager has a listener running and is listening on the right port.
    Start the listener program using the following command:
    runmqlsr -t tcp -p <port_number> -m <qmgr_name>

Other possible causes for the reason code 2059
If you are using the CLIENT transport type to connect to the queue manager on an IPv4/IPv6 dual stack machine -- for example, SLES 9 and Redhat Enterprise Linux® 4 -- and you use "localhost" as the queue manager name. Either use the machine name or ip address instead of "localhost" or set:

  -Djava.net.preferIPv4Stack=true



If you set the CCSID, then check this technote.

[{"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Java Message Service (JMS)","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF012","label":"IBM i"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"8.5.5;8.5;8.0;7.0","Edition":"Base;Express;Network Deployment","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSNVBF","label":"Runtimes for Java Technology"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Java SDK","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
15 June 2018

UID

swg21249782