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.
    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.

    XmitQName

    Description: Transmission queue name.
    Identifier: MQCA_XMIT_Q_NAME.
    Data type: 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.
    Data type: MQCFIN.
    Returned: Always.

    ApplName

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