2058 (080A) (RC2058): MQRC_Q_MGR_NAME_ERROR


Explanation

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.

For CICS, this reason can be caused by the wrong resync value. For example, Groupresync is specified and the queue manager is not in a queue sharing group.

This reason code can also occur if an MQ MQI client application attempts to connect to a queue manager within an MQ-client queue manager group (see the QMgrName parameter of MQCONN), and either:

  • Queue manager groups are not supported.
  • There is no queue manager group with the specified name.
For the IMS adapter on z/OS, MQRC_Q_MGR_NAME_ERROR occurs when CSQQDEFV is loaded and one of:

  • MQCONN call specified a blank queue manager name, and there is no CSQQDEFX TYPE=DEFAULT entry.
  • Queue manager name specified for the MQCONN call is not found in the loaded CSQQDEFV table.
  • A different CSQQDEFV module than the one intended has been loaded, such as the default one shipped with the product. This situation can be caused by the library containing your CSQQDEFV module being after the SCSQAUTH data set in STEPLIB or JOBLIB for the dependent region. Move your library before the SCSQAUTH data set in the concatenation. If there is not a CSQQDEFV load module in STEPLIB/JOBLIB, check what is loaded through the LINKLIST.
For the CICS adapter, MQRC_Q_MGR_NAME_ERROR occurs when:

  • The MQCONN definition specifies Resyncmember(Groupresync) and the MQNAME specifies a queue manager name instead of a queue sharing group name.
MQRC_Q_MGR_NAME_ERROR is returned when an attempt is made to connect the same address space using a different type of adapter from that used by an existing IBM MQ connection. Specific cases include:

  • An exit running in a CICS, IMS or RRSBATCH type region, attempts an MQCONN via the BATCH adapter.
  • A CICS Standard Liberty profile application attempts to connect to IBM MQ with bindings connection factory and there is already an existing CICS MQCONN established from the CICS region to the same queue manager.


Completion code

MQCC_WARNING or MQCC_FAILED


Programmer response

Use an all-blank name if possible, or verify that the name used is valid.

If you are using CICS Resyncmember(Groupresync), use the queue sharing group (QSG) name in the MQNAME rather than the queue manager name.