PK48834: EYUVC1220E CICSPLEX SM API COMMAND (GET) FAILED. (FAILED,EXCEPTI ON).

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are using the WUI to view the TERMNL resource and provide
  fiter <+++ for the Terminal ID.
  You are returned the following CICSPlex SM API Error:
  EYUVC1220E  CICSPlex SM API command (GET) failed. (Failed,
  Exception).
  
  This error only occurs in the WUI with Default warning count
  in effect. ( EYUWUI parm DEFAULTWARNCNT > 0)
  
  Additional Symptom(s) and Keyword(s): In the connected CMAS
  aux trace you will find trace entries:
  MOFS XDP1 XDNR DAT EXCP 3 LENGERR  EUI CMAS
  XDP1 XDNR XDNR DAT EXCP 1 TSCVFAIL EUI CMAS
  .
  In the WUI aux trace you will find:
  VISE VGAR COVA SIM EXCP.      1 execFail CPSM XCM8     LMAS
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V3R2M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION:    You are using the WUI, with a non-   *
  *                      zero Warning Count, to view the TERMNL  *
  *                      resource.  You provide a filter <+++    *
  *                      for the Terminal ID, and the following  *
  *                      CICSPlex SM WUI Error is returned:      *
  *                      .                                       *
  *                         EYUVC1220E  CICSPlex SM API          *
  *                              command (GET) failed.           *
  *                              (Failed,Exception).             *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes must be recycled to pick    *
  *                 up the new code.  Note that the restarts     *
  *                 do not need to be done at the same time.     *
  ****************************************************************
     When building a filter string from selection parameters, the
  WUI encloses any value strings containing special characters in
  single quotes.  When a non-zero Warning Count is specified,
  EYU0XDP1 (XDP1 - API GET Command Processor) is then called with
  the QUERY parameter to return the number of resources mapped by
  Topology.  XDP1 calls EYU0MOFS (MOFS - MOS Field Services) to
  convert the key attribute value to internal form, and passes the
  converted value to module EYU0TMRI (TMRI - Topology Resource
  Inquiry) to return the number of resources.
     However MOFS and TMRI do not support quoted value strings.
  The length of the quoted string '<+++' is six characters, but
  the TERMID attribute is four characters long.  Thus MOFS returns
  RESPONSE=EXCEPTION, REASON=LENGTH_ERROR.  If a shorter filter
  (e.g. '*') is passed, MOFS will convert it correctly, but TMRI
  will report that no resources were found that match the provided
  value, so no warning panel will be presented even if the true
  number of resources exceeds the specified warning count.
  

Problem conclusion

•    EYU0XDP1 was modified to remove quotes before passing values
  to MOFS.  The unquoted value will be converted to internal form
  and passed to TMRI, which will return the count of resources
  mapped by Topology.  This will not affect filter compilation,
  which will still process the entire criteria string including
  any quotes.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PK48855

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

  UK27327

Modules/Macros

•    EYU0XDP1
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R50M PSY UK27327

     UP07/07/26 P F707

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.