Unknown Remote Queue Manager

Event name: Unknown Remote Queue Manager.
Reason code in MQCFH: MQRC_UNKNOWN_REMOTE_Q_MGR (2087, X'827').
Unknown remote queue manager.
Event description: On an MQOPEN or MQPUT1 call, an error occurred with queue-name resolution, for one of the following reasons:

  • ObjectQMgrName is either blank or the name of the local queue manager, and ObjectName is the name of a local definition of a remote queue that has a blank XmitQName. However, there is no (transmission) queue defined with the name of RemoteQMgrName, and the DefXmitQName queue manager attribute is blank.
  • ObjectQMgrName is the name of a queue manager alias definition (held as the local definition of a remote queue) that has a blank XmitQName. However, there is no (transmission) queue defined with the name of RemoteQMgrName, and the DefXmitQName queue manager attribute is blank.
  • ObjectQMgrName specified is not:

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

    and the DefXmitQName queue manager attribute is blank.

  • ObjectQMgrName is blank or is the name of the local queue manager, and ObjectName is the name of a local definition of a remote queue (or an alias to one), for which RemoteQMgrName is either blank or is the name of the local queue manager. This error occurs even if the XmitQName is not blank.
  • ObjectQMgrName is the name of a local definition of a remote queue. In this case, it should be a queue manager alias definition, but the RemoteQName in the definition is not blank.
  • 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. Also, the DefXmitQName queue manager attribute is blank.
  • On z/OS only: a message was put to a queue manager in a queue sharing group and SQQMNAME is set to USE. This routes the message to the specified queue manager in order to be put on the queue. If SQQMNAME is set to IGNORE, the message is put to the queue directly.

Event type: Remote.
Platforms: All.
Event queue: SYSTEM.ADMIN.QMGR.EVENT.


Event data

    QMgrName

    Description: Name of the queue manager generating the event.
    Identifier: MQCA_Q_MGR_NAME.
    Data type: MQCFST.
    Maximum length: MQ_Q_MGR_NAME_LENGTH.
    Returned: Always.

    QName

    Description: Queue name from object descriptor (MQOD).
    Identifier: MQCA_Q_NAME.
    Data type: MQCFST.
    Maximum length: MQ_Q_NAME_LENGTH.
    Returned: Always.

    ApplType

    Description: Type of application attempting to open the remote queue.
    Identifier: MQIA_APPL_TYPE.
    Data type: MQCFIN.
    Returned: Always.

    ApplName

    Description: Name of the application attempting to open the remote queue.
    Identifier: MQCACF_APPL_NAME.
    Data type: MQCFST.
    Maximum length: MQ_APPL_NAME_LENGTH.
    Returned: Always.

    ObjectQMgrName

    Description: Name of the object queue manager.
    Identifier: MQCACF_OBJECT_Q_MGR_NAME.
    Data type: MQCFST.
    Maximum length: MQ_Q_MGR_NAME_LENGTH.
    Returned: If the ObjectName in the object descriptor (MQOD), when the object was opened, is not the queue manager currently connected.

    ConnName

    Description: Connection name for client connection.
    Identifier: MQCACH_CONNECTION_NAME.
    Data type: MQCFST.
    Maximum length: MQ_CONN_NAME_LENGTH.
    Returned: If the application making the MQI call that caused the event is a client attached application.

    ChannelName

    Description: Channel name for client connection.
    Identifier: MQCACH_CHANNEL_NAME.
    Data type: MQCFST.
    Maximum length: MQ_CHANNEL_NAME_LENGTH
    Returned: If the application making the MQI call that caused the event is a client attached application.

Parent topic: Event message descriptions