IBM Support

SE47282: WMQ V7 ASYNC CONSUME ( MQCB ) MAY RETURN 2190 INTERMITTENTLY IF TRANSLATION INCREASES THE MESSAGE SIZE

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • WMQ V7 introduced an async message consumption. A client can
    call MQCB to get a message. In some cases, this can fail with
    rc 2190 MQRC_CONVERTED_STRING_TOO_BIG.
    
    The internal MQGET ( mqgetm ) was successful. The message size
    happened to be the same as the buffer size provided. But ccsid
    conversion then occurs. If the message is translated and
    longer, it can overflow the buffer provided. MQ errors on this
    with the 2190 instead of retrying with a larger buffer (or
    otherwise handling the situation accordingly).
    
    This error should only occur when code page translation that
    increases the message length.
    

Local fix

  • For Client connections, change the SVRCN channel to SHARECVN to
    0.
    
    Also, increase the size of the messages (on the MQPUT). In this
    case, the message size happened to be 8192 bytes. But
    increasing the message size to 8193 allowed the message to get
    processed correctly.
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Applications and clients trying to use the async consume
    functionality with messages that need conversion and have
    specified their own maximum message lengths.
    
    Platforms affected:
     All Distributed (iSeries, all Unix and Windows)
    ****************************************************************
    PROBLEM SUMMARY:
    The async consume code does handle the case where message
    conversion causes the message size to exceed the current
    buffer.  The design is that it will attempt to reallocate a
    larger buffer and try to convert again.  However the checking
    logic of this scenario fails if the end user specified their
    own maximum message length and the reallocation attempt will
    not occur.
    

Problem conclusion

  • The code change was to change the logic checking to accommodate
    custom customer settings in addition to the default scenarios.
    Once the new code is applied, messages that were once failing
    due to the conversion buffer limits will now be processed
    successfully.
    
    ---------------------------------------------------------------
    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

    SE47282

  • 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-03-11

  • Closed date

    2011-04-22

  • Last modified date

    2011-04-25

  • 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