A fix is available
APAR status
Closed as program error.
Error description
After upgrade from WebSphere MQ 6.0 to 7.5, WebSphere MQ Java/JMS application receives Error 2247 - MQRC_MATCH_OPTIONS_ERROR when performing an MQGET, or JMS receive() call
Local fix
Problem summary
**************************************************************** USERS AFFECTED: This issue affects users of the WebSphere MQ 7.5 classes for Java/JMS that are connecting to a WMQ Queue Manager in Bindings mode and attempting to receive messages larger than 4KB. Platforms affected: MultiPlatform **************************************************************** PROBLEM SUMMARY: APAR IV30481, introduced in WebSphere MQ 7.5.0.1, resulted in the WebSphere MQ classes for Java/JMS specifying the MQMO_MATCH_MSG_TOKEN option on the second MQGET attempt following an initial failure to get a message, where an MQRC_TRUNCATED_MSG_FAILED code was returned from the queue manager. However, the second MQGET attempt failed for Bindings mode transport connections as the MQGMO structure passed to the queue manager for the re-issued MQGET did not contain the correct MSG_TOKEN value to match on. The result was that the application received a MQRC_MATCH_OPTIONS_ERROR (2247) return code.
Problem conclusion
The WebSphere MQ classes for Java/JMS have been modified to resolve this issue by ensuring that the MQGMO structure passed to the queue manager is updated to contain the correct values for use with the MQMO_MATCH_MSG_TOKEN option, when the WebSphere MQ classes for Java/JMS reissue the MQGET with a larger message buffer, following an initial failure to get the message where MQRC_TRUNCATED_MSG_FAILED is returned. | MDVREGR 7.5.0-WS-MQ-AixPPC64-FP0001 | | MDVREGR 7.5.0-WS-MQ-HpuxIA64-FP0001 | | MDVREGR 7.5.0-WS-MQ-HpuxPaRISC64-FP0001 | | MDVREGR 7.5.0-WS-MQ-LinuxIA32-FP0001 | | MDVREGR 7.5.0-WS-MQ-LinuxPPC64-FP0001 | | MDVREGR 7.5.0-WS-MQ-LinuxS390X-FP0001 | | MDVREGR 7.5.0-WS-MQ-LinuxX64-FP0001 | | MDVREGR 7.5.0-WS-MQ-SolarisSparc64-FP0001 | | MDVREGR 7.5.0-WS-MQ-SolarisX64-FP0001 | | MDVREGR 7.5.0-WS-MQ-Windows-FP0001 | | MDVREGR 7.5.0-WS-MQ-AixPPC64-FP0002 | | MDVREGR 7.5.0-WS-MQ-HpuxIA64-FP0002 | | MDVREGR 7.5.0-WS-MQ-HpuxPaRISC64-FP0002 | | MDVREGR 7.5.0-WS-MQ-LinuxIA32-FP0002 | | MDVREGR 7.5.0-WS-MQ-LinuxPPC64-FP0002 | | MDVREGR 7.5.0-WS-MQ-LinuxS390X-FP0002 | | MDVREGR 7.5.0-WS-MQ-LinuxX64-FP0002 | | MDVREGR 7.5.0-WS-MQ-SolarisSparc64-FP0002 | | MDVREGR 7.5.0-WS-MQ-SolarisX64-FP0002 | | MDVREGR 7.5.0-WS-MQ-Windows-FP0002 | --------------------------------------------------------------- The fix is targeted for delivery in the following PTFs: Version Maintenance Level v7.5 7.5.0.3 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
IC97251
Reported component name
WMQ BASE MULTIP
Reported component ID
5724H7241
Reported release
750
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2013-10-28
Closed date
2013-10-31
Last modified date
2013-11-27
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 BASE MULTIP
Fixed component ID
5724H7241
Applicable component levels
R750 PSY
UP
[{"Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSFKSJ","label":"WebSphere MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.5"}]
Document Information
Modified date:
23 September 2021