IBM Support

IT00404: Return Code 2241 MQRC_INCOMPLETE_GROUP received from Java application

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • A WebSphere MQ classes for Java application receives a exception
    with the return code: 2241 - MQRC_INCOMPLETE_GROUP when
    attempting for getting a message that is part of that group and
    the particular message is larger than 4K but the previous
    message in the group was less than 4K.
    

Local fix

  • na
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users of the WebSphere MQ classes for Java
    who are getting messages from a queue that are part of a group.
    This issue is observed only after applying APAR IV30481.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    When a WebSphere MQ classes for Java application attempts to get
    a larger than 4K message that is part of a group and the
    previous message in the group was less than 4K then an exception
    is returned to the application with the reason code of 2241
    (MQRC_INCOMPLETE_GROUP). This issue occurs when that APAR
    IV30481 is applied to the system.
    
    This issue occurs because the MQGET request sent by the
    WebSphere MQ classes for Java client has removed the
    MQGMO_LOGICAL_ORDER option when reattempting to get a message
    larger than 4K using an increased buffer size and the match
    option of MQMO_MATCH_MSG_TOKEN.
    
    The MQRC_INCOMPLETE_GROUP occurs because the previous MQGET in
    the group was successful with the MQGMO_LOGICAL_ORDER option
    (due to the message being less than 4K) and so all other MQGETs
    within that group have to maintain the MQGMO_LOGICAL_ORDER
    option.
    

Problem conclusion

  • The WebSphere MQ classes for Java have been updated so that the
    MQGMO_LOGICAL_ORDER option and/or MQGMO_ALL_MSGS_AVAILABLE
    option are preserved if a message has to be retrieved that is
    larger than 4K.
    
    
    | MDVREGR 7.0.1-WS-MQ-AixPPC64-FP0010 |
    | MDVREGR 7.0.1-WS-MQ-HpuxIA64-FP0010 |
    | MDVREGR 7.0.1-WS-MQ-HpuxPaRISC64-FP0010 |
    | MDVREGR 7.0.1-WS-MQ-LinuxIA32-FP0010 |
    | MDVREGR 7.0.1-WS-MQ-LinuxPPC64-FP0010 |
    | MDVREGR 7.0.1-WS-MQ-LinuxS390X-FP0010 |
    | MDVREGR 7.0.1-WS-MQ-LinuxX64-FP0010 |
    | MDVREGR 7.0.1-WS-MQ-SolarisSparc64-FP0010 |
    | MDVREGR 7.0.1-WS-MQ-SolarisX64-FP0010 |
    | MDVREGR 7.0.1-WS-MQ-Windows-FP0010 |
    
    | MDVREGR 7.0.1-WS-MQ-AixPPC64-FP0011 |
    | MDVREGR 7.0.1-WS-MQ-HpuxIA64-FP0011 |
    | MDVREGR 7.0.1-WS-MQ-HpuxPaRISC64-FP0011 |
    | MDVREGR 7.0.1-WS-MQ-LinuxIA32-FP0011 |
    | MDVREGR 7.0.1-WS-MQ-LinuxPPC64-FP0011 |
    | MDVREGR 7.0.1-WS-MQ-LinuxS390X-FP0011 |
    | MDVREGR 7.0.1-WS-MQ-LinuxX64-FP0011 |
    | MDVREGR 7.0.1-WS-MQ-SolarisSparc64-FP0011 |
    | MDVREGR 7.0.1-WS-MQ-SolarisX64-FP0011 |
    | MDVREGR 7.0.1-WS-MQ-Windows-FP0011 |
    
    | MDVREGR 7.0.1-WS-MQ-AixPPC64-FP0012 |
    | MDVREGR 7.0.1-WS-MQ-HpuxIA64-FP0012 |
    | MDVREGR 7.0.1-WS-MQ-HpuxPaRISC64-FP0012 |
    | MDVREGR 7.0.1-WS-MQ-LinuxIA32-FP0012 |
    | MDVREGR 7.0.1-WS-MQ-LinuxPPC64-FP0012 |
    | MDVREGR 7.0.1-WS-MQ-LinuxS390X-FP0012 |
    | MDVREGR 7.0.1-WS-MQ-LinuxX64-FP0012 |
    | MDVREGR 7.0.1-WS-MQ-SolarisSparc64-FP0012 |
    | MDVREGR 7.0.1-WS-MQ-SolarisX64-FP0012 |
    | MDVREGR 7.0.1-WS-MQ-Windows-FP0012 |
    
    
    | MDVREGR 7.1.0-WS-MQ-AixPPC64-FP0003 |
    | MDVREGR 7.1.0-WS-MQ-HpuxIA64-FP0003 |
    | MDVREGR 7.1.0-WS-MQ-HpuxPaRISC64-FP0003 |
    | MDVREGR 7.1.0-WS-MQ-LinuxIA32-FP0003 |
    | MDVREGR 7.1.0-WS-MQ-LinuxPPC64-FP0003 |
    | MDVREGR 7.1.0-WS-MQ-LinuxS390X-FP0003 |
    | MDVREGR 7.1.0-WS-MQ-LinuxX64-FP0003 |
    | MDVREGR 7.1.0-WS-MQ-SolarisSparc64-FP0003 |
    | MDVREGR 7.1.0-WS-MQ-SolarisX64-FP0003 |
    | MDVREGR 7.1.0-WS-MQ-Windows-FP0003 |
    
    | MDVREGR 7.1.0-WS-MQ-AixPPC64-FP0004 |
    | MDVREGR 7.1.0-WS-MQ-HpuxIA64-FP0004 |
    | MDVREGR 7.1.0-WS-MQ-HpuxPaRISC64-FP0004 |
    | MDVREGR 7.1.0-WS-MQ-LinuxIA32-FP0004 |
    | MDVREGR 7.1.0-WS-MQ-LinuxPPC64-FP0004 |
    | MDVREGR 7.1.0-WS-MQ-LinuxS390X-FP0004 |
    | MDVREGR 7.1.0-WS-MQ-LinuxX64-FP0004 |
    | MDVREGR 7.1.0-WS-MQ-SolarisSparc64-FP0004 |
    | MDVREGR 7.1.0-WS-MQ-SolarisX64-FP0004 |
    | MDVREGR 7.1.0-WS-MQ-Windows-FP0004 |
    
    
    | 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 |
    
    | MDVREGR 7.5.0-WS-MQ-AixPPC64-FP0003 |
    | MDVREGR 7.5.0-WS-MQ-HpuxIA64-FP0003 |
    | MDVREGR 7.5.0-WS-MQ-HpuxPaRISC64-FP0003 |
    | MDVREGR 7.5.0-WS-MQ-LinuxIA32-FP0003 |
    | MDVREGR 7.5.0-WS-MQ-LinuxPPC64-FP0003 |
    | MDVREGR 7.5.0-WS-MQ-LinuxS390X-FP0003 |
    | MDVREGR 7.5.0-WS-MQ-LinuxX64-FP0003 |
    | MDVREGR 7.5.0-WS-MQ-SolarisSparc64-FP0003 |
    | MDVREGR 7.5.0-WS-MQ-SolarisX64-FP0003 |
    | MDVREGR 7.5.0-WS-MQ-Windows-FP0003 |
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v7.0       7.0.1.13
    v7.1       7.1.0.5
    v7.5       7.5.0.5
    v8.0       8.0.0.1
    
    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

    IT00404

  • 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

    2014-03-19

  • Closed date

    2014-05-29

  • Last modified date

    2014-05-29

  • 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

[{"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.0.1"}]

Document Information

Modified date:
24 September 2021