PI41715: CICS MAY NOT UNESCAPE CHARACTERS IN ZFS FILE NAME. RESULTS IN HTTP 404 AND/OR DFHWB0759

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You have a TCPIPSERVICE and a URIMAP defined with a generic
  path and Hfsfile that ends in an asterisk '*' character.
  .
  When DFHWBUR gets called to locate the URIMAP it returns the
  complete HFS filename.  For generic URIMAPs this is achieved by
  replacing the asterisk with the remainder of the incoming uri.
  However, there is no attempt to unescape that data.  This
  leaves the escape sequences, such as %20 in the data and causes
  the file to not be found.
  .
  In a trace, you may see exception entries like:
  .
  DH 0E05 DHFS  *EXC* NOT_FOUND  INQUIRE_HFS_FILE
  .
  The CWBO TD queue (should go to MSGUSR) will have a message
  similar to the following:
  .
  DFHWB0759 date/time/applid CWXN An attempt to access static
          data <file name here with escaped data>  has failed
  .
  In the browser, an HTTP 404 NOT FOUND response may be seen.
  .                               Additional Symptom(s) Search
  Keyword(s): KIXREVGJT
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Message DFHWB0759 is issued when an     *
  *                      http request is for a filename          *
  *                      containing spaces.                      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  CICS is acting as an HTTP server and a URIMAP is defined with
  the HFSFILE attribute specifying a generic file name.
  An incoming HTTP request arrives for a filename containing
  spaces. The spaces in the request have been escaped and appear
  as %20.
  DFHWBUR is invoked to locate the URIMAP. It matches the
  installed generic definition. DFHWBUR returns the complete
  filename and path but the name has not been unescaped and so
  still contains the '%20's.
  CICS attempts to read the file using this incorrect filename
  resulting in msgDFHWB0759 being issued and an HTTP 404
  'file not found' being returned to the browser.
  

Problem conclusion

• DFHWBUR has been changed to unescape
  spaces in http requests for static HFSFILEs.
  

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:

  UI29660

Modules/Macros

• DFHWBUR
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R900 PSY UI29660

     UP15/07/31 P F507

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.