A fix is available
APAR status
Closed as program error.
Error description
The DLA Utility is not reporting errors in specifications for CICSPlex or CICS Region books e.g.: . BOOK TYPE CICSPLEX YO BOOK TYPE CICSREGION NES . Defect 26719.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM V4R1M0 Users * **************************************************************** * PROBLEM DESCRIPTION: Various errors may occur when executing * * program EYU9XDDA to run the CPSM * * Discovery Library Adapter (DLA) for * * CICS: * * * * - When a value other than YES or NO is * * specified on the BOOK TYPE parms for * * CICSPLEX or CICSREGION, no error is * * generated and unpredictable results * * will occur. (26719) * * * * - If the value specified for the LIMIT * * parameter is reached for a resource * * type, processing terminates instead * * of proceeding with the next resource * * type. (26720) * * * * - If the value of the LIMIT parameter * * is numeric and outside of the range * * allowed for the parameter, message * * EYUXD1000I is issued, but the * * <limit> insert is not replaced by * * the invalid LIMIT value. (26722) * * * * - If a non-numeric LIMIT value is * * specified, no error is produced and * * an unpredictable value is used for * * the limit parameter. (26722) * * * * - Executing EYU9XDDA through the * * sample job EYUJXDD0 in SEYUSAMP will * * result in message IEC141I indicating * * error code 013-18 in step FTPSTEP. * * (26737) * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, the EYU9XDDA utility should be rerun * * pointing to the libraries updated by the * * PTF. * **************************************************************** - EYU9XDDA does not validate the inclusion value to be either YES or NO for the BOOK TYPE parms for CICSPLEX or CICSREGION. - When EYU9XDDA hits the LIMIT parm value for a specific resourcetype, the internal limit counter is not reset. As a result all future resource types will incorrectly hit the LIMIT value when processing the first resource for the type. - When message EYUXD1000I is issued by EYU9XDDA, the parm name LIMIT is substituted for the <limit> insert instead of the value of the LIMIT parm. - EYU9XDDA does not validate that the LIMIT parm is numeric. This will result in unpredictable values being used for the LIMIT value. - Sample JCL member EYUJXDD0 specifies an invalid member name for the IDMLFILE in the FTPSTEP.
Problem conclusion
- EYU9XDDA has been updated to validate that the inclusion value is either YES, NO or defaulted to YES for the BOOK TYPE parms for CICSPLEX or CICSREGION. If it is not, message EYUXD1009E will be issued. - EYU9XDDA has been updated to reset the internal limit counter when switching from one resource type to another. - EYU9XDDA has been updated to set EYUXD1000I message <limit> insert to the invalid LIMIT parm value. - EYU9XDDA has been updated to validate that the LIMIT parm is a numeric value. If not, message EYUXD1000I will be issued. - Sample JCL member EYUJXDD0 has been updated to specify the value member name for the IDMLFILE in the FTPSTEP.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PK89120
Reported component name
CICS TS Z/OS V4
Reported component ID
5655S9700
Reported release
60M
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2009-06-17
Closed date
2009-09-09
Last modified date
2009-10-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Modules/Macros
EYUJXDD0 EYUMCXDC EYUMCXDE EYUMCXDK EYU9XDDA
GC34703600 |
Fix information
Fixed component name
CICS TS Z/OS V4
Fixed component ID
5655S9700
Applicable component levels
R60M PSY UK49892
UP09/09/15 P F909
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":"4.1","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":"4.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 October 2009