A fix is available
APAR status
Closed as program error.
Error description
The update of CPSM BAS resource DB2EDEF fails with the following message: 'EYUVC1231E 'Update' (Update) request failed. Request complete for 0 records. (Failed, Exception)'. This orrurs under the following circumstances: In the resource DB2EDEF specifying a generic value ending in * for the Transaction ID, and the way our cache list search processing treats the asterisk as an ending wildcard and ignores all following search criteria, and that the DB2EDEF is associated with more than one RASGNDEF.
Local fix
*
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users * **************************************************************** * PROBLEM DESCRIPTION: Various errors may occur when * * processing a BAS DB2EDEF that is * * associated with a resource group * * (RESGROUP) that will be installed * * through a resource description * * (RESDESC) or resource assignment * * (RASGNDEF), if the DB2EDEF specifies a * * generic Transaction ID * * (DB2EDEF_TRANSID) that ends in an "*". * * * * Errors that may occur include: * * * * - If the DB2EDEF is added to the * * RESGROUP, or removed from the * * RESGROUP, or updated while * * associated with the RESGROUP, then * * transactions associated with other * * DB2EDEFs (DB2TRN resources) may not * * be installed. * * * * - If the DB2EDEF is updated and it is * * associated with multiple RESGROUPs, * * RESDESCs and/or RASGNDEFs, then the * * update may fail with a response of * * "Exception" and a reason of "Method * * failed". * * * * If this failure occurs, then the * * auxtrace of the maintenance point * * (MP) CMAS for the CICSplex the * * DB2EDEF is associated with will * * contain exception trace records * * similar to the following: * * * * Method Caller TPID Debug text * * ------ ------ ---- ---------- * * XCL2 XCLR 108 DUPE_ELE * * XCLR BMRV 107 REMSORTF * * BMRV BMRA 3 BMRVXCLR * * BMRA BMCP 7 BMRABMRV * * BMCP BMCU 5 BMCPBMRA * * BMCU XDCR 4 BMCUBMCP * * XDCR XDUP 41 DRCRXCP * * BACU XLSD 12 BACUBMCU * * * * Additionally, the MP CMAS may also * * request a dump. The title of the * * dump will be similar to the * * following: * * * * EYU0XZPT Dump,<jobname>,<cmasname>, * * <lpar>,CMAS,<tranid>,<tasknum>, * * TRAC,EYU0BMRA,<mm/dd/yy>,<hh:mm:ss> * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all CMASes must be restarted. * * * * All CMASes do not need to be restarted at * * the same time. However, if a DB2EDEF is * * updated after the maintenance point (MP) * * CMAS has been recycled with the updated code * * but before all non-MP CMASes in the network * * have been recycled with the updated code, * * then the update of the DB2EDEF may be * * successful in the MP CMAS and in the non-MP * * CMASes that have been recycled, but be * * unsuccessful in the non-MP CMASes that have * * not been recycled. To avoid this situation, * * it is recommended that the MP CMAS be * * restarted with the updated code after all * * non-MP CMASes are restarted with the updated * * code. If there are more than one MP CMAS, * * then those MP CMASes should be restarted at * * the same time. * * * * If it is not possible to delay restarting * * the MP CMAS with the updated code until * * after all non-MP CMASes are restarted with * * the updated code, then it is recommended * * that updates, including removal from the * * data repository or removal from a resource * * group, not be performed for a DB2EDEF that * * specifies a generic Transaction ID * * (DB2EDEF_TRANSID) that ends in an "*", until * * all CMASes that manage the CICSplex * * associated with the DB2EDEF have been * * restarted with the updated code. * **************************************************************** When a DB2EDEF contains a TRANSID, then an internal DB2TDEF is built for the TRANSID. This internal transaction is not added to the data repository (EYUDREP), but when the DB2EDEF is associated with a RESGROUP that will be installed through a RESDESC or RASGNDEF, the DB2TDEF is added to the BAS install list, and is visible through the RDSCPROC and SYSRES resource tables. The name of the transaction id in the internal DB2TDEF (DB2TDEF_NAME) is "DFH" followed by the TRANSID specified in the DB2EDEF. Since the DB2EDEF_TRANSID can be generic, it can end in an "*", so the internal DB2TDEF can specify a DB2TDEF_NAME that ends in an "*". For example, if the DB2EDEF_TRANSID is "AB*", then the DB2TDEF_NAME for the internal definition will be "DFHAB*". When the DB2EDEF is added to or removed from a RESGROUP, or updated while associated with a RESGROUP, and that RESGROUP will be installed through a RESDESC or RASGNDEF, then the BAS install list is searched for all previous instances of the internal DB2TDEF, using a key that consists of the DB2TDEF_NAME and the names of the RESDESC, RASGNDEF and DB2EDEF, in that order. Those instances are then removed from the BAS install list, and in the case of ADD or UPDATE, readded after the DB2EDEF is successfully processed. If the internal DB2TDEF ends in "*", then the BAS list search and removal process will select records based only on the DB2TDEF_NAME value, and will ignore the names of the RESDESC, RASGNDEF and DB2EDEF. This can cause unrelated internal DB2TDEFs to be removed from the BAS install list, which will result in these records not being installed properly, or in the case of an UPDATE, an exception during the remove process.
Problem conclusion
Since each internal DB2TDEF is unique based upon the values of its RESDESC/RASGNDEF/DB2EDEF combination, method EYU0BMCP (BMCP), which builds the BAS install list search and remove key for internal DB2TDEF elements, has been updated to specify a generic DB2TDEF_NAME value of "DFH????". This will result in the search and remove process not ignoring the names of the RESDESC, RASGNDEF and DB2EDEF when processing the BAS install list.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PM58486
Reported component name
CPSM CICS 3.1
Reported component ID
5655M1501
Reported release
100
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2012-02-20
Closed date
2012-03-22
Last modified date
2012-04-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK77264
Modules/Macros
EYU0BMCP
Fix information
Fixed component name
CPSM CICS 3.1
Fixed component ID
5655M1501
Applicable component levels
R100 PSY UK77264
UP12/03/23 P F203
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.
{"0":{"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.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},"349":{"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Line of Business":{"code":"LOB35","label":"Mainframe SW"}},"1":null,"2":null,"3":null,"4":null,"5":null,"6":null,"7":null,"8":null,"9":null,"10":null,"11":null,"12":null,"13":null,"14":null,"15":null,"16":null,"17":null,"18":null,"19":null,"20":null,"21":null,"22":null,"23":null,"24":null,"25":null,"26":null,"27":null,"28":null,"29":null,"30":null,"31":null,"32":null,"33":null,"34":null,"35":null,"36":null,"37":null,"38":null,"39":null,"40":null,"41":null,"42":null,"43":null,"44":null,"45":null,"46":null,"47":null,"48":null,"49":null,"50":null,"51":null,"52":null,"53":null,"54":null,"55":null,"56":null,"57":null,"58":null,"59":null,"60":null,"61":null,"62":null,"63":null,"64":null,"65":null,"66":null,"67":null,"68":null,"69":null,"70":null,"71":null,"72":null,"73":null,"74":null,"75":null,"76":null,"77":null,"78":null,"79":null,"80":null,"81":null,"82":null,"83":null,"84":null,"85":null,"86":null,"87":null,"88":null,"89":null,"90":null,"91":null,"92":null,"93":null,"94":null,"95":null,"96":null,"97":null,"98":null,"99":null,"100":null,"101":null,"102":null,"103":null,"104":null,"105":null,"106":null,"107":null,"108":null,"109":null,"110":null,"111":null,"112":null,"113":null,"114":null,"115":null,"116":null,"117":null,"118":null,"119":null,"120":null,"121":null,"122":null,"123":null,"124":null,"125":null,"126":null,"127":null,"128":null,"129":null,"130":null,"131":null,"132":null,"133":null,"134":null,"135":null,"136":null,"137":null,"138":null,"139":null,"140":null,"141":null,"142":null,"143":null,"144":null,"145":null,"146":null,"147":null,"148":null,"149":null,"150":null,"151":null,"152":null,"153":null,"154":null,"155":null,"156":null,"157":null,"158":null,"159":null,"160":null,"161":null,"162":null,"163":null,"164":null,"165":null,"166":null,"167":null,"168":null,"169":null,"170":null,"171":null,"172":null,"173":null,"174":null,"175":null,"176":null,"177":null,"178":null,"179":null,"180":null,"181":null,"182":null,"183":null,"184":null,"185":null,"186":null,"187":null,"188":null,"189":null,"190":null,"191":null,"192":null,"193":null,"194":null,"195":null,"196":null,"197":null,"198":null,"199":null,"200":null,"201":null,"202":null,"203":null,"204":null,"205":null,"206":null,"207":null,"208":null,"209":null,"210":null,"211":null,"212":null,"213":null,"214":null,"215":null,"216":null,"217":null,"218":null,"219":null,"220":null,"221":null,"222":null,"223":null,"224":null,"225":null,"226":null,"227":null,"228":null,"229":null,"230":null,"231":null,"232":null,"233":null,"234":null,"235":null,"236":null,"237":null,"238":null,"239":null,"240":null,"241":null,"242":null,"243":null,"244":null,"245":null,"246":null,"247":null,"248":null,"249":null,"250":null,"251":null,"252":null,"253":null,"254":null,"255":null,"256":null,"257":null,"258":null,"259":null,"260":null,"261":null,"262":null,"263":null,"264":null,"265":null,"266":null,"267":null,"268":null,"269":null,"270":null,"271":null,"272":null,"273":null,"274":null,"275":null,"276":null,"277":null,"278":null,"279":null,"280":null,"281":null,"282":null,"283":null,"284":null,"285":null,"286":null,"287":null,"288":null,"289":null,"290":null,"291":null,"292":null,"293":null,"294":null,"295":null,"296":null,"297":null,"298":null,"299":null,"300":null,"301":null,"302":null,"303":null,"304":null,"305":null,"306":null,"307":null,"308":null,"309":null,"310":null,"311":null,"312":null,"313":null,"314":null,"315":null,"316":null,"317":null,"318":null,"319":null,"320":null,"321":null,"322":null,"323":null,"324":null,"325":null,"326":null,"327":null,"328":null,"329":null,"330":null,"331":null,"332":null,"333":null,"334":null,"335":null,"336":null,"337":null,"338":null,"339":null,"340":null,"341":null,"342":null,"343":null,"344":null,"345":null,"346":null,"347":null,"348":null}
Document Information
Modified date:
22 February 2023