IBM Support

SE47749: XMS C/C++ CLIENT APPLICATION CAN NOT MQGET BIGGER MESSAGE WHEN MQMD VERSION 1

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When using the Async Consume functionality, an XMS client is
    not able to retrieve large messages from WMQ V7 IBM
    i queue managers. It seems that the XMS client always expects
    to retrieve a message with MQMD.Version 2, even if the customer
    does not specify it to be Version 2.  The issue encountered is
    that messages are being returned with a Version 1 on larger
    messages.  Smaller messages are returned with a Version 2. This
    is a separate issue from the APAR SE47282.
    

Local fix

  • Use MQMD.Version 2
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    End users of the Async consume functionality, who are using
    clients/applications that require or expect a specific version
    level for the messages returned to them.  Examples include the
    XMS client which support version 2.
    
    Platforms affected:
     All Distributed (iSeries, all Unix and Windows)
    ****************************************************************
    PROBLEM SUMMARY:
    The problem was discovered during the investigation and
    resolution of APAR SE47282. In the Async Consume code, when a
    large message requires conversion, and its current buffer is
    too small to accommodate the expansion caused by conversion,
    this case will return an error (eg. rc=2190 or similar). The
    code is designed to handle this error by attempting to
    reallocate the buffer and converting the message again.
    However this scenario will bypass the code that determines and
    sets the final Version of the message when its returned, which
    opens the opportunity of a message being returned with the
    incorrect Version. In the customer case, the message was
    retrieved internally as version 1, with the appropriate flags
    set to upgrade the message to version 2 upon return.  However
    because of the conversion error, the code to upgrade is
    bypassed, and we return the message as a Version 1 without the
    opportunity to determine and set the Version.  Smaller messages
    did not encounter the conversion error and therefore were
    upgraded properly.
    

Problem conclusion

  • The logic flow of the code was rearranged such that the code to
    handle local conversion errors is processed first and then
    process the code that will determine and set the final Version
    value of a message before its returned.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
                       v7.0
    Platform           Fix Pack 7.0.1.6
    --------           --------------------
    Windows            U200328
    AIX                U840698
    HP-UX (PA-RISC)    U841555
    HP-UX (Itanium)    U841560
    Solaris (SPARC)    U841556
    Solaris (x86-64)   U841562
    iSeries            tbc_p700_0_1_6
    Linux (x86)        U841557
    Linux (x86-64)     U841561
    Linux (zSeries)    U841558
    Linux (Power)      U841559
    
    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

    SE47749

  • Reported component name

    WMQ ISERIES V7

  • Reported component ID

    5724H7226

  • Reported release

    701

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2011-04-18

  • Closed date

    2011-04-27

  • Last modified date

    2011-04-27

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Modules/Macros

  • RCHMGR
    

Fix information

  • Fixed component name

    WMQ ISERIES V7

  • Fixed component ID

    5724H7226

Applicable component levels

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCPQ63","label":"APAR \/ Maintenance"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
27 April 2020