PM07112: DFHWB0002 A SEVERE ERROR (CODE X'0509') HAS OCCURRED IN MODULE DFHWBSR.

Obtain the fix for this APAR.

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
   SC34701300
  

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 4 Release 1 Trace
  Entries manual, SC34-7013-00, 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 is sysrouted FROM one or more of the following:

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

  UK56351

Modules/Macros

• DESDHFS  DFHDHFS
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R600 PSY UK56351

     UP10/04/28 P F004

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.