A fix is available
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 number
PI07569
Reported component name
WMQ Z/OS V7
Reported component ID
5655R3600
Reported release
100
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2013-12-09
Closed date
2014-02-13
Last modified date
2014-04-02
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
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.
[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 April 2014