A fix is available
APAR status
Closed as program error.
Error description
You are migrating cics to V3.1 on one LPAR while another LPAR within the CICSPlex has CICS's still at V2.2. In last stage of migration step at of the first LPAR you start the CAS and CMAS. . Note: Although the customer that reported this problem was migrating to a new release of CICS TS, the act of migrating is not the cause of the problem. The problem can occur in any existing environment where a target region (AOR) is shutdown within 60 seconds of a QUIESCE request being issued for that target. . You start AORs first with an INITIAL start and then restarted them as COLD. Their status in the WLMAWORK view shows them as as being ACTIVE, as expected. Their status changes to 'QUIESING' after starting TORs with an INITIAL start. You then restart the AORs and their status becomes 'ACTIVE'. This problem occurs IF a request is issued to quiesce a mas AND the mas is shutdown within 60 seconds of the quiesce request AND the workload is not installed in the cmas that the mas is connected to AND the mas is restarted under the same cmas AND a tor is now also started under that cmas so that the workload is now installed.
Local fix
KIXREVRBD
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users * **************************************************************** * PROBLEM DESCRIPTION: When a WLMAWAOR QUIESCE request is * * issued for a MAS acting as a CPSM WLM * * target region, and the MAS is * * terminated within 60 seconds of the * * QUIESCE request, then when the MAS is * * restarted it may remain in a QUIESCING * * state and transactions may not be * * routed to it. * **************************************************************** * 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. * * * * If any MASes are invalidly in QUIESCING * * state at the time the CMASes are restarted, * * these MASes should be restarted after their * * corresponding CMAS has been restarted. * **************************************************************** When a QUIESCE request is issued for a CPSM WLM target region, method EYU0WAUO (WAUO) runs in all CMASes that manage the CICSplex that the target region is associated with. WAUO writes a record for the target region to the quiescing target region list, marks the target region as QUIESCING, and then starts method EYU0WMQS (WMQS) under transaction WMQS. After starting, WMQS goes into a 60 second delay. Upon awakening from the original 60 second delay, WMQS performs processing based upon whether or not the target region is part of a workload that is installed in the CMAS: - if the target region is part of a workload installed in the CMAS, then WMQS checks to see if the target region has any transaction affinities. If so, WMQS delays again for 60 seconds and retries. Once WMQS determines that the target region no longer has affinities, it calls method EYU0WMQA (WMQA) locally and in all other CMASes that manage the CICSplex. WMQA marks the target region as QUIESCED, and deletes the target region's entry in the quiescing target region list. When the local execution of WMQA ends and returns to WMQS, WMQS will determine that the quiescing target list is empty, and it will terminate. - if the target region is not part of a workload installed in the CMAS, then WMQS keeps delaying until the quiescing target list is empty. Once the list is empty, presumably because a CMAS in which the workload is installed has remotely executed WMQA in the local CMAS, WMQS will terminate. If the target region is terminated before the initial 60 second delay, then method EYU0WMEV (WMEV), running in each CMAS, will call method EYU0WMAT (WMAT) if the target region is part of a workload installed in the CMAS. WMAT will delete the region's entry in the quiescing target region list. If the target region is not part of a workload installed in the CMAS, then WMEV will not call WMAT, and instead, the region's entry in the quiescing target region list will not be removed. If the target region is restarted under the CMAS, and a subsequent routing region is also started under the CMAS so that the workload is installed in the CMAS, because the target region has an entry in the quiescing target region list, the target region will be marked as quiescing under the CMAS, and any routing regions connected to the CMAS will not route to it.
Problem conclusion
WMEV has been updated to call method EYU0XCLR (XCLR) to remove any entries for the MAS from the quiescing target region list if the MAS is not known as a CPSM WLM target region to the CMAS. Otherwise it will call WMAT which will call XCLR itself.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PK76791
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
2008-12-03
Closed date
2008-12-17
Last modified date
2009-01-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PK76806 UK42592
Modules/Macros
EYU0WMEV
Fix information
Fixed component name
CPSM CICS 3.1
Fixed component ID
5655M1501
Applicable component levels
R100 PSY UK42592
UP08/12/19 P F812
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"}},"395":{"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}
Document Information
Modified date:
22 February 2023