Transmission Queue Usage Error


Event name: Transmission Queue Usage Error.
Reason code in MQCFH: MQRC_XMIT_Q_USAGE_ERROR (2092, X'82C').
Transmission queue with wrong usage.
Event description: On an MQOPEN or MQPUT1 call, a message is to be sent to a remote queue manager, but one of the following occurred. Either:

  • ObjectQMgrName specifies the name of a local queue, but it does not have a Usage attribute of MQUS_TRANSMISSION.

  • The ObjectName or ObjectQMgrName field in the object descriptor specifies the name of a local definition of a remote queue but one of the following applies to the XmitQName attribute of the definition:

    • XmitQName is not blank, but specifies a queue that does not have a Usage attribute of MQUS_TRANSMISSION

    • XmitQName is blank, but RemoteQMgrName specifies a queue that does not have a Usage attribute of MQUS_TRANSMISSION

  • The queue name is resolved through a cell directory, and the remote queue manager name obtained from the cell directory is the name of a local queue, but it does not have a Usage attribute of MQUS_TRANSMISSION.
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.

XmitQName

Description: Transmission queue name.
Identifier: MQCA_XMIT_Q_NAME.
Datatype: MQCFST.
Maximum length: MQ_Q_NAME_LENGTH.
Returned: Always.

ApplType

Description: Type of application making the MQI call that caused the event.
Identifier: MQIA_APPL_TYPE.
Datatype: MQCFIN.
Returned: Always.

ApplName

Description: Name of the application making the MQI call that caused the event.
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.