2059 (080B) (RC2059): MQRC_Q_MGR_NOT_AVAILABLE
Explanation
This error occurs:
- On an MQCONN or MQCONNX call, the queue manager identified by
the
QMgrName
parameter is not available for connection.- On z/OS®:
- For batch applications, this reason can be returned to applications running in LPARs that do not have a queue manager installed.
- For CICS® applications, this reason can occur on any call if the original connect specified a queue manager with a name that was recognized, but which is not available.
- On IBM® i, this reason can also
be returned by the MQOPEN and MQPUT1 calls, when MQHC_DEF_HCONN is
specified for the
Hconn
parameter by an application running in compatibility mode.
- On z/OS®:
- On an MQCONN or MQCONNX call from
an IBM WebSphere® MQ MQI client application:
- Attempting to connect to a queue manager within an MQ-client queue-manager
group when none of the queue managers in the group is available for
connection (see the
QMgrName
parameter of the MQCONN call). - If the client channel fails to connect, perhaps because of an error with the client-connection or the corresponding server-connection channel definitions.
- The z/OS Client Attachment feature has not been installed.
- Attempting to connect to a queue manager within an MQ-client queue-manager
group when none of the queue managers in the group is available for
connection (see the
- If a command uses the
CommandScope
parameter specifying a queue manager that is not active in the queue-sharing group. - In a multiple installation environment, where an application attempts to connect to a queue manager associated with an installation of IBM WebSphere MQ Version 7.1, or later, but has loaded libraries from IBM WebSphere MQ Version 7.0.1. IBM WebSphere MQ Version 7.0.1 cannot load libraries from other versions of IBM WebSphere MQ.
Completion Code
MQCC_FAILED
Programmer response
Ensure that the queue manager has been started. If the connection is from a client application, check the channel definitions, channel status, and error logs.
In a multiple installation environment, ensure that IBM WebSphere MQ Version 7.1, or later, libraries are loaded by the operating system. For more information, see Connecting applications in a multiple installation environment .