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.