MainframeKit

2538

MQRC_HOST_NOT_AVAILABLE (X'09EA')MQ REASON CODE

A client could not reach the queue manager's host and port at all: no listener, wrong address, or network blocked.

MOST LIKELY

The listener for that port is not running.

FIRST CHECK

Read the client error log for the network error detail.

TRY IT ▸

Block size and space calculator

What it means

The client tried to open a network conversation to the address in its channel definition and failed. The queue manager did not even see the request. It is a network or listener problem, not a security one.

Typical causes

  • The listener for that port is not running.
  • The connection name (host and port) in the client settings or CCDT is wrong.
  • The network is down or the host name does not resolve.
  • A firewall blocks the port.
  • A security exit on the SVRCONN channel blocks the start of the session.

How to fix it

  1. Read the client error log for the network error detail.
  2. Check the listener is running (DISPLAY LSSTATUS on distributed; on z/OS the channel initiator and its listener).
  3. Check CONNAME, for example host(1414), and that the host name resolves.
  4. Test the port from the client machine and check firewalls on both sides.

Example

Illustrative only; names and values are invented.

MQCONN failed  CompCode=2  Reason=2538  ConnName=mqhost01(1414)
DISPLAY LSSTATUS(*) PORT STATUS