A fix is available
APAR status
Closed as program error.
Error description
Implementing the fix for APAR PI17724 in a CPSM 4.2 CMAS that connects to a CPSM 5.1 CMAS, requires that the CPSM 5.1 CMAS have the fix for APAR PI17725 implemented first, otherwise mismatches messages will result for CRESPRGM and CRESLIBR resources when CPSM compatibility testing goes on. However this testing should only be going on for active CMASes in the network. It should not be occurring for CMASes that are not currently active (in the network.) . Additional Symptom(s) Search Keyword(s): KIXREVGJT
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM V3R2M0 Users * **************************************************************** * PROBLEM DESCRIPTION: Various errors may occur when obsolete * * CPSM resource table capability matrix * * information for a CMAS is passed among * * the CMAS network: * * * * - Invalid error and informational * * messages may be issued for a * * terminated CMAS when other CMASes in * * a CMAS network start or terminate. * * * * Messages seen include, but are not * * limited to: * * * * EYUCP0016I This CMAS converts to * * the lower capability of * * CMAS <cmasname>. * * * * EYUCP0017E CM1MDP Capability of * * CMAS <cmasname> is not * * valid for this CMAS to * * connect. * * * * EYUCP0018E Resource type mismatch * * 1 with CMAS <cmasname> * * is <resname>. * * * * Note that these messages can occur * * validly. However, if the CMAS * * identified as <cmasname> is not * * active in the CMAS network, then the * * messages were issued invalidly. * * * * - Abends or invalid processing can * * occur when a CPSM resource table is * * passed between two CMASes, if the * * sender or receiver is using obsolete * * data and the version of the resource * * table is different. * * * * One specific abend seen, is an * * ASRA/S0C1 in method EYU0TSCJ (TSCJ) * * while processing an install of a * * CICS program or library. Note that * * this abend would not have occurred * * if not for a separate logic error * * that has been addressed under APAR * * PI40795, and once the PTF for that * * APAR is applied, the abend will not * * occur even if the fix for this APAR * * is not applied and obsolete data is * * being passed between CMASes. * **************************************************************** * 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 two CMASes connect directly or indirectly, each CMAS passes to the other CMAS a list of all CPSM resource tables it manages, along with the version of the table that it supports. The partner CMAS then uses that information to create a resource table capability matrix for the partner. This table is anchored in the CMAS directory element (CMASDIR) for the partner CMAS, and is used to manage resource table conversion between the two CMASes. As other CMASes enter the network, the tables are passed to them as part of the network topology (NETTOP) exchange that CMASes perform when a CMAS enters the network. When a CMAS receives this information, either directly from the partner CMAS, or from another CMAS as part of NETTOP exchange, it performs validation of the compatibility of its matrix with the other CMAS. Compatibility requires that both CMASes be at the same version for each table, or that one CMAS can have higher or lower versions, but not both higher and lower versions. If the local CMAS has higher versions, then it will issue message EYUCP0016I. If the local CMAS has higher and lower versions, then it will issue messages EYUCP0017E and EYUCP0018E, and will terminate its connections to the other CMASes in the network. Because all CMASes build the matrix for all other CMASes in the network, and pass the information around during NETTOP exchange, it is possible that if a CMAS leaves the network, for example to apply maintenance that may affect its matrix, other CMASes that have been restarted with updated matrix information may have conflicts with the old data for the terminated CMAS. While a conflict that causes the CMAS to issue message EYUCP0016I will not result in a problem, a conflict that causes messages EYUCP0017E and EYUCP0018E will result in the issuing CMAS being terminated from the network. Restarting that CMAS will result in the same errors, until the terminated CMAS is restarted and its maxtrix updated by all other CMASes in the network. Additionally, if a CMAS has an invalid matrix for another CMAS, CPSM resource table records passed between the two CMASes may not be converted correctly. If this occurs, then various unpredictable results may occur, including abends or invalid processing, when the records are being processed.
Problem conclusion
The resource table capability matrix is only required while two CMASes are connected. If the matrix of a terminated CMAS is passed to other CMASes during NETTOP exchange, it serves no purpose other than to possibly cause invalid problems. So to avoid invalid problems, updates have been made to methods EYU0CPAG (CPAG) and EYU0CPUC (CPUC), to call method EYU0MOCS (MOCS) to delete the local copy of a matrix for a CMAS that has left the network. When the CMAS returns, it will broadcast its matrix. This will ensure that other CMASes in the network will only perform validation against a current matrix.
Temporary fix
********* * HIPER * ********* FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PI40710
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
50M
Status
CLOSED PER
PE
NoPE
HIPER
YesHIPER
Special Attention
NoSpecatt
Submitted date
2015-05-08
Closed date
2015-05-22
Last modified date
2015-06-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI27874
Modules/Macros
EYU0CPAG EYU0CPRI EYU0CPUC
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R50M PSY UI27874
UP15/05/29 P F505 ½
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":"3.2","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":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
01 June 2015