2087 (0827) (RC2087): MQRC_UNKNOWN_REMOTE_Q_MGR

Explanation

On an MQOPEN or MQPUT1 call, an error occurred with the queue-name resolution, for one of the following reasons:

• ObjectQMgrName is blank or the name of the local queue manager, ObjectName is the name of a local definition of a remote queue (or an alias to one), and one of the following is true:
  • RemoteQMgrName is blank or the name of the local queue manager. Note that this error occurs even if XmitQName is not blank.
  • XmitQName is blank, but there is no transmission queue defined with the name of RemoteQMgrName, and the DefXmitQName queue manager attribute is blank.
  • RemoteQMgrName and RemoteQName specify a cluster queue that cannot be resolved successfully, and the DefXmitQName queue manager attribute is blank.
  • On z/OS only, the RemoteQMgrName is the name of a queue manager in the queue sharing group but intra-group queuing is disabled.

• ObjectQMgrName is the name of a local definition of a remote queue (containing a queue manager alias definition), and one of the following is true:
  • RemoteQName is not blank.
  • XmitQName is blank, but there is no transmission queue defined with the name of RemoteQMgrName, and the DefXmitQName queue manager attribute is blank.

• ObjectQMgrName is not:
  • Blank
  • The name of the local queue manager
  • The name of a transmission queue
  • The name of a queue manager alias definition (that is, a local definition of a remote queue with a blank RemoteQName)

  but the DefXmitQName queue manager attribute is blank and the queue manager is not part of a queue sharing group with intra-group queuing enabled.

• ObjectQMgrName is the name of a model queue.
• The queue name is resolved through a cell directory. However, there is no queue defined with the same name as the remote queue manager name obtained from the cell directory, and the DefXmitQName queue manager attribute is blank.

Completion code

MQCC_FAILED

Programmer response

Check the values specified for ObjectQMgrName and ObjectName. If these are correct, check the queue definitions.

This reason code is also used to identify the corresponding event message Unknown Remote Queue Manager.

Parent topic: API reason codes