PM84642: COVA TASK RECOVERY FAILURE RESULTS IN EYUXS1016E MESSAGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• During a disruptive test (loss of the Logger Address space),
  the CMAS was terminated which resulted in the connected WUI LRT
  termination as requested by the CMAS.  Upon MAS restart, task
  recovery was started for the COVA task and an error occurred
  during recovery resulting in the following messages:
  .
  EYUXS1014I xxxxxxxx Task recovery starting for task ( 1114 ),
    transaction ( COVA )
  EYUXS1019W xxxxxxxx API resources allocated for task ( 1114 )
    may be orphaned
  EYUXS1016E xxxxxxxx Task recovery in error for task ( 1114 ),
    flags ( NYNNYNNNS )
  .
  and a dump out of XSTR.  The recovery flags indicate that the
  global and local locks were recovered but the OPB was not
  unchained during recovery.
  
  
  
  
  
  
  
  
  Additional Symptom(s) Search Keyword(s): KIXREVGJT
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V3R2M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: When a CPSM API program running in a    *
  *                      MAS terminates after the MAS has        *
  *                      disconnected from the CMAS to which it  *
  *                      was connected, CPSM API resources       *
  *                      allocated for the program in the MAS    *
  *                      may be orphaned.  Note that the         *
  *                      disconnection can be due to the CMAS    *
  *                      terminating, the MAS terminating, or    *
  *                      the MAS agent code terminating through  *
  *                      the MAS resource table STOP action or   *
  *                      the COSH transaction.                   *
  *                                                              *
  *                      When the problem occurs, message        *
  *                      EYUXS1019W will be written to the MAS's *
  *                      joblog and to the console.  The text of *
  *                      the message will be similar to the      *
  *                      following:                              *
  *                                                              *
  *                        EYUXS1019W API resources allocated    *
  *                                   for task (<taskid>) may be *
  *                                   orphaned                   *
  *                                                              *
  *                      Additionally, some combination of the   *
  *                      following messages will also be written *
  *                      to the MAS's joblog and to the console: *
  *                                                              *
  *                        EYUXS0910I EYU9XSTR Dump,<masjobn>,   *
  *                                   <masname>,<lpar>,LMAS,     *
  *                                   <tranid>,<tasknum>,TRCV,   *
  *                                   EYU9XSTR,<date>,<time>     *
  *                                                              *
  *                        EYUXS1014I Task recovery starting for *
  *                                   task (<taskid>),           *
  *                                   transaction (<tranid>)     *
  *                                                              *
  *                        EYUXS1015I Task recovery complete for *
  *                                   task (<taskid>), flags (   *
  *                                   ccccccccc )                *
  *                                                              *
  *                        EYUXS1016E Task recovery in error for *
  *                                   task (<taskid>), flags (   *
  *                                   ccccccccc )                *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all MASes must be restarted.  Note     *
  *                 that the restarts do not need to occur at    *
  *                 the same time.                               *
  ****************************************************************
  When a CPSM API program runnning in a MAS terminates without
  issuing a DISCONNECT or TERMINATE command, program EYU9XLAP,
  running as a CICS end of task TRUE, is called to perform clean
  up of all CPSM resources for the program, including CPSM API
  related resources.
  
  When the MAS disconnects from the CMAS to which is was connected
  the EYU9XLAP TRUE is disabled.
  
  After the EYU9XLAP TRUE is disabled, if an API program
  terminates, program EYU9XSTR is called as a CICS end of task
  TRUE.  EYU9XSTR issues messages as described above, and performs
  clean up processing for some CPSM resources, but not for CPSM
  API resources.  This results in those resources being orphaned
  until the MAS is restarted.
  

Problem conclusion

• Copybook EYUBXLAO, which maps the CPSM active task array
  element, has been updated to include a new flag to indicate that
  a task has CPSM API resources allocated.
  
  EYU9XLAP has been updated to turn the new EYUBXLAO flag off and
  on as appropriate.
  
  EYU9XSTR has been updated to check the new EYUBXLAO flag when
  called as an end of task TRUE.  If the flag is on, it will
  release the CPSM API resources allocated for the task and bypass
  issuing any error recovery messages.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PM84027

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

  UK93978

Modules/Macros

•    EYU9XLAP EYU9XSTR
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R50M PSY UK93978

     UP13/05/03 P F305

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.