MainframeKit

2189

MQRC_CLUSTER_RESOLUTION_ERROR (X'088D')MQ REASON CODE

An open or put to a cluster queue failed because the cluster repository did not answer in time to resolve the queue.

MOST LIKELY

The repository manager on this queue manager is not running.

FIRST CHECK

Check that the repository manager is running (on z/OS it runs in the channel initiator).

TRY IT ▸

MainframeKit assistant

What it means

To use a cluster queue that is not yet known locally, the queue manager asks the cluster's full repositories. If the repository manager does not respond, MQOPEN, MQPUT or MQPUT1 fails with 2189. It can also happen while REFRESH CLUSTER runs.

Typical causes

  • The repository manager on this queue manager is not running.
  • Cluster channels to the full repositories are stopped or retrying.
  • Cluster queue or channel definitions are wrong.
  • A REFRESH CLUSTER is in progress.

How to fix it

  1. Check that the repository manager is running (on z/OS it runs in the channel initiator).
  2. Run DISPLAY CHSTATUS for the cluster-sender channels to the full repositories.
  3. Check queue and cluster channel definitions, and DISPLAY CLUSQMGR output.
  4. Retry after the cluster has settled.

Example

Illustrative only; names and values are invented.

MQOPEN failed  CompCode=2  Reason=2189  Queue=APP.CLUSTER.QUEUE
DISPLAY CLUSQMGR(*) STATUS