2199 (0897) (RC2199): MQRC_DEF_XMIT_Q_USAGE_ERROR

Explanation

An MQOPEN or MQPUT1 call was issued specifying a remote queue as the destination. Either a local definition of the remote queue was specified, or a queue-manager alias was being resolved, but in either case the XmitQName attribute in the local definition is blank.

Because there is no transmission queue defined with the same name as the destination queue manager, the local queue manager has attempted to use the default transmission queue. However, the queue defined by the DefXmitQName queue-manager attribute does not have a Usage attribute of MQUS_TRANSMISSION.

This reason code is returned from MQOPEN or MQPUT1, if the queue manager's Default Transmission Queue is about to be used, but the name of this queue is SYSTEM.CLUSTER.TRANSMIT.QUEUE. This queue is reserved for clustering, so it is not valid to set the queue manager's Default Transmission Queue to this name.

Completion Code

MQCC_FAILED

Programmer response

Do one of the following:
  • Specify a local transmission queue as the value of the XmitQName attribute in the local definition of the remote queue.
  • Define a local transmission queue with a name that is the same as that of the remote queue manager.
  • Specify a different local transmission queue as the value of the DefXmitQName queue-manager attribute.
  • Change the Usage attribute of the DefXmitQName queue to MQUS_TRANSMISSION.

See XmitQName for more information about transmission queue names.