A fix is available
APAR status
Closed as program error.
Error description
API PERFORM OBJECT returns Response 1034 Notavailable and Reason 1294 Scope. At the same time as the error response, you are shutting down your CICS region that is within the scope. Just prior to the NOTAVAILABLE response, you see message : EYUTS0003I Topology Disconnect. With PTF UK15822 applied, you expect the API command to complete successfully while a MAS is shutting down. You also expect to see CTBP trace with debug text TrgtUnav and trace point 28, however, it is not produced. Additional Symptom(s) and Keyword(s): 5655-M1501 5655M1501 R310 310
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users * **************************************************************** * PROBLEM DESCRIPTION: - When CPSM Monitoring is active for a * * MAS, and a retention period is * * specified to allow the data to be * * viewed after the MAS terminates, the * * data will not be displayed when the * * MAS terminates if CPSM security is * * active for the CMAS the MAS was * * connected to. * * * * - Users may experience invalid results * * when the scope of an EUI, API, or * * WUI request includes a MAS that is * * in the process of terminating, if * * CPSM security is active for the CMAS * * the MAS was connected to. * * * * - EUI users may receive message: * * * * EYUEI0590E Communications to * * <masname> unavailable * * * * Hitting enter will cause data for * * other systems in the scope to be * * displayed. Note that in some * * situations the message will not * * be displayed. * * * * - API users will receive a RESPONSE * * of 1034 (NOTAVAILABLE) and a * * REASON of 1294 (SCOPE). * * * * - WUI users will receive message: * * * * EYUVC1288W The requested * * resource is not * * supported by any * * available MASs in the * * specified scope. * **************************************************************** * 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 security is active in a CMAS, method EYU0CRCK (CRCK) is called by method EYU0MSIN (MSIN - CPSM Monitor data requests) or method EYU0XLSD (XLSD - non-CPSM Monitor data requests) when an EUI, API, or WUI is initiated (front end check) and completed (back end check) to verify if the requestor has authority to perform the request. If the request is associated with a MAS, CRCK attempts to retrieve the MAS's security information block (SCMIB). If the SCMIB does not exist, CRCK will fail the request, returning target unavailable to its caller. - When MSIN is the caller, it sets a response of OK to the requestor, but does not return the data. - When XLSD is the caller of CRCK, it will return a failure response to the caller.
Problem conclusion
To resolve these problems, once the SCMIB is acquired, it will not be freed until the CMAS terminates or the CSYSDEF of the MAS associated with the SCMIB is removed from the data repository (EYUDREP). To affect this change, the following updates have been made: - Method EYU0CRSC (CRSC), which is called at MAS startup, has been updated to determine if the SCMIB currently exists. If it does not, CRSC will allocate it from CICS ESDSA, and place the security information for the MAS into the block. If the SCMIB does exist, CRSC will clear it, and then place the security information for the MAS into the block. This ensures that the block is updated from the last time the MAS started. - Method EYU0CRST (CRST) which is called at MAS shutdown, has been updated to not free the SCMIB. - Method EYU0TSSD (TSSD) which is called when a CSYSDEF is removed from the EYUDREP, has been updated to see if the SCMIB is still allocated for the MAS associated with the CSYSDEF. If it is, it will free the SCMIB from the CICS ESDSA.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
- When CPSM Monitoring is active for a MAS, and a retention period is specified to allow the data to be viewed after the MAS terminates, the data will not be displayed when the MAS terminates if CPSM security is active for the CMAS the MAS was connected to. - Users may experience invalid results when the scope of an EUI, API, or WUI request includes a MAS that is in the process of terminating, if CPSM security is active for the CMAS the MAS was connected to. - EUI users may receive message: EYUEI0590E Communications to <masname> unavailable Hitting enter will cause data for other systems in the scope to be displayed. Note that in some situations the message will not be displayed. - API users will receive a RESPONSE of 1034 (NOTAVAILABLE) and a REASON of 1294 (SCOPE). - WUI users will receive message: EYUVC1288W The requested resource is not supported by any available MASs in the specified scope. When security is active in a CMAS, method EYU0CRCK (CRCK) is called by method EYU0MSIN (MSIN - CPSM Monitor data requests) or method EYU0XLSD (XLSD - non-CPSM Monitor data requests) when an EUI, API, or WUI is initiated (front end check) and completed (back end check) to verify if the requestor has authority to perform the request. If the request is associated with a MAS, CRCK attempts to retrieve the MAS's security information block (SCMIB). If the SCMIB does not exist, CRCK will fail the request, returning target unavailable to its caller. - When MSIN is the caller, it sets a response of OK to the requestor, but does not return the data. - When XLSD is the caller of CRCK, it will return a failure response to the caller. To resolve these problems, once the SCMIB is acquired, it will not be freed until the CMAS terminates or the CSYSDEF of the MAS associated with the SCMIB is removed from the data repository (EYUDREP). To affect this change, the following updates have been made: - Method EYU0CRSC (CRSC), which is called at MAS startup, has been updated to determine if the SCMIB currently exists. If it does not, CRSC will allocate it from CICS ESDSA, and place the security information for the MAS into the block. If the SCMIB does exist, CRSC will clear it, and then place the security information for the MAS into the block. This ensures that the block is updated from the last time the MAS started. - Method EYU0CRST (CRST) which is called at MAS shutdown, has been updated to not free the SCMIB. - Method EYU0TSSD (TSSD) which is called when a CSYSDEF is removed from the EYUDREP, has been updated to see if the SCMIB is still allocated for the MAS associated with the CSYSDEF. If it is, it will free the SCMIB from the CICS ESDSA.
APAR Information
APAR number
PK48003
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-06-28
Closed date
2007-09-12
Last modified date
2007-10-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PK50723 UK29126
Modules/Macros
EYU0CRSC EYU0CRST EYU0TSSD EYU0TSTS
Fix information
Fixed component name
CPSM CICS 3.1
Fixed component ID
5655M1501
Applicable component levels
R100 PSY UK29126
UP07/09/14 P F709
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"}},"478":{"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}
Document Information
Modified date:
22 February 2023