IBM Support

IC63166: MQRC_Q_MGR_NAME_ERROR ( 2058 ) CAN OCCUR ON A MQCONN CALL IF THE MQSERVER VARIABLE HAS BEEN CHANGED.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • A client application connecting to a server using MQSERVER
    environment variable, gets 2058(MQRC_Q_MGR_NAME_ERROR) from
    MQCONN. This is because of a change in MQ v7 that led to the
    cached value of MQSERVER being used during the MQCONN call.  In
    MQ V6, this caching mechanism was not present and hence it
    could pick up the latest MQSERVER variable at each MQCONN.
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    WebSphere MQ client users where,
    1. Application disconnects from one queue manager and tries to
    reconnect to different queue manager on different host.
    2. MQSERVER environment variable is used in the application.
    
    Platforms affected:
    All Distributed (iSeries, all Unix and Windows)
    ****************************************************************
    PROBLEM SUMMARY:
    When the client application connects to a server using MQSERVER
    environment variable, WebSphere MQ caches the value in the
    ServerConnectionParms attribute. This cached value will be used,
    when the application tries to reconnect to a different queue
    manager on a different server instead of the new MQSERVER
    variable. Since the new value is not used during connection,
    the client application gets 2058(MQRC_Q_MGR_NAME_ERROR) error
    during MQCONN.
    

Problem conclusion

  • WebSphere MQ code has been modified such that during each
    MQCONN, the newly specified MQSERVER value is used in connecting
    to the queue manager.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
                       v7.0
    Platform           Fix Pack 7.0.1.2
    --------           --------------------
    Windows            U200316
    AIX                U829807
    HP-UX (PA-RISC)    U829678
    HP-UX (Itanium)    U829681
    Solaris (SPARC)    U829806
    Solaris (x86-64)   U829680
    iSeries            tbc_p700_0_1_2
    Linux (x86)        U829677
    Linux (x86-64)     U829676
    Linux (zSeries)    U829682
    Linux (Power)      U829679
    
    The latest available maintenance can be obtained from
    'WebSphere MQ Recommended Fixes'
    http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037
    
    If the maintenance level is not yet available, information on
    its planned availability can be found in 'WebSphere MQ
    Planned Maintenance Release Dates'
    http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
    ---------------------------------------------------------------
    

Temporary fix

Comments

APAR Information

  • APAR number

    IC63166

  • Reported component name

    WMQ WINDOWS V7

  • Reported component ID

    5724H7220

  • Reported release

    701

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2009-09-14

  • Closed date

    2009-10-26

  • Last modified date

    2009-10-26

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Fix information

  • Fixed component name

    WMQ WINDOWS V7

  • Fixed component ID

    5724H7220

Applicable component levels

  • R701 PSY

       UP

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSDEZSF","label":"IBM WebSphere MQ Managed File Transfer for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
31 March 2023