IT18123: Upgrading an IBM MQ version 8 queue manager to version 9 does not create the new SYSTEM.ADMIN.TOPIC object

APAR status

• Closed as program error.

Error description

• When an IBM MQ version 8 queue manager is upgraded to MQ version
  9, the migrated queue manager does not have SYSTEM.ADMIN.TOPIC
  object which was introduced in MQ version 9.
  

Local fix

• Use the following runmqsc command to add the new object into the
  migrated
  queue manager:
    DEFINE TOPIC('SYSTEM.ADMIN.TOPIC') +
     TYPE(LOCAL) +
     TOPICSTR('$SYS/MQ') +
     DESCR('Root topic for MQ administrative topics') +
     CLUSTER(' ') +
     CLROUTE(DIRECT) +
     DURSUB(YES) +
     PUB(ENABLED) +
     SUB(ENABLED) +
     DEFPSIST(NO) +
     DEFPRTY(0) +
     DEFPRESP(SYNC) +
     PMSGDLV(ALLDUR) +
     NPMSGDLV(ALLAVAIL) +
     PUBSCOPE(QMGR) +
     SUBSCOPE(QMGR) +
     PROXYSUB(FIRSTUSE) +
     WILDCARD(BLOCK) +
     MDURMDL('SYSTEM.DURABLE.MODEL.QUEUE') +
     MNDURMDL('SYSTEM.NDURABLE.MODEL.QUEUE') +
     MCAST(DISABLED) +
     COMMINFO(' ') +
     USEDLQ(YES) +
     CUSTOM(' ') +
     REPLACE
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All MQ users who migrate their MQ 8.0 queue managers to MQ 9.0
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  A logic error within the MQ queue manager migration code meant
  that the code created SYSTEM.ADMIN.TOPIC only when MQ 7.5 or
  lower level queue managers were migrated to MQ 9.0 level. The
  object was incorrectly not created when MQ 8.0 queue managers
  were migrated to MQ 9.0 level.
  

Problem conclusion

• The code has been modified to create SYSTEM.ADMIN.TOPIC object
  when MQ 8.0 or lower level queue managers are migrated to MQ 9.0
  level.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.0 CD    9.0.4
  v9.0 LTS   9.0.0.2
  
  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

  IBM MQ BASE M/P

• Fixed component ID

  5724H7261

Applicable component levels

• R900 PSY

     UP