IBM Support

IC62428: MQRC_LIBRARY_LOAD_ERROR when using MQAX applications to connect using the GMQ_MQ_LIB setting on a client-only install.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • An MQAX application connecting to a queue manager using the
    GMQ_MQ_LIB environment variable to specify the bindings mode as
    client attempts to connect to the queue manager in server
    bindings mode. On a client-only installation, this fails with
    MQRC_LIBRARY_LOAD_ERROR as the requisite dlls are not present.
    On a server installation, this results in the wrong connection
    type being used. The only values of GMQ_MQ_LIB which will load
    the client libraries are as follows:
    mqic.dll
    mqicxa.dll
    As such, libraries specified with a fully qualified path or
    using the V6 client library mqic32.dll will result in an
    attempt to load the server-side libraries.
    

Local fix

  • Do not set the GMQ_MQ_LIB in client-only environment.
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Users of WebSphere MQ using MQAX applications configured to
    connect with the GMQ_MQ_LIB environment variable setting.
    
    Platforms affected:
    Windows
    
    ****************************************************************
    PROBLEM SUMMARY:
    The problem was caused by the incorrect interpretation of the
    GMQ_MQ_LIB environment variable which was only accepting
    mqic.dll and mqicxa.dll as acceptable client library values.
    All other values including mqic32.dll or fully qualified values
    were being rejected and a server bound connection was then
    being attempted.
    
    The WebSphere MQ manuals were also incorrect in mentioning that
    the path had to be stipulated in the environment variable. This
    is not necessarily true and attempts to load the library will
    follow the usual path searching procedures of the OS. In
    addition, the manuals should be updated to mention that a
    client-only installation will by default attempt a client
    connection. Therefore, setting the GMQ_MQ_LIB environment
    variable in these cases is not necessary.
    

Problem conclusion

  • WebSphere MQ was modified to ensure that fully qualified
    libraries are also accepted as is the mqic32.dll/mqic.dll value.
    
    The WebSphere MQ InfoCentre should also be modified under the
    following section:
    http://publib.boulder.ibm.com/infocenter/wmqv6/v6r0/index.jsp?
    topic=/com.ibm.mq.amqtan.doc/aqmm.htm
    
    AccessQueueManager method
    
    Note:
    When both the WebSphere MQ server and client are installed on
    your system, MQAX applications will run against the server by
    default. To run MQAX against the client, the client bindings
    library must be specified in the GMQ_MQ_LIB environment
    variable, for example, set GMQ_MQ_LIB=mqic.dll
    On a client-only installation, setting the GMQ_MQ_LIB
    environment variable is not necessary as a client connection
    will be attempted by default.
    
    | MDVREGR 7.0-WS-MQ-Windows-RP0001 |
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
                       v7.0
    Platform           Fix Pack 7.0.1.1
    --------           --------------------
    Windows            U200310
    
                       v7.0
    Currently any fixes planned for v7.0 will be fixed in 7.0.1.*
    and not in 7.0.0.*
    
    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

    IC62428

  • Reported component name

    WMQ WINDOWS V7

  • Reported component ID

    5724H7220

  • Reported release

    700

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2009-08-07

  • Closed date

    2009-09-21

  • Last modified date

    2010-04-08

  • 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

  • R700 PSY

       UP

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCPQ63","label":"APAR \/ Maintenance"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
08 April 2010