A fix is available
APAR status
Closed as program error.
Error description
Message DFHWB0002 A SEVERE ERROR (CODE X'0509') IN MODULE DFHWBSR and an SVC DUMP occur. Review of Trace Entry ....... DH 0E11 DHFS *EXC* - STAT_FAILED - FUNCTION(INQUIRE_HFS_FILE). In the last byte of the fullword at +x'24' we see the HFS error code x'00000087' which translates to a "ENOTDIR" error. error. Explanation: A directory component of the working directory's pathname is not really a directory. Review of DFHDHFS logic shows that if an error occurs it checks for an EACCES response (NOTAUTH) x'6F' or an ENOENT response (NOT_FOUND) x'81' error. For any other errors the logic falls through as a generic STAT error. CICS will be modified so this type of failure will not result in a dump. Additional Symptom(s) Search Keywords: KIXREVSWM
Local fix
Correct the "PATH" and/or the "HFS FILE NAME"
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users. * **************************************************************** * PROBLEM DESCRIPTION: Message DFHWB0002 is issued with * * a system dump when CICS receives * * an ENOTDIR return code trying to * * access an HFS file pointed to by * * an HFS file path containing an * * invalid directory. * **************************************************************** * RECOMMENDATION: * **************************************************************** The customer sends in a request to CICS, for example, http://hostname:port/dir1/dir2/file.wsdl/½top The URIMAP definition contains: PATH: /dir1/dir2/wildcard HFSFILE: /usr/MYDIR/dir1/dir003/dir2/wildcard (where wildcard is *). When CICS receives this request, it appends file.wsdl/½top to the end of the HFSFILE value in the URIMAP definition resulting in: /usr/MYDIR/dir1/dir003/dir2/file.wsdl/½top CICS then tries to access this file but fails with an ENOTDIR return code because file.wsdl is not a valid directory. DFHDHFS inquire_hfs_file does not contain code to handle the ENOTDIR return code Consequently, message DFHWB0002 A SEVERE ERROR (CODE X'0509')HAS OCCURRED IN MODULE DFHWBSR is issued with a system dump. Additional keywords: msgDFHWB0002 msgDFHWB0761 DFHWB0761 SC34682802
Problem conclusion
DFHDHFS has been changed so that message DFHWB0002 will not be issued and a system dump will not be taken when CICS receives an ENOTDIR error trying to access a file pointed to by an HFS file path containing an invalid directory. Instead message DFHWB0759 and exception trace entry DH 0E0A Not directory will be issued. The CICS Transaction Server for z/OS Version 3 Release 2 Trace Entries manual, SC34-6828-02, will be updated so that the DH 0E0A trace entry will read: DH 0E0A DFHDHFS Exc Not directory 1 DFHDHFS parameter list
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PK99454
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
500
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2009-10-23
Closed date
2010-02-01
Last modified date
2010-03-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK54033
Modules/Macros
DESDHFS DFHDHFS
SC34682802 |
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R500 PSY UK54033
UP10/02/04 P F002
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:
01 March 2010