Troubleshooting
Problem
Your program attempts to connect to WebSphere MQ and fails.
Symptom
2058 0x0000080a MQRC Q MGR NAME ERROR
Cause
2058 is returned when connecting to a queue manager using the wrong queue manager name.
This is the most common cause, however there can be other reasons for this failure.
Resolving The Problem
Ensure that the queue manager name is specified correctly on:
- MQCONN API calls
- QREMOTE object definitions
- Client connection channel definitions
- Ensure that the connection request is routed to the intended machine and queue manager.
- Verify that the listener program is starting the channel on the correct queue manager.
- Ensure that the specifications for the client environment variables are correct.
- mqserver
- mqchllib
- mqchltab
Corrective actions:
- Specify the correct queue manager name.
- Correct channel routing problems.
- Correct inetd listener configuration problems.
- Correct client related configuration problems.
Example 1:
In this example, the sample program (amqsput) is used to put a message to queue (SVR.LQ) on queue manager (svr). Notice that it fails with reason code 2058. This failure occurs because the queue manager name is "SVR", not "svr".
Example 2:
After the queue manager name is corrected, this works as expected.
Example 3:
In this example the mqserver environment variable is used to configure a channel connection, from the client to the server, using channel(SYSTEM.DEF.SVRCONN). The client program (amqsputc) attempts to connect to queue manager(SVR), and to put a message to queue(SVR.LQ). This program fails with MQRC 2058, because queue manager(SVR) is not listening on port(1414); queue manager(HOBSON) was listening on port(1414).
Example 4:
After the mqserver is changed to include the correct listener port for queue manager(SVR), this works as expected.
2058 | X'080A' | MQRC_Q_MGR_NAME_ERROR On an MQCONN or MQCONNX call, the value specified for the QMgrName parameter is not valid or not known. This reason also occurs if the parameter pointer is not valid. (It is not always possible to detect parameter pointers that are not valid; if not detected, unpredictable results occur.) On z/OS for CICS applications, this reason can occur on any call if the original connect specified an incorrect or unrecognized name. This reason code can also occur if a WebSphere MQ client application attempts to connect to a queue manager within a WebSphere MQ-client queue-manager group (see the QMgrName parameter of MQCONN ), and either:
|
For a complete list see API Reason Codes
Product Synonym
WMQ MQ
Was this topic helpful?
Document Information
Modified date:
15 June 2018
UID
swg21166938