Fixes are available
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":"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","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Document Information
Modified date:
31 March 2023