IT24140: MQAI does not use MQRO_DISCARD_MSG or MQRO_PASS_DISCARD_AND_EXPIRY

APAR status

• Closed as program error.

Error description

• The MQAI (MQ Administration Interface) places command messages
  on the input queue for the queue manager's command server.
  These messages do not have MQRO_DISCARD_MSG or
  MQRO_PASS_DISCARD_AND_EXPIRY in the MQMD.Report field, so the
  command server will not copy the expiration time from the
  request message into the reply message, and will not discard the
  message.
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Users who use the MQAI and need the behaviour of
  MQRO_DISCARD_MSG and MQRO_PASS_DISCARD_AND_EXPIRY.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  It is reasonable to require that the MQAI operates using
  MQRO_DISCARD_MSG and MQRO_PASS_DISCARD_AND_EXPIRY on command
  messages, but the option was not provided within MQAI.
  

Problem conclusion

• Additional code is added to the MQAI library code, to detect an
  environment variable named AMQ_MQAI_USE_NEW_MQRO_IN_CMD.
  
  If it is set (to any value) then the MQAI library code running
  in the application will add options MQRO_DISCARD_MSG and
  MQRO_PASS_DISCARD_AND_EXPIRY to MQMD.Report before the command
  message is put to the command server's input queue.
  
  This environment variable must be set in the environment of the
  MQAI application program.  There is no need to set it in the
  environment of the queue manager.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v7.5       7.5.0.9
  v8.0       8.0.0.10
  v9.0 LTS   9.0.0.4
  
  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

  WMQ BASE MULTIP

• Fixed component ID

  5724H7241

Applicable component levels