IBM Support

IJ03418: MQ client: MQGET fails with ReasonCode 2460 (MQRC_HMSG_ERR) invalidly

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

APAR status

  • Closed as program error.

Error description

  • An MQ Client attempts to do an MQGET, but fails with ReasonCode
    2460 (MQRC_HMSG_ERR).
    
    The MQGET should have succeeded.
    
    The issue affects only the client libraries.  It was fixed prior
    to release of 8.0.0.0, and so it affects earlier releases only.
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Any client program that follows the pattern of activity
    described in this APAR.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    These are the necessary conditions to see this problem.
    - The client application supplies a version 4 (or higher) MQGMO
    structure within its call to MQGET.
    - The client application supplies a valid value for
    MQGMO.MsgHandle other than MQHM_NONE (0).
    - The queue manager has processed the MQGET and is returning a
    failure CompCode (MQCC_FAILED) and associated reason.  For
    example, the reason code could be MQRC_NO_MSG_AVAILABLE (2033)
    but it could be any failure condition.
    
    A state error was kept in memory from the failure, and the next
    call to MQGET failed with reason code MQRC_HMSG_ERR (2460).
    

Problem conclusion

  • The MQ product code has been corrected so that the state error
    is not kept in memory.  This means the MQRC_HMSG_ERR failure is
    no longer seen.
    
    It will still be possible, as always, for the MQRC_HMSG_ERR
    error to be returned for valid reasons, that is when the user
    has supplied a bad value for MQGMO.MsgHandle.
    
    If this reason code is seen after this fix is applied, then
    check the Knowledge Center for a description and suggested
    programmer response.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v7.5       7.5.0.9
    
    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

    IJ03418

  • Reported component name

    WMQ LIN X86-64

  • Reported component ID

    5724H7230

  • Reported release

    710

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-01-19

  • Closed date

    2018-01-30

  • Last modified date

    2018-01-30

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

    IT23767

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

Fix information

  • Fixed component name

    WMQ LIN X86-64

  • Fixed component ID

    5724H7230

Applicable component levels



Document information

More support for: WebSphere MQ
APAR / Maintenance

Software version: 710

Reference #: IJ03418

Modified date: 30 January 2018


Translate this page: