PI64425: APACHE HTTP SERVER NOT HANDLING GERMAN AND OTHER CODEPAGES FOR TRANSLATION OF ORDERS FROM CLIENT CODE.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• German customer with migrated items from the older VI product
  into CM, not able to process them when using Apache HTTP server.
  Getting a ICM023E and a OAM 24040A04 because special characters
  in the itemid (external object name) is mistranslated to an
  incorrect ebcdic value.   It seems APACHE does not have any
  ability to handle translation on any other code page except its
  default of 1047.  If customer used codepages like 273 for German
  when items were first stored, then the order statement received
  by the RM from the client and http server will have invalid
  special character hex values because APACHE has no code page
  273 translation ability.
  

Local fix

• None available
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IBM Content Manager for z/OS        *
  *                 resource manager V8.5, running under the     *
  *                 IBM HTTP Server V8.5.5 or higher powered     *
  *                 by Apache, AND that use a codepage in which  *
  *                 the equivalen to the symbols $, @, or #      *
  *                 have a different value than in US EBCDIC     *
  *                 page 1047, AND that access migrated objects  *
  *                 with those symbols in their names.           *
  ****************************************************************
  * PROBLEM DESCRIPTION: Users are unable to access migrated     *
  *                      objects with symbols $, @, or #         *
  *                      in their names when running the         *
  *                      resource manager under an IBM HTTP      *
  *                      Server powered by Apache with a         *
  *                      codepage in which those symbols are     *
  *                      different to the US EBCDIC 1047         *
  *                      codepage.                               *
  ****************************************************************
  * RECOMMENDATION: APPLY CORRECTIVE SERVICE                     *
  ****************************************************************
  IBM HTTP Server powered by Apache overrides the codepage to US
  EBCDIC 1047.
  

Problem conclusion

• The resource manager code is modified to accept an optional 3rd
  parameter from the Apache configuration file (e.g. httpd.conf)
  in which the locale can be specified. Serviceability logging is
  also added to identify the Codeset and Locale upon the start of
  the resource manager. The new 3rd parameter is optional, and no
  changes are necessary for installations not needing it.
  
  Example httpd.conf configuration with the new third parameter:
    ICMResourceManager DB2 ICMPLAN De_DE.IBM-273
  Example httpd.conf configuration with only 2 parameters:
    ICMResourceManager DB2 ICMPLAN
  
  Example log output upon server start with locale specified:
    Codeset, Locale: <IBM-273>, </locale/De_DE.IBM-273.xplink>
  Example log output upon server start with default locale:
    Codeset, Locale: <IBM-1047>, <C>
  

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:

Modules/Macros

•    ICMMASCT ICMMASXT ICMMATCT ICMMBSCT ICMMBTCT
  ICMMOSCT ICMMOSXT ICMMOTCT
  

Fix information

• Fixed component name

  CM390 LIB SER R

• Fixed component ID

  5697H6000

Applicable component levels

• R851 PSY UI42940

     UP16/12/12 P F612

• R854 PSY UI42941

     UP16/12/12 P F612

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.