A fix is available
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 number
PK48834
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
50M
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2007-07-12
Closed date
2007-07-23
Last modified date
2007-08-03
APAR is sysrouted FROM one or more of the following:
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.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
03 August 2007