2082 (0822) (RC2082): MQRC_UNKNOWN_ALIAS_BASE_Q

Explanation

An MQOPEN or MQPUT1 call was issued specifying an alias queue as the target, but the BaseQName in the alias queue attributes is not recognized as a queue name.

This reason code can occur when BaseQName is the name of a cluster queue that cannot be resolved successfully.

This reason code can also occur when running the REFRESH CLUSTER command. See Application issues seen when running REFRESH CLUSTER

MQRC_UNKNOWN_ALIAS_BASE_Q might indicate that the application is specifying the ObjectQmgrName of the queue manager that it is connecting to, and the queue manager that is hosting the alias queue. This means that the queue manager looks for the alias target queue on the specified queue manager and fails because the alias target queue is not on the local queue manager. Leave the ObjectQmgrName parameter blank so that the clustering decides which queue manager to route to.

Completion code

MQCC_FAILED

Programmer response

Correct the queue definitions.

This reason code is also used to identify the corresponding event message Unknown Alias Base Queue.

If the reason code is seen by an application that is using IBM® MQ classes for JMS, modify the JMS queue object definition that is used by the application so that the QMANAGER property is set to the empty string (""). This setting ensures that the clustering decides which queue manager to route to.

If the queue is in the cluster, check that you have used appropriate open options. You cannot get messages from a remote cluster queue, so make sure that the open options are for output only.