PH48348: EYUTS0062E TOPOLOGY RESMAP HARDENING ERROR POSSIBLE IN CMAS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Your CICSPlex environment is running normally, then suddenly you
  experience the following error message from one of your CPSM
  CMASes
  .
  EYUTS0062E applid Topology ResMap Hardening long-running task
  Error.
  .
  In an SVC dump of the CMAS, you may find the following exception
  trace entries if you format it IN IPCS using  VERBX EYU9D###
  'TRC=A,JOB=cmasname'
  .
  Task  Mtd  Prev Tran Obj Level Pt-ID  Debug   UOW  CMAS/Usr Envr
  
  
  12345 XCRS TSMH TSMH CHE Excp     66 ADDREC   CPSM cmasname
  CMAS
  
  12345 TSMH XLOP TSMH TOP Excp      4 TSMHXCRS CPSM cmasname
  CMAS
  .
  The expanded trace entry for the ADDREC entry may show the
  following:
  .
  Task:12345      GMT:hh:mm:ss.ttttt  Date: mm/dd/yy
   Local-TOD:hh:mm:ss.ttttt   UOW:(CPSM)
  Task-Start:hh:mm:ss.ttttt
      Method:XCRS        Prior:TSMH       Debug:ADDREC
  Point-Id:66
   Major-Obj:CHE         Envrn:CMAS        Type:EXCEPTION
  Tran-Id:TSMH
   CICS-Task:TOP        System:system      CMAS:cmasname
  .      Keyword        Data Queue Req Data     Data
       Value          Type Dir   Opt Address  Value
  In: *FUNCTION       FUN         .  003E36E5 STRCLSTR
      *CONTEXT        CHR         .  003E36E9 plexname
      *DEBUG          CHR         .  003E36F1 TSMHXCRS
      *LIST_ID        LID         .  003E36F9 A=000029C0
  N=00425F20
      *MAJOR_NAME     CHR         .  003E3701 resname1
      *MAJOR_ID       RES         .  003E3709 0AF6
      *MINOR_ID       RES         .  003E370B 0013
      *SIGNATURE      CHR         .  003E370D sigs..¢m.. .
      *BASE_SIGNATURE CHR         .  003E3719 sigs....a~.
  .
  Out: *RESPONSE       RSP         .  003E36E7 EXCEPTION
      *REASON         RSN         .  003E36E8 METHOD_FAILED
  .
  The trace pointid 66 corresponds to DCEQ_EXCP_ARECTPID in CPSM
  code.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM Users.                       *
  ****************************************************************
  * PROBLEM DESCRIPTION: CMAS region shows error message         *
  *                      EYUTS0062E <applid> Topology ResMap     *
  *                      Hardening long-running task error.      *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF which resolves        *
  *                 this APAR, all CMAS regions should be        *
  *                 restarted. The restarts may occur in any     *
  *                 order.                                       *
  ****************************************************************
  The topology services resource map hardening long running task,
  periodically hardens topology resource maps to the EYUDREP
  data set for each region in the CICSplex. These maps are stored
  across records in the data repository, with a key combining the
  resource type, region and a sequence number.
  If the data repository contains existing records, these are
  updated. However if there is a gap in the sequence numbers for
  a record type, XCRS which handles the storing records to the
  data repository incorrectly calls the add function,XDAD, rather
  than update, XDUP for the later existing records.
  This results in XDAD failing with status
  XDAD_RECORD_EXISTS, as a record with the same key already
  exists. This results in a exception, causing the LRT error
  reported by message EYUTS0062E.
  

Problem conclusion

• Logic in XCRS has been corrected, to allow the store to data
  repository to handle the case where the sequence numbers, used
  for the record keys are not sequential.
  

Temporary fix

Comments

APAR Information

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

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

  PH48863 UI82807 UI82808

Modules/Macros

• EYU0XCRS
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R20M PSY UI82808

     UP22/10/25 P F210

• R30M PSY UI82807

     UP22/10/25 P F210

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.