Troubleshooting RC(2538) "MQRC_HOST_NOT_AVAILABLE" Errors

When you attempt to connect to any Queue Manager, you may encounter the following error in the agent logs:

IME0005(<hostname>, <env>, <QMGR>): Unable to open Queue Manager: RC(2538)

This error indicates that the client cannot connect to the Queue Manager because the host is unavailable.

Common Causes:

1. Incorrect hostname/IP in the connection string.

2. Listener not running on the queue manager’s host/port.

3. Port blocked by firewall/network restrictions.

4. DNS resolution issue – hostname cannot be resolved.

5. Queue Manager down or not accessible.

Resolution:

1. Verify that the queue manager listener is running on the specified port:

runmqsc QMGRNAME
DISPLAY LISTENER(*)

2. Check the CHANNEL definition in MQ Explorer or runmqsc:

DISPLAY CHSTATUS(CHANNEL_NAME)

3.  Ensure the hostname and port in the connection string match the actual MQ host listener.

4. Test connectivity with:

telnet <hostname> <port>

5. If hostname is used, try replacing with the IP address to rule out DNS issues.

6. Check the firewall settings between the client and server.