Fixes are available
APAR status
Closed as program error.
Error description
Applications using the WebSphere MQ classes for Java or classes for JMS receive completion code '2' with reason code 2298 (MQRC_FUNCTION_NOT_SUPPORTED), when performing an MQPUT or JMS send(Message) operation. The operation is not successful. The issue is also encountered inside WebSphere MQ Explorer, reporting 2298 (MQRC_FUNCTION_NOT_SUPPORTED) when attempting to establish an administrative connection to a remote queue manager.
Local fix
Problem summary
**************************************************************** USERS AFFECTED: This issue affects users of: - The v7 WebSphere MQ classes for Java - The v7 WebSphere MQ classes for JMS Who are trying to PUT a message to a queue manager that supports WebSphere MQ Formats and Protocols (FAP) version 9 or higher, but does not support some of the optional internal functionality from the specification. OR Users of WebSphere MQ Explorer who are attempting to connect to a queue manager that supports FAP version 9 or higher but does not support some of the optional internal functionality from the specification. The issue is known to affect clients connecting to certain levels of WebSphere MQ for z/VSE queue managers. Connections to queue managers on distributed (UNIX and Windows) platforms at v7.0, and connections to queue managers on distributed platforms and z/OS at v7.1, are unaffected by this issue. Platforms affected: All Distributed (iSeries, all Unix and Windows) +Java +Java zOS **************************************************************** PROBLEM SUMMARY: When connecting to a queue manager, the WebSphere MQ classes for Java/JMS check whether the queue manager has support for certain WebSphere MQ internal operations. As part of this, the WebSphere MQ Formats and Protocols (FAP) level is negotiated between the client and the queue manager. As part of this negotiation, the client checks if the queue manager supports certain optional parts of the FAP specification. The client records the outcome of this check in the properties of the connection. In the failing case, the client incorrectly assumed that all queue managers supporting FAP version 9 or higher also support some optional parts of the specification. This resulted in requests being made to the queue manager using internal communication functionality which the queue manager did not support. In the case of a MQPUT operation, this resulted in a MQRC 2298 (MQRC_FUNCTION_NOT_SUPPORTED) response being returned from the queue manager, indicating that the MQPUT operation had failed. When using the WebSphere MQ Explorer, MQPUT operations are made to the queue manager's command queue as part of the process of establishing the administrative connection. This issue caused the MQPUT operation to fail, with the result that the WebSphere MQ Explorer was not able to successfully connect to the queue manager.
Problem conclusion
The WebSphere MQ classes for Java/JMS have been modified so that calls using the optional internal functionality are not made during an MQPUT operation, if the queue manager has notified the client that this functionality is not available. --------------------------------------------------------------- The fix is targeted for delivery in the following PTFs: v7.0 Platform Fix Pack 7.0.1.8 -------- -------------------- Windows U200335 AIX U845856 HP-UX (PA-RISC) U847965 HP-UX (Itanium) U847970 Solaris (SPARC) U847966 Solaris (x86-64) U847972 iSeries 7.0.1.8 Linux (x86) U847967 Linux (x86-64) U847971 Linux (zSeries) U847968 Linux (Power) U847969 zOS 7.0.1.8 v7.1 Platform Fix Pack 7.1.0.2 -------- -------------------- Windows U200351 AIX U853019 HP-UX (Itanium) U853052 Solaris (SPARC) U853048 Solaris (x86-64) U853054 iSeries 7.1.0.2 Linux (x86) U853049 Linux (x86-64) U853053 Linux (zSeries) U853050 Linux (Power) U853051 zOS 7.1.0.2 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
IC79103
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
2011-10-06
Closed date
2011-11-02
Last modified date
2012-08-07
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