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

WebSphere MQ V7.0 Fix Pack 7.0.1.1
WebSphere MQ V7.0 Fix Pack 7.0.1.2

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 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