PI68111: 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 V5R3M0 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.
  
  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.
  

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.
  

Temporary fix

Comments

APAR Information

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

  PI65761

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

  UI40925

Modules/Macros

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

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R00M PSY UI40925

     UP16/09/30 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.