PI65761: COVA ABENDAFCT LOOPING in CPSM WUI AFTER RECYCLING RLS SERVER

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are experiencing COVA abendAFCT looping in your CPSM WUI
  Server region issue after recycling the RLS server.
  .
  The following messages were repeatedly issued, flooding the
  console, and the region was eventually canceled.
  .
   EYUVS0994I applid  VKEC DUMP masname  WUI sysid  LMAS COVA
                       0001710 AFCT ????????
  +EYUVS0989I DUMP SUPPRESSED.
  +EYUVS0990I ABEND RECOVERY COMPLETED SUCCESSFULLY.
  +EYUVS0999S WUI FAILED: ABEND TRAPPED IN EYU9VKEC
  +EYUVS0996S ABEND AFCT SYSTEM CODE N/A  AT OFFSET   ????
              IN MODULE ????????
  +EYUVS0998I   TSK=0001710C VKTB=20CE3258 VKAB=1FBF9040
  +EYUVS0998I ABEND CALL STACK FOLLOWS
  +EYUVS0998I EYU0VKEC CSECT=20ACDD70 DATD=20CE4670 RETN=A0ACE250
  +EYUVS0998I EYU0VGAI CSECT=209F0950 DATD=20CE4968 RETN=A09F27E2
  +EYUVS0998I EYU0VGEL CSECT=209FAC00 DATD=20CE4E58 RETN=A09FBA88
  +EYUVS0998I EYU0VGEM CSECT=209FC460 DATD=20CE50D8 RETN=A09FCA34
  +EYUVS0998I EYU0VGAR CSECT=209F41C8 DATD=20CE5248 RETN=A09F5324
  +EYUVS0998I EYU0VISL CSECT=20AA45E0 DATD=20CE6010 RETN=A0AA7D0E
  +EYUVS0998I EYU0VISX CSECT=20AB2368 DATD=20CE65D8 RETN=A0AB3E96
  +EYUVS0998I EYU0VVCA CSECT=20B66888 DATD=20CE6F20 RETN=A0B68214
  +EYUVS0998I EYU0VVRF CSECT=20BA7910 DATD=20CE71E0 RETN=A0BA856E
  +EYUVS0998I END OF ABEND CALL STACK
  .
  The trace shows the following entry prior to the abendAFCT,
   QR    AP 04E1 FCFR  EXIT  READ_INTO/EXCEPTION
                             REASON(PREVIOUS_RLS_FAILURE)
                             MAXIMUM_RECORD_LENGTH(0)
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V5R2M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: When a CPSM Web User Interface data     *
  *                      repository (EYUWREP) dataset is         *
  *                      defined for VSAM RLS management, and    *
  *                      the RLS Server is restarted whilst a    *
  *                      WUI User session is in progress, then   *
  *                      repeated CICS AFCT dumps are issued     *
  *                      until the user signs off from the       *
  *                      current session and reconnects in a     *
  *                      new session.                            *
  *                                                              *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all WUI regions must be recycled       *
  *                 to pick up the new code.  Note that regions  *
  *                 do not need to be brought down and restarted *
  *                 at the same time.                            *
  *                                                              *
  ****************************************************************
  When a user logs on to the WUI, a long running CICS
  transaction ("COVA") is started, which endures until the user
  signs off. The CPSM WUI must access its EYUWREP dataset
  whenever a user links to a new WUI Viewset. Thus, many CICS
  file control accesses to the EYUWREP will originate from the
  same COVA task, as the user navigates around the various WUI
  panels.
  
  If the EYUWREP dataset is defined for VSAM RLS management,
  and the RLS Server closes down during a WUI user's session,
  then the user will find any attempts to navigate away from the
  current Viewset will be rejected with message:
  
  "EYUVC1210E Requested View-set EYUSTARTxxxxxxx not available."
  
  In addition to this on-screen message, the CICS region will take
  an AFCR transaction dump, which the WUI code will capture and
  report on the EYULOG dataset for the CICS region. Those abend
  messages should clearly identify the failed RLS Server as the
  failure reason, and the System Programmer/Operator is expected
  to restart the VSAM RLS server as quickly as possible.
  
  Once the RLS Server is restarted, subsequent user requests for
  alternate WUI Viewsets will continue to fail, with the CICS job
  log reporting CICS AFCT abends. These abends cannot be
  circumvented until the current WUI User session is terminated
  and restarted.
  

Problem conclusion

• The WUI EYUWREP access code employs standard EXEC CICS READ
  commands to retrieve Viewset configuration data from the EYUWREP
  dataset. The CICS API will return CICS RESP and RESP2 values
  for most types of failures that might originate from a File
  Control READ request - except for problems relating to access
  of an RLS managed file. When a file is RLS managed, and the RLS
  server is withdrawn whilst a region is active, then accesses to
  that file will cause the issuing task to be abended (AFCR or
  AFCS), rather than returning control to the issuer of the
  EXEC CICS READ (with a RESP/RESP2 value). Further to that, if
  the RLS Server is restarted then any tasks attempting to access
  the file (that were active prior to the RLS Server withdrawal),
  will now be abended with CICS Abend code AFCT.
  
  The EXEC CICS READ calls that fall victim to these abends have
  now been wrapped with their own private CICS abend handling
  calls, to allow these RLS failures to be managed in the same
  way as a normal CICS API rejection. When one of these RLS
  abends are captured, then a new message is issued to the CICS
  EYULOG dataset to notify of this type of failure:
  
  EYUVS1103W -applid- Unable to access RLS managed EYUWREP -
                      Abend Code (AFCx).
  
  Furthermore, if the reported Abend Code is "AFCR", then it is
  reporting that a previous RLS failure has been recovered, and
  that the current CICS Unit-of-work (UOW) should be ended before
  any further file accesses are attempted to the EYUWREP file.
  Therefore, the WUI recovery action (after issuing the new
  message) is to issue a CICS SYNCPOINT to complete the current
  UOW and then attempt to read the new Viewset record again. From
  the user's perspective this should result in a seamless
  transition from one WUI view to another. In that circumstance
  the new EYULOG message serves only as a notification that a
  previous RLS issue arose, and has now been rectified.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  PI68111 UI40911

Modules/Macros

• EYUEVVRM EYUKVVRM EYUSVVRM EYU0VVRB EYU0VVRC EYU0VVRD EYU0VVRE
  EYU0VVRF EYU0VVRP EYU0VVRS EYU0VVRT
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R90M PSY UI40911

     UP16/09/23 P F609

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.