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 the 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. Note that 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.
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.
Datatype: MQCFST.
Maximum length: MQ_Q_MGR_NAME_LENGTH.
Returned: Always.

QName

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

ApplType

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

ApplName

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

ObjectQMgrName

Description: Name of the object queue manager.
Identifier: MQCACF_OBJECT_Q_MGR_NAME.
Datatype: 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.

Note:
If the application is a server for clients, the ApplType and ApplName parameters identify the server, not the client.