How to Connect to a Remote Queue Manager with IBM WebSphere MQ Explorer?

Question

I create a queue manager like QMTEST in IBM WebSphere MQ Explorer. I want to connect to a remote queue manager (remote ip address). I followed these steps:

• add remote Queue manager
• Queue manager name: QMTEST [Next]
• Host Name or ip Address: X.X.X.X(remote ip) [Finish]

But I couldn't connect. I got this error message 'Could not establish connection to the queue manager-reason 2538.(AMQ4059)'. What can I do?

Answer 1

The four digit number in your error message is an MQRC (MQ Reason Code). This number gives you more information about what went wrong. You can look it up in Knowledge Center.

MQRC_HOST_NOT_AVAILABLE (2538)

There is a list of possible things that could cause this error. My guess is it is likely to be the first one, you have not started a listener on the queue manager, since you do not mention doing that in your question details.

You should also read the following link which is some basic details on how to connect to a remote queue manager. You appear to have the MQ Explorer side sorted, but perhaps not the queue manager side.

Setting up the server using the command line

Answer 2

Please ensure the listener is running on the remote queue manager side. The default MQ listener port is 1414. If the listener is running then check the queue manager error logs for any connection errors from the MQ explorer.

Answer 3

Are you sure the qmgr and its listener are running and that you have a SYSTEM.ADMIN.SVRCONN channel? That is the server-connection channel used for remote administration of a queue manager. This technote may be helpful.

Answer 4

Is this on a modern Windows or Linux server? If so, did you open the port (i.e. 1414) in the firewall?

Answer 5

Sometimes when we create a Queue manager remote administration objects are not created that's why we get such errors because it is unable to find these objects. To create them right click on the queue Manager, Select Remote Administration objects and create them and start the listener.

Answer 6

I experienced this same error and the queue was configured correctly. I was using Eclipse and switched to the MQ Explorer setup available from IBM web page. After that, I was totally able to see the queues and everything I was supposed to see.