PI07569: WEBSPHERE MQ 710 : RC3309 MQRCCF_SUBSCRIPTION_POINT_ERR

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• WebSphere MQ 710 on z/OS
  
  A register subscriber (RegSub) is failing with
  MQRCCF_SUBSCRIPTION_POINT_ERR, indicating that
  name-list SYSTEM.QPUBSUB.SUBPOINT.NAMELIST does not contain the
  name of topic object with a topic string of the specified
   subcription point.
  
  Dump shows that the rc3309 is occurring in
  faiSubPointToObjectName because the topicstring cache used by
  the pubsub daemon has not been created.
  
  You can verify this condition in the chinit joblog .
  It can log the error:
  
  CSQX036E CSQXSUPR Unable to open
                 TOPIC(SYSTEM.BROKER.DEFAULT.STREAM),
                 MQCC=2 MQRC=2531 (MQRC_PUBSUB_INHIBITED)
  
  
  There is a window where the topic string cache
  can fail to be created during chinit startup, if the queue
  manager is still starting and has not yet fully initialised the
  pubsub engine.
  
  This can occur when the chinit is started automatically due to
  a START CHINIT command in one of the CSQINP2 datasets.
  

Local fix

• 1) wait for the queue manager to finish starting before issuing
  START CHINIT
  
  or
  
  2) issue the following command after the qmgr and chinit
  have both finished starting:
  /cpf ALT NAMELIST(SYSTEM.QPUBSUB.SUBPOINT.NAMELIST)
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of WebSphere MQ for z/OS Version 7 *
  *                 Release 0 Modification 1 and Release 1       *
  *                 Modification 0.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Registering a subscription using a      *
  *                      subscription point fails MQRC 3309      *
  *                      MQRCCF_SUBSCRIPTION_POINT_ERR           *
  *                      when the channel initiator is started   *
  *                      in CSQINP2, or while pubsub is disabled *
  *                      (PSMODE(DISABLED)).                     *
  *                      CSQX036E can also be seen, reporting    *
  *                      an error opening a topic with MQRC      *
  *                      2531 MQRC_PUBSUB_INHIBITED              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  During channel initiator startup, rivPopulateTopicCache is
  called to create the topic reverse lookup cache. If the channel
  initiator is starting at the same time as the queue manager (for
  example, CSQINP2 contains a START CHINIT command), a timing
  window exists where rivPopulateTopicCache is called while the
  topic manager component of the queue manager is still
  initialising.
  When rivPopulateTopicCache attempts to open the topic objects
  listed in SYSTEM.QPUBSUB.SUBPOINT.NAMELIST, the MQOPEN fails
  MQRC 2531 (MQRC_PUBSUB_INHIBITED), as reported by CSQX036E,
  and the cache is not created.
  Similarly, if pubsub is disabled when the chinit is started,
  rivPopulateTopicCache fails to create the cache.
  When a subscription is subsequently registered on a subpoint,
  the specified subpoint cannot be located in the cache, leading
  to the RegSub failing MQRCCF_SUBSCRIPTION_POINT_ERR (3309).
  

Problem conclusion

• Additional serialisation is added to ensure topic manager has
  started before rivPopulateTopicCache is called to build the
  cache.
  In addition, rivPopulateTopicCache is now also called when
  pubsub is enabled (PSMODE changed from DISABLED to either
  COMPAT or ENABLED).
  010Y
  100Y
  CSQMCAMM
  CSQMPRTP
  CSQMQMUP
  CSQXSPRI
  CSQXSPRM
  

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:

  UI15074 UI15075

Modules/Macros

• CSQMCAMM CSQMPRTP CSQMQMUP CSQXSPRI CSQXSPRM
  

Fix information

• Fixed component name

  WMQ Z/OS V7

• Fixed component ID

  5655R3600

Applicable component levels

• R010 PSY UI15074

     UP14/03/04 P F403

• R100 PSY UI15075

     UP14/03/04 P F403

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.