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.