IBM Support

IC97251: WEBSPHERE MQ JAVA/JMS APPLICATION GETTING MQEXCEPTION: MQJE001: COMPLETION CODE '2', REASON '2247' ERROR.

Subscribe

You can track all active APARs for this component.

 

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":"LOB36","label":"IBM Automation"},"Business Unit":{"code":"BU053","label":"Cloud \u0026 Data Platform"},"Product":{"code":"SSFKSJ","label":"WebSphere MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.5"}]

Document Information

Modified date:
23 September 2021