MainframeKit

2092

MQRC_XMIT_Q_USAGE_ERROR (X'082C')MQ REASON CODE

The route to a remote queue manager leads to a queue that is not set up as a transmission queue.

MOST LIKELY

The queue named in XMITQ, or named after the remote queue manager, has USAGE(NORMAL).

FIRST CHECK

Check the ObjectName and ObjectQMgrName values in the call.

TRY IT ▸

MainframeKit assistant

What it means

Messages for another queue manager are placed on a transmission queue first. That queue must be defined with USAGE(XMITQ). If name resolution ends at a local queue with normal usage, the open fails with 2092. It is also used in the Transmission Queue Usage Error event.

Typical causes

  • The queue named in XMITQ, or named after the remote queue manager, has USAGE(NORMAL).
  • ObjectQMgrName matches a local queue that is not a transmission queue.
  • On z/OS, XMITQ is SYSTEM.QSG.TRANSMIT.QUEUE but intra-group queuing is not enabled.

How to fix it

  1. Check the ObjectName and ObjectQMgrName values in the call.
  2. Display the queue that the route resolves to and check USAGE.
  3. Define a proper transmission queue with USAGE(XMITQ), or fix the remote queue definition.
  4. On z/OS, enable intra-group queuing if that is the intended route.

Example

Illustrative only; names and values are invented.

MQOPEN failed  CompCode=2  Reason=2092  Queue=APP.REMOTE.QUEUE
DISPLAY QLOCAL(QM02) USAGE
  QUEUE(QM02)  USAGE(NORMAL)