IT42128: AMS protected messages lose message properties when involved with SYSTEM.PROTECTION.ERROR.QUEUE

APAR status

• Closed as program error.

Error description

• SYSTEM.PROTECTION.ERROR.QUEUE used as a dead letter error queue
  for AMS protected messages when an MQGet fails for certain
  reasons.  If the AMS protected message also has properties (for
  example like RFH2 message properties)
  those properties are not retained during the error processing
  to the SYSTEM.PROTECTION.ERROR.QUEUE and back to the protected
  queue.
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  MQ AMS users who use V4 GMO MsgHandle or MQGMO_NO_PROPERTIES.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  An application that fails to unprotect a message with AMS, the
  message properties may be not retained during the error
  processing
  to the SYSTEM.PROTECTION.ERROR.QUEUE and back to the protected
   queue.
  

Problem conclusion

• The MQ AMS MQGET interceptor code is changed to deal with the
  message properties properly when an application failed to
  protect the message.
  
  The MQGET interceptor logic executes where the AMS decryption is
  performed. This is the application/client side, unless MCA
  interception is enabled for the channel in use, in which case
  the interceptor logic executes within the queue manager channel
  process .
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.1 LTS   9.1.0.15
  v9.2 LTS   9.2.0.15
  v9.3 LTS   9.3.0.10
  v9.x CD    9.3.3
  
  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:

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

Fix information

• Fixed component name

  MQ BASE V9.2

• Fixed component ID

  5724H7281

Applicable component levels