A fix is available
APAR status
Closed as program error.
Error description
CPSM EYU0MOXT may incorrectly convert a queue record in some circumstances. Base table records are converted to a version compatible with the capabilities of the CMAS. If the version of a record has changed, MOXT may overlay some of the record being processed. Unpredictable results may occur. . This issue may be exposed and cause a problem if a PTF has been applied that causes a version change in a table record, but the modules affected by the PTF are not completely rolled into the CMAS's load libraries. . For example, if a PTF affects modules in both SEYUAUTH and SEYULOAD, but only the SEYUAUTH dataset changes are rolled into the running CMAS's loadlibs (or vice versa,) it might cause an abend (SOC1 or ASRA) in another CMAS. That is because when two CMASes exchange capabilities at startup, they indicate to each other what version of each base record type they are using. That information comes from modules in SEYUAUTH. However, when those base records actually get built and sent around during the running of the CMAS, the modules in SEYULOAD perform that function. If the CMAS is indicating to other CMASes through SEYUAUTH members that it uses version '1234' of a given record, but it builds version '5678' though SEYULOAD members, then other CMASes processing those records may encounter unpredictable results, including abends. One specific abend encountered so far was an intentional ASRA S0C1 out of EYU0TSCJ method. . . Additional Symptom(s) Search Keyword(s): KIXREVSVR
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users * **************************************************************** * PROBLEM DESCRIPTION: Abend ASRA/S0C1 may occur in method * * EYU0TSCJ (TSCJ) if a topology resource * * map (CRESxxxx resource table) is passed * * between two CPSM V3R1M0 CMASes which * * are at different maintenance levels for * * the CRESxxxx resource table. * * * * This can occur when CRESPRGM records * * are passed between two CMASes, if one * * CMAS has PTF UI21432 or UI19878 * * applied, and the other CMAS does not. * * This problem can also occur if PTF * * UI27873 is not applied. * * * * The problem can also occur when a CPSM * * V3R1M0 CMAS manages a CICSplex whose * * maintenance point (MP) CMAS is running * * a higher release of CPSM. * * * * In addition to the ASRA/S0C1 abend in * * TSCJ, other symptoms include Topology * * join failures, and missing records in * * get requests issued through the EUI, * * WUI or a CPSM API program. When either * * of these problems occur, the following * * exception trace records may be issued * * by CMASes exhibiting these symptoms: * * * * Method TPID Debug text * * ------ ---- ---------- * * MOXT 106 TAB_VER * * XQGQ 1 GETQXCP * * TSCJ 8 TSCJXQGQ * **************************************************************** * 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 CICS resource that CPSM manages through Topology resource maps is added or removed in a MAS, a CRESxxxx record is built in the CMAS to which the MAS is connected (for example a CRESPRGM record for PROGRAM resources). The local CMAS uses the record to change the resource maps for the MAS, and then ships the record to other CMASes in the network in a CPSM queue structure, where the record is used to update the MAS's resource maps in the receiving CMASes. The processing of the records in the remote CMASes is performed by TSCJ. These resource maps are used by CPSM's single system image (SSI) processing to determine where to direct EUI, WUI, API and RTA requests. If the maps are incorrect, then requests may not be directed correctly. If the CRESxxxx is at a different version in the two CMASes, then method EYU0MOXS (MOXS) is called in the CMAS that has the later version of the resource table, to convert the record to the proper version. A logic error in MOXS causes the record to not be converted properly. When TSCJ runs in the remote CMAS to process the record, it calls method EYU0XQGQ (XQGQ) to read the record from the queue. XQGQ will recognize that the record is not at the correct version and will call method EYU0MOXT to convert the record properly. A logic error in MOXT will again cause the the record to not be converted properly. This will lead to either the ASRA/S0C1 in TSCJ, or the Topology failure or missing records in get requests.
Problem conclusion
Method MOXS has been updated to ensure that CRESxxxx records are properly converted when being shipped between CMASes that have different versions of the record. In addition, changes have been made to methods MOXT, XQGQ and EYU0XQTQ (XQTQ) to ensure if other problems cause MOXS not to convert CRESxxxx records properly, that MOXT will convert it when the processing method reads it from a CPSM queue structure.
Temporary fix
********* * HIPER * ********* FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PI40797
Reported component name
CPSM CICS 3.1
Reported component ID
5655M1501
Reported release
100
Status
CLOSED PER
PE
NoPE
HIPER
YesHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2015-05-10
Closed date
2016-04-26
Last modified date
2016-05-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI37321
Modules/Macros
EYU0MOXS EYU0MOXT EYU0XQGQ EYU0XQTQ EYU9XDPU EYU9XDP3 EYU9XDP4
Fix information
Fixed component name
CPSM CICS 3.1
Fixed component ID
5655M1501
Applicable component levels
R100 PSY UI37321
UP16/04/28 P F604
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"}},"527":{"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,"506":null,"507":null,"508":null,"509":null,"510":null,"511":null,"512":null,"513":null,"514":null,"515":null,"516":null,"517":null,"518":null,"519":null,"520":null,"521":null,"522":null,"523":null,"524":null,"525":null,"526":null}
Document Information
Modified date:
22 February 2023