IT39013: Using the IBM MQ REST API to query subscriptions may not providea complete list

APAR status

• Closed as program error.

Error description

• When querying subscriptions using the following REST API:
  https://<HostName>/ibmmq/rest/v1/admin/qmgr/<QMgrName>/subscript
  ion?attributes=*
  
  There is only one entry for non durable subscription.
  The other non durable subscriptions are missing.
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This affects users of the IBM MQ REST API.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  When using the REST API to obtain a list of subscriptions for a
  queue manager it should return a list of all the subscriptions
  meeting the supplied attributes.  However if we have multiple
  unnamed Subscription, then only 1 of them will be returned.
  During the processing of the request we generate a Map of the
  results using the Subscription Name as the key, but this only
  allows a single entry for each unique Subscription Name.  So
  that each time we see an unnamed Subscription it replaces the
  previous one, instead of a new entry in the Map.
  
  eg.
  curl -k
  "https://localhost:9443/ibmmq/rest/v1/admin/qmgr/QM1/subscriptio
  n?attributes=*"
  

Problem conclusion

• The REST API code has been changed to ensure that each unnamed
  subscription is reported.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.2 LTS   9.2.0.5
  v9.x CD    9.2.5
  
  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 APPL M2002 V

• Fixed component ID

  5737H4701

Applicable component levels