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, and so it affects earlier releases only.

Local fix

Problem summary

  • ****************************************************************
    Any client program that follows the pattern of activity
    described in this APAR.
    Platforms affected:
    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
    The latest available maintenance can be obtained from
    'WebSphere MQ Recommended Fixes'
    If the maintenance level is not yet available information on
    its planned availability can be found in 'WebSphere MQ
    Planned Maintenance Release Dates'

Temporary fix


APAR Information

  • APAR number


  • Reported component name

    WMQ LIN X86-64

  • Reported component ID


  • Reported release


  • Status


  • PE




  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date


  • Closed date


  • Last modified date


  • 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 LIN X86-64

  • Fixed component ID


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: