IBM Support

PK47554: MAS DOES NOT CONNECT OR JOIN TO CMAS. EXCEPTION TRACE HAS AN ENTRY FROM XSRS WITH DEBUG:INSUFSTG

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • You have a CICS (LMAS) region that is connecting to the CMAS,
    but after you have successfully install your resources
    (EYUBN0099I), you see message EYUNL0901, normal shutdown entered
    on the LMAS job log.  There are not any error messages in the
    JESMSGLOG or the EYULOG of the CMAS.
    We found that EYU0XSRS is requesting a global lock for EYU0XELK
    and gets a response of XELK_QUEUE_NOT_AVAILABLE (X'14'). This
    causes XSRS to issue the trace entry with the debug text of
    INSUFSTG.
    At the time of the failure EYU9XEUT is executed requesting the
    dump of the locks:
    Total number of Resource Queues                131,072
    Number of Resource Queues in use               131,060  ( 99.9%)
    -
    You may also encounter a problem where a MAS connecting to
    another CMAS may not JOIN the CICSplex in the LOCAL LPAR.
    This problem normally occurs when there are multiple CMAS's
    running at the same release in  a single LPAR.  In this
    confiuration CMAS's share the lock structure from the
    single ESSS.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users                 *
    ****************************************************************
    * PROBLEM DESCRIPTION:    You see Topology Connect and Join    *
    *                      failures after several hundred MASes    *
    *                      have already conected to a plex.  You   *
    *                      see message EYUTS0002E in the CMAS      *
    *                      joblog, and you may also see message    *
    *                      .                                       *
    *                           EYUNL0901I  LRT NORMAL termination *
    *                                initiated                     *
    *                      .                                       *
    *                      in the LMAS job log.  The AUXTRACE for  *
    *                      the the CMAS and any affected LMAS's    *
    *                      contains user exception records written *
    *                      by method XSRS (EYU0XSRS - Global Lock  *
    *                      Registration), with a Debug text of     *
    *                      INSUFSTG.  A dump of the global lock    *
    *                      manager via the EYU9XEUT program showed *
    *                      131,060 out of 131,072 global lock ele- *
    *                      ments were in use.                      *
    ****************************************************************
    * RECOMMENDATION: After applying the PTFs that resolve this    *
    *                 APAR, all CPSM Environment Services System   *
    *                 Services (ESSS) Address Spaces must be       *
    *                 restarted before any CMASes, MASes or CPSM   *
    *                 API programs are run which access the        *
    *                 updated code.  The ESSS may be restarted in  *
    *                 two ways :                                   *
    *                                                              *
    *                 1 - IPL the MVS Image.                       *
    *                                                              *
    *                 Or, if an IPL is not possible:               *
    *                                                              *
    *                 2 - Stop all CMASes and MASes on the MVS     *
    *                     image.                                   *
    *                   - Use EYU9XENF to check that no Address    *
    *                     Spaces are connected to the ESSS.        *
    *                   - Use the EYU9XEUT TERMINATE function to   *
    *                     stop the ESSS service address space.     *
    *                   - Refresh LLA to ensure the updated        *
    *                     version of EYU9X310 is picked up.        *
    *                   - Restart the CMASes and MASes, ensuring   *
    *                     that the updated libraries are being     *
    *                     picked up.                               *
    *                                                              *
    *                    For details on EYU9XENF and the EYU9XEUT  *
    *                 TERMINATE function refer to the manual "CICS *
    *                 Transaction Server for z/OS CICSPlex SM      *
    *                 Problem Determination Version 3 Release 1"   *
    *                 (GC34-6472-xx).                              *
    *                                                              *
    *                    Note that each MVS image can be updated   *
    *                 separately, and systems on an MVS image that *
    *                 are using the new code can communicate with  *
    *                 systems on other MVS images that are not yet *
    *                 using the new code.                          *
    ****************************************************************
       CPSM locking is implemented in the ESSS Subsystem;  a pool
    of 131,072 resource lock blocks is maintained in the private
    area of the EYUX310 address space on each LPAR.  If multiple
    CMASes managing the same plex reside on a single MVS image, the
    need to maintain resource topology cache lists for all MASes
    in the plex in each CMAS's TOP cache data space may cause the
    resource lock block pool to be exhausted.  This may result in
    failures including, but not limited to, failure to complete
    CMAS-to-CMAS connections when new CMASes become active, failure
    of Topology Connect or Join to complete, and failures in methods
    which create new queues or cache lists, because new global locks
    cannot be registered.
       This is more likely to occur when two CMASes running the same
    release of CPSM are started in the same MVS image.
    

Problem conclusion

  •    The global lock pool, which is allocated from the extended
    private area of the EYUX310 address space when the ESSS is
    initialized, was increased to 262,144 lock elements and 524,288
    Holder/Waiter elements.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

  •    You have a CICS (LMAS) region that is connecting to the CMAS,
    but after you have successfully installed your BAS resources
    (EYUBN0099I), you see message:
         EYUNL0901I  LRT NORMAL termination initiated
    in the LMAS job log.  There are no error messages in the CMAS
    JOBLOG or EYULOG.  The AUXTRACE for the CICS region contains a
    user exception record written by method XSRS (EYU0XSRS - Global
    Lock Registration), with a Debug text of INSUFSTG.  A dump of
    the global lock manager via the EYU9XEUT program showed that
    131,060 out of 131,072 global lock elements were in use.
    
    
       CPSM locking is implemented in the ESSS Subsystem;  a pool
    of 131072 resource lock blocks is maintained in the private
    area of the EYUX310 address space on each LPAR.  If multiple
    CMASes managing the same plex reside on a single MVS image, the
    need to maintain resource topology cache lists for all MASes
    in the plex in each CMAS's TOP cache data space may cause the
    resource lock block pool to be exhausted.  This may result in
    failures including, but not limited to, failure to complete
    CMAS-to-CMAS connections when new CMASes become active, failure
    of Topology Connect or Join to complete, and failures in methods
    which create new queues or cache lists, because new global lockS
    cannot be registered.
    
    
       The global lock pool, which is allocated from the extended
    private area of the EYUX310 address space when the ESSS is
    initialized, was increased to 262,144 lock elements and 524,288
    Holder/Waiter elements.
    

APAR Information

  • APAR number

    PK47554

  • 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-21

  • Closed date

    2007-07-05

  • Last modified date

    2007-08-03

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    PK47482 UK26834

Modules/Macros

  •    EYUTXEPC EYUUXEEQ EYU9X310
    

Fix information

  • Fixed component name

    CPSM CICS 3.1

  • Fixed component ID

    5655M1501

Applicable component levels

  • R100 PSY UK26834

       UP07/07/06 P F707

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"}},"474":{"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}

Document Information

Modified date:
22 February 2023