A fix is available
APAR status
Closed as program error.
Error description
You receive message EYUXU0218I Batch CREATE request complete - Status (INCONSISTENT_SET) - Associated fields RESDESC. This occurs when you you have two program definitions that have the same remote name and try to associate them to the same related scope.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users * **************************************************************** * PROBLEM DESCRIPTION: If two different FILEDEFs, PROGDEFs, * * TDQDEFs, or TRANDEFs that have the same * * remote name (xxxxDEF_REMOTENAME) are * * linked to the same RELATED system, an * * inconsistent set error may occur for * * the RELATED system(s). * * * * The error will always occur if both * * definitions are linked through the same * * RESDESC. It may occur if the RESDESCs * * are different. * **************************************************************** * 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 FILEDEF, PROGDEF, TDQDEF, or TRANDEF that has a remote name is linked to a RELATED system, if an existing definition of the same type with the same remote name is already linked to the RELATED system, then method EYU0BMRA (BMRA) is called to perform inconsistent set checking. - If the RESDESCs are the same for both definitions, BMRA will fail the request with an inconsistent set error. - If the RESDESCs are different, then BMRA will call method EYU0BMRB (BMRB) to compare the two definitions to ensure that there are no inconsistencies. Since there are attributes within the definitions that may contain different irrelevant data (e.g, reserved attributes, description attributes, obsolete attributes, ...), BMRB uses entries in table EYUTBMZT to temporarily clear these attributes in the existing and candidate records, and then compares the entire records. Currently, EYUTBMZT is missing entries for some attributes that should not be tested for inconsistent set processing for the FILEDEF, PROGDEF, and TRANDEF tables. If any of these attributes contain data that is not identical, the compare will fail, and an inconsistent set error will be returned to the caller. Additionally, BMRB must reset attributes that do not apply to the RELATED system to null values before the compare is performed (e.g, REMOTESYSTEM). The PROGDEF_TRANSID is not being nulled even though it is not relevant for RELATED systems.
Problem conclusion
The following changes have been made to resolve both instances of invalid inconsistent set errors: - BMRA has been updated to not return an inconsistent set error when the RESDESC is the same for definitions that have the same remote name. Instead, BMRA will call BMRB to check the records, as it already does when the RESDESCs are different. - EYUTBMZT has been updated to contain entries for all attributes that do not need to be tested for inconsistent set processing in the FILEDEF, PROGDEF, and TRANDEF tables. BMRB has been updated to clear the PROGDEF_TRANSID attribute for RELATED systems. This change has also been added to methods EYU0BMES (BMES) and EYU0BMER (BMER), to ensure that PROGDEF_TRANSID is not populated when performing a start up install (BMES) or an adhoc install (BMER) of a PROGDEF in a RELATED system. Finally, BMRB has been updated to recognize that the default for the PROGDEF_CONCURRENCY attribute is QUASIRENT.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
If two different FILEDEFs, PROGDEFs, TDQDEFs, or TRANDEFs that have the same remote name (xxxxDEF_REMOTENAME) are linked to the same RELATED system, an inconsistent set error may occur for the RELATED system(s). The error will always occur if both definitions are linked through the same RESDESC. It may occur if the RESDESCs are different. When a FILEDEF, PROGDEF, TDQDEF, or TRANDEF that has a remote name is linked to a RELATED system, if an existing definition of the same type with the same remote name is already linked to the RELATED system, then method EYU0BMRA (BMRA) is called to perform inconsistent set checking. - If the RESDESCs are the same for both definitions, BMRA will fail the request with an inconsistent set error. - If the RESDESCs are different, then BMRA will call method EYU0BMRB (BMRB) to compare the two definitions to ensure that there are no inconsistencies. Since there are attributes within the definitions that may contain different irrelevant data (e.g, reserved attributes, description attributes, obsolete attributes, ...), BMRB uses entries in table EYUTBMZT to temporarily clear these attributes in the existing and candidate records, and then compares the entire records. Currently, EYUTBMZT is missing entries for some attributes that should not be tested for inconsistent set processing for the FILEDEF, PROGDEF, and TRANDEF tables. If any of these attributes contain data that is not identical, the compare will fail, and an inconsistent set error will be returned to the caller. Additionally, BMRB must reset attributes that do not apply to the RELATED system to null values before the compare is performed (e.g, REMOTESYSTEM). The PROGDEF_TRANSID is not being nulled even though it is not relevant for RELATED systems. The following changes have been made to resolve both instances of invalid inconsistent set errors: - BMRA has been updated to not return an inconsistent set error when the RESDESC is the same for definitions that have the same remote name. Instead, BMRA will call BMRB to check the records, as it already does when the RESDESCs are different. - EYUTBMZT has been updated to contain entries for all attributes that do not need to be tested for inconsistent set processing in the FILEDEF, PROGDEF, and TRANDEF tables. BMRB has been updated to clear the PROGDEF_TRANSID attribute for RELATED systems. This change has also been added to methods EYU0BMES (BMES) and EYU0BMER (BMER), to ensure that PROGDEF_TRANSID is not populated when performing a start up install (BMES) or an adhoc install (BMER) of a PROGDEF in a RELATED system. Finally, BMRB has been updated to recognize that the default for the PROGDEF_CONCURRENCY attribute is QUASIRENT.
APAR Information
APAR number
PK57840
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
2007-12-07
Closed date
2008-06-03
Last modified date
2008-07-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PK57888 UK37029
Modules/Macros
EYUTBMZT EYU0BMER EYU0BMES EYU0BMRA EYU0BMRB
GC34642302 | GC34642402 | GC34642502 |
Fix information
Fixed component name
CPSM CICS 3.1
Fixed component ID
5655M1501
Applicable component levels
R100 PSY UK37029
UP08/06/05 P F806
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"}},"506":{"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,"349":null,"350":null,"351":null,"352":null,"353":null,"354":null,"355":null,"356":null,"357":null,"358":null,"359":null,"360":null,"361":null,"362":null,"363":null,"364":null,"365":null,"366":null,"367":null,"368":null,"369":null,"370":null,"371":null,"372":null,"373":null,"374":null,"375":null,"376":null,"377":null,"378":null,"379":null,"380":null,"381":null,"382":null,"383":null,"384":null,"385":null,"386":null,"387":null,"388":null,"389":null,"390":null,"391":null,"392":null,"393":null,"394":null,"395":null,"396":null,"397":null,"398":null,"399":null,"400":null,"401":null,"402":null,"403":null,"404":null,"405":null,"406":null,"407":null,"408":null,"409":null,"410":null,"411":null,"412":null,"413":null,"414":null,"415":null,"416":null,"417":null,"418":null,"419":null,"420":null,"421":null,"422":null,"423":null,"424":null,"425":null,"426":null,"427":null,"428":null,"429":null,"430":null,"431":null,"432":null,"433":null,"434":null,"435":null,"436":null,"437":null,"438":null,"439":null,"440":null,"441":null,"442":null,"443":null,"444":null,"445":null,"446":null,"447":null,"448":null,"449":null,"450":null,"451":null,"452":null,"453":null,"454":null,"455":null,"456":null,"457":null,"458":null,"459":null,"460":null,"461":null,"462":null,"463":null,"464":null,"465":null,"466":null,"467":null,"468":null,"469":null,"470":null,"471":null,"472":null,"473":null,"474":null,"475":null,"476":null,"477":null,"478":null,"479":null,"480":null,"481":null,"482":null,"483":null,"484":null,"485":null,"486":null,"487":null,"488":null,"489":null,"490":null,"491":null,"492":null,"493":null,"494":null,"495":null,"496":null,"497":null,"498":null,"499":null,"500":null,"501":null,"502":null,"503":null,"504":null,"505":null}
Document Information
Modified date:
22 February 2023