A fix is available
APAR status
Closed as program error.
Error description
You shut down a CICS MAS region at the same time you start up a CMAS. Because of the way CPSM ships network topology around when a CMAS is coming into the network, there is a situation where some CMASes may incorrectly end up having MASDIR records indicating that a MAS is active while other CMASes do not. The MAS in this case is not actually active or connected to any CMAS in the network. When the MAS does try to connect to one of the CMASes that thinks it is already active, it will incorrectly receive an EYUCL0107E message stating that the MAS is already active. . Additional Keywords/Symptoms KIXREVSVR
Local fix
Recycle the CMAS where the MAS in question last connected. This should clear up residual MASDIR elements.
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM V5R1M0 Users * **************************************************************** * PROBLEM DESCRIPTION: When a MAS is terminating while a CMAS * * is connecting into the network, that * * CMAS and other CMASes in the network * * may attempt to Topology Join the MAS * * after it has already terminated. This * * will result in the MAS not being * * connected or joined to the CMASes when * * it is restarted. * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all CMASes must be restarted. Note * * that the restarts do not need to occur at * * the same time. * **************************************************************** When a MAS Topology Joins to a CMAS, the joining CMAS checks the signatures of the CICS resource maps for the MAS. If the signatures provided by the connecting CMAS do not match the joining CMASes current signatures, then the joining CMAS sends requests for methods EYU0TSLG (TSLG) and EYU0TSG2 (TSG2) to run in the CMAS to which the MAS connected, to retrieve the latest versions of the CICS resource maps for the MAS. If the MAS has terminated by the time TSLG and TSG2, run the connecting CMAS will fail the request. This failure will be returned to the joining CMAS, which will fail the Topology Join. However, if the signatures of the CICS resource maps match, the joining CMAS does not send the TSLG and TSG2 requests, and as a result, will not be alerted by the connecting CMAS that the MAS has already terminated.
Problem conclusion
Method EYU0TSMJ (TSMJ), which sends the TSLG and TSG2 requests from the joining CMAS to the connecting CMAS, has been updated to send a dummy TSLG request to the connecting CMAS if the CICS resource maps for a MAS match. This will ensure that the joining CMAS will be alerted if a MAS that it is trying to join is no longer active.
Temporary fix
********* * HIPER * ********* FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PM77762
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
80M
Status
CLOSED PER
PE
NoPE
HIPER
YesHIPER
Special Attention
NoSpecatt
Submitted date
2012-11-26
Closed date
2013-01-15
Last modified date
2015-03-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK90953
Modules/Macros
EYU0TSLG EYU0TSMJ EYU9TSR3 EYU9TSR4 EYU9TSRU
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
Applicable component levels
R80M PSY UK90953
UP13/01/17 P F301
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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"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":"5.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
04 March 2015