IBM Support

IV83734: MQ client reports MQRC_NOT_CONVERTED (2119) when trying to MQGETa message

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • An MQ client reports reason code  2119 (MQRC_NOT_CONVERTED)
    when trying to MQGET a message.
    
    There is no error logged in the queue manager log and no FDC
    created.
    
    The issue can be observed within an
    MQ trace captured on the queue manager where the queue
    containing the message
    exists.  In the amqrmppa process trace file the follwing entry
    will be observed:-
    
    rriConvertMsgHdrs rc=MQRC_HEADER_ERROR
    

Local fix

  • Modifying SHARECNV to zero for the channel works around the
    issue.
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Users of IBM MQ with large headers as part of the message
    payload may be affected by this issue.  For example, a large
    RFH2 message may trigger the issue.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    The problem was caused by an MQRC_HEADER_ERROR in the server.
    When parsing the message headers the queue manager encountered
    an RFH header which has
    a structure length which was larger than the amount of data that
    can be returned to the client in one
    transmission.  A sanity check on these lengths fails and causes
    MQRC_HEADER_ERROR
    to be returned and this is passed back to the client.
    
    If no conversion was expected then it was possible for the
    message data to
    reach the application as expected and so the only symptom of the
    problem is
    the bad return code.
    

Problem conclusion

  • The MQ queue manager code has been corrected to successfully
    handle the larger structure length, provided that the header to
    be converted is present in the current transmission segment.
    
    The queue manager will not attempt to convert headers that span
    multiple transmission segments.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v7.0       7.0.1.15
    v7.1       7.1.0.8
    v7.5       7.5.0.8
    v8.0       8.0.0.6
    v9.0 CD    9.0.1
    v9.0 LTS   9.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

    IV83734

  • Reported component name

    WMQ AIX V7

  • Reported component ID

    5724H7221

  • Reported release

    701

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-04-14

  • Closed date

    2016-07-28

  • Last modified date

    2017-06-01

  • 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 AIX V7

  • Fixed component ID

    5724H7221

Applicable component levels

[{"Line of Business":{"code":"LOB36","label":"IBM 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:
27 February 2021