IBM Support

PM58486: EYUVC1231E WHEN UPDATING DB2EDEF

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • The update of CPSM BAS resource DB2EDEF fails with the following
    message: 'EYUVC1231E 'Update' (Update) request failed. Request
    complete for 0 records. (Failed, Exception)'.
    This orrurs under the following circumstances:
    In the resource DB2EDEF specifying a generic value ending
    in * for the Transaction ID, and the way our cache list
    search processing treats the asterisk as an ending wildcard
    and ignores all following search criteria, and that the
    DB2EDEF is associated with more than one RASGNDEF.
    

Local fix

  • *
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users                 *
    ****************************************************************
    * PROBLEM DESCRIPTION: Various errors may occur when           *
    *                      processing a BAS DB2EDEF that is        *
    *                      associated with a resource group        *
    *                      (RESGROUP) that will be installed       *
    *                      through a resource description          *
    *                      (RESDESC) or resource assignment        *
    *                      (RASGNDEF), if the DB2EDEF specifies a  *
    *                      generic Transaction ID                  *
    *                      (DB2EDEF_TRANSID) that ends in an "*".  *
    *                                                              *
    *                      Errors that may occur include:          *
    *                                                              *
    *                      -  If the DB2EDEF is added to the       *
    *                         RESGROUP, or removed from the        *
    *                         RESGROUP, or updated while           *
    *                         associated with the RESGROUP, then   *
    *                         transactions associated with other   *
    *                         DB2EDEFs (DB2TRN resources) may not  *
    *                         be installed.                        *
    *                                                              *
    *                      -  If the DB2EDEF is updated and it is  *
    *                         associated with multiple RESGROUPs,  *
    *                         RESDESCs and/or RASGNDEFs, then the  *
    *                         update may fail with a response of   *
    *                         "Exception" and a reason of "Method  *
    *                         failed".                             *
    *                                                              *
    *                         If this failure occurs, then the     *
    *                         auxtrace of the maintenance point    *
    *                         (MP) CMAS for the CICSplex the       *
    *                         DB2EDEF is associated with will      *
    *                         contain exception trace records      *
    *                         similar to the following:            *
    *                                                              *
    *                          Method  Caller  TPID   Debug text   *
    *                          ------  ------  ----   ----------   *
    *                          XCL2    XCLR     108   DUPE_ELE     *
    *                          XCLR    BMRV     107   REMSORTF     *
    *                          BMRV    BMRA       3   BMRVXCLR     *
    *                          BMRA    BMCP       7   BMRABMRV     *
    *                          BMCP    BMCU       5   BMCPBMRA     *
    *                          BMCU    XDCR       4   BMCUBMCP     *
    *                          XDCR    XDUP      41   DRCRXCP      *
    *                          BACU    XLSD      12   BACUBMCU     *
    *                                                              *
    *                         Additionally, the MP CMAS may also   *
    *                         request a dump.  The title of the    *
    *                         dump will be similar to the          *
    *                         following:                           *
    *                                                              *
    *                          EYU0XZPT Dump,<jobname>,<cmasname>, *
    *                          <lpar>,CMAS,<tranid>,<tasknum>,     *
    *                          TRAC,EYU0BMRA,<mm/dd/yy>,<hh:mm:ss> *
    ****************************************************************
    * RECOMMENDATION: After applying the PTF that resolves this    *
    *                 APAR, all CMASes must be restarted.          *
    *                                                              *
    *                 All CMASes do not need to be restarted at    *
    *                 the same time.  However, if a DB2EDEF is     *
    *                 updated after the maintenance point (MP)     *
    *                 CMAS has been recycled with the updated code *
    *                 but before all non-MP CMASes in the network  *
    *                 have been recycled with the updated code,    *
    *                 then the update of the DB2EDEF may be        *
    *                 successful in the MP CMAS and in the non-MP  *
    *                 CMASes that have been recycled, but be       *
    *                 unsuccessful in the non-MP CMASes that have  *
    *                 not been recycled.  To avoid this situation, *
    *                 it is recommended that the MP CMAS be        *
    *                 restarted with the updated code after all    *
    *                 non-MP CMASes are restarted with the updated *
    *                 code.  If there are more than one MP CMAS,   *
    *                 then those MP CMASes should be restarted at  *
    *                 the same time.                               *
    *                                                              *
    *                 If it is not possible to delay restarting    *
    *                 the MP CMAS with the updated code until      *
    *                 after all non-MP CMASes are restarted with   *
    *                 the updated code, then it is recommended     *
    *                 that updates, including removal from the     *
    *                 data repository or removal from a resource   *
    *                 group, not be performed for a DB2EDEF that   *
    *                 specifies a generic Transaction ID           *
    *                 (DB2EDEF_TRANSID) that ends in an "*", until *
    *                 all CMASes that manage the CICSplex          *
    *                 associated with the DB2EDEF have been        *
    *                 restarted with the updated code.             *
    ****************************************************************
    When a DB2EDEF contains a TRANSID, then an internal DB2TDEF is
    built for the TRANSID.  This internal transaction is not added
    to the data repository (EYUDREP), but when the DB2EDEF is
    associated with a RESGROUP that will be installed through a
    RESDESC or RASGNDEF, the DB2TDEF is added to the BAS install
    list, and is visible through the RDSCPROC and SYSRES resource
    tables.
    
    The name of the transaction id in the internal DB2TDEF
    (DB2TDEF_NAME) is "DFH" followed by the TRANSID specified in the
    DB2EDEF.  Since the DB2EDEF_TRANSID can be generic, it can end
    in an "*", so the internal DB2TDEF can specify a DB2TDEF_NAME
    that ends in an "*".  For example, if the DB2EDEF_TRANSID is
    "AB*", then the DB2TDEF_NAME for the internal definition will be
    "DFHAB*".
    
    When the DB2EDEF is added to or removed from a RESGROUP, or
    updated while associated with a RESGROUP, and that RESGROUP will
    be installed through a RESDESC or RASGNDEF, then the BAS install
    list is searched for all previous instances of the internal
    DB2TDEF, using a key that consists of the DB2TDEF_NAME and the
    names of the RESDESC, RASGNDEF and DB2EDEF, in that order.
    Those instances are then removed from the BAS install list, and
    in the case of ADD or UPDATE, readded after the DB2EDEF is
    successfully processed.
    
    If the internal DB2TDEF ends in "*", then the BAS list search
    and removal process will select records based only on the
    DB2TDEF_NAME value, and will ignore the names of the RESDESC,
    RASGNDEF and DB2EDEF.  This can cause unrelated internal
    DB2TDEFs to be removed from the BAS install list, which will
    result in these records not being installed properly, or in the
    case of an UPDATE, an exception during the remove process.
    

Problem conclusion

  • Since each internal DB2TDEF is unique based upon the values of
    its RESDESC/RASGNDEF/DB2EDEF combination, method EYU0BMCP
    (BMCP), which builds the BAS install list search and remove key
    for internal DB2TDEF elements, has been updated to specify a
    generic DB2TDEF_NAME value of "DFH????".  This will result in
    the search and remove process not ignoring the names of the
    RESDESC, RASGNDEF and DB2EDEF when processing the BAS install
    list.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM58486

  • 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

    2012-02-20

  • Closed date

    2012-03-22

  • Last modified date

    2012-04-03

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

    PM58321

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

    UK77264

Modules/Macros

  •    EYU0BMCP
    

Fix information

  • Fixed component name

    CPSM CICS 3.1

  • Fixed component ID

    5655M1501

Applicable component levels

  • R100 PSY UK77264

       UP12/03/23 P F203

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

Document Information

Modified date:
22 February 2023