PQ61160: WHEN UTF-8 BOX IS CHECKED IN INTERNET EXPLORER URIS CONTAINING CHARACTERS SUCH AS AN E-ECUTE ARE NOT INTERPRETED CORRECTLY

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When using Internet Explorer and when the UTF-8 box is
  checked (go to Tools->Internet Options->Advanced Tab,
  "Always send URLs at UTF-8 (requires restart)" is selected),
  a URL containing characters such as e-ecute is not displayed
  correctly but instead receives a "404 Not Found" error from
  HTTP Server.
    1. Internet Explorer interprets the e-ecute in the URL as a
  Unicode entry and maps this character to %C3%A9 (UTF-8
  encoding).
  2.HTTP Server reads %C3%A9 (and everything in the URI) as
  ISO8859-1 and assumes that %C3%A9 are two characters escaped
  in ISO8859-1 instead of the actual one character in UTF-8.
  3. HTTP Server converts %C3%A9 from ISO8859-1 to IBM-1047.
  4. The -vv trace contains the following since the mapping is
  incorrect:
  " IMW0229E The file was not found, even after searching on
  any extensions to the file name."
  and returns the following to the browser as a result:
  " HTTP/1.1 404 Not Found ".
  

Local fix

• Do not select the UTF-8 box in Internet Explorer.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the webserver for OS/390 and    *
  *                 z/OS that use filesystem codepages other     *
  *                 than IBM-1047.                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: The webserver does not translate        *
  *                      escaped UTF-8 characters in URLs.       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Webserver does not translate escaped UTF-8 characters in URLs.
  By default, Microsoft's Internet Explorer web browser encodes
  URLs in UTF-8 format.  An extended ASCII character (that has a
  valid translation to IBM-1047 defined) is encoded differently in
  UTF-8 than standard US-ASCII characters(00-7F).  The webserver
  is not currently equipped to detect and convert UTF-8-encoded
  characters.
  

Problem conclusion

• The code was changed to automatically detect whether the encoded
  character is in UTF-8 or ISO8859-1 when the user configures a
  new directive, DetectUTF8, to ON.  When this directive is set to
  OFF, the webserver performs the current response.
  
  The following COMPID is affected by these changes:
  
  5697D4300 HTTP Server for OS/390 and z/OS Version 5.3
  
  PTFI2
  The code changes are stored in CMVC under defect PQ61160.
  
  Doc Changes:
  PQ61160 changed the following documentation:
  
  In the following document:
  - IBM HTTP Server for OS/390 and z/OS, HTTP Server Planning,
    Installing, and Using, Version 5.3:
  http://www.ibm.com/software/webservers/httpservers/doc53.html
  
  A. Within Appendix B: Configuration Directives: Under "Codepage:
  Specify default codepage environment", add the following:
  
  DetectUTF8 - Detect and unescape UTF-8 encoding in URLs
  
  Use this directive to enable the automatic detection of escaped
  UTF-8 characters in URLs.  When set to OFF, all escaped
  characters will be assumed to be encoded in ISO8859-1.  When set
  to ON, the webserver will attempt to detect whether the
  character is in UTF-8 format and unescape that character to its
  EBCDIC (IBM-1047) equivalent.  If this check fails, then the
  first byte will unconditionally be assumed to be ISO8859-1.  If
  the detected UTF-8 character does not map to an IBM-1047
  character, processing will continue with the escape sequence
  left untouched.
  
  The format of the directive is:
  
  DetectUTF8 ON | OFF
  
  Example
  DetectUTF8 ON
  
  Program default setting
  OFF
  
  Initial configuration file setting
  None
  
  B. In the default configuration file (etc/httpd.conf).
  At the bottom of the file, the following was added:
  
  DetectUTF8 directive:
  
  Use this directive to enable the automatic detection of
  escaped UTF-8 characters in URLs.  When set to OFF, all
  escaped characters will be assumed to be encoded in ISO8859-1.
  When set to ON, the Webserver will attempt to detect whether
  the character is in UTF-8 format and unescape that character
  to its EBCDIC (IBM-1047) equivalent.
  
  Default:  OFF
  Syntax:   DetectUTF8 ON | OFF
  
  Example:
  DetectUTF8 ON
  
  * Cross Reference between External and Internal Names
  

Temporary fix

Comments

APAR Information

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

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

  UQ68319 UQ68320 UQ68321

Modules/Macros

• IMWGSIPC IMWHTSCJ IMWHTSEC IMWJAV   IMWJJAVA
  IMWJPR   IMWLACCS IMWLACSS IMWLALRT IMWLANCR IMWLASOC IMWLASRT
  IMWLATMP IMWLATOM IMWLAUTL IMWLBAG  IMWLBTRE IMWLCHNK IMWLCKCF
  IMWLCNTR IMWLCPCV IMWLCSR  IMWLDAP  IMWLDATA IMWLDESC IMWLDRBR
  IMWLERRR IMWLFILE IMWLFMT  IMWLFPRT IMWLFTP  IMWLFTPD IMWLGOPH
  IMWLHASH IMWLICON IMWLINIT IMWLISOC IMWLLDSR IMWLLIST IMWLMLTI
  IMWLNLS  IMWLOOM  IMWLOS2S IMWLPOOL IMWLPRIO IMWLPRSE IMWLPRTU
  IMWLSCP1 IMWLSEM4 IMWLSNPL IMWLSP2  IMWLSTRG IMWLSTRM IMWLTCP
  IMWLTFPT IMWLTHD  IMWLTP   IMWLTPOL IMWLTRCE IMWLUU   IMWLVINT
  IMWLWILD IMWLWORK IMWLWRTR IMWLWUS  IMWNODPI IMWSACL  IMWSADM
  IMWSAFIL IMWSAPID IMWSAPIP IMWSAPRO IMWSARCV IMWSARGV IMWSASRV
  IMWSAUTH IMWSBOMB IMWSCACF IMWSCACH IMWSCACP IMWSCAGC IMWSCAGL
  IMWSCALO IMWSCAMA IMWSCANE IMWSCAPA IMWSCAQU IMWSCAUR IMWSCAWO
  IMWSCCHI IMWSCGPR IMWSCGUT IMWSCLC  IMWSCNTR IMWSCONF IMWSCONS
  IMWSDAPI IMWSDMDR IMWSDOGC IMWSDSTR IMWSDVAR IMWSENTY IMWSENV
  IMWSFCGI IMWSFNM  IMWSGC   IMWSGLOB IMWSGRP  IMWSHBF  IMWSHEAD
  IMWSHTHP IMWSIFMS IMWSIMGE IMWSIMS  IMWSIUMS IMWSJAPI IMWSJBE
  IMWSJCFG IMWSJTHD IMWSKILL IMWSLEX  IMWSLOAD IMWSLOG  IMWSLOOP
  IMWSLSTT IMWSMETH IMWSNS   IMWSOSMF IMWSPCA  IMWSPCSP IMWSPDB
  IMWSPERF IMWSPEV  IMWSPF   IMWSPICS IMWSPL   IMWSPRD  IMWSPROC
  IMWSPW   IMWSQUEU IMWSREQ  IMWSRLDB IMWSRNGE IMWSRSP  IMWSRSRT
  IMWSRTRC IMWSRTRV IMWSSCRP IMWSSECP IMWSSGNL IMWSSIO  IMWSSIPC
  IMWSSNMP IMWSSRC  IMWSSRER IMWSSRVR IMWSSSI  IMWSSTAT IMWSSTBD
  IMWSSTHD IMWSSUTL IMWSTASH IMWSTEC  IMWSTIMR IMWSTIMU IMWSUID
  IMWSUIDU IMWSURDB IMWSUSRI IMWYSCNT IMWYSPWD
  

Fix information

• Fixed component name

  DGW/WAS OS/390

• Fixed component ID

  5697D4300

Applicable component levels

• R53B PSY UQ68320

     UP02/07/26 P F207

• R530 PSY UQ68319

     UP02/07/26 P F207

• R531 PSY UQ68321

     UP02/07/29 P F207

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.