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

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 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

• R710 PSY

     UP