IBM Support

IV01441: JDKCONV: UTILITY TO SUPPORT LOCALES WHICH ARE NON-COMPATIBLE WITH DEFAULT LOCALE (IBM-1047) IN ZOS PLATFORM

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • How do I run my JVM under a different codepage ?
    Java for z/OS is shipped in only one version for EN_US. If you
    wish to run it under a different
    locale your system programmer needs to convert all the text
    files in the JDK installation from IBM-1047 to your code page.
    Otherwise, you will get error with java -version itself.
    
    Error Message:
    java -version
    Warning: no leading - on line 1 of
    ツ/u/enasser/Build/J6.0_64/lib/s390x/jvm.cfg'
    Warning: unknown VM type on line 1 of
    ツ/u/enasser/Build/J6.0_64/lib/s390x/jvm.cfg'
    Warning: no leading - on line 2 of
    ツ/u/enasser/Build/J6.0_64/lib/s390x/jvm.cfg'
    Warning: unknown VM type on line 2 of
    ツ/u/enasser/Build/J6.0_64/lib/s390x/jvm.cfg'
    Warning: no leading - on line 3 of
    ツ/u/enasser/Build/J6.0_64/lib/s390x/jvm.cfg'
    Warning: unknown VM type on line 3 of
    ツ/u/enasser/Build/J6.0_64/lib/s390x/jvm.cfg'
    Warning: no leading - on line 4 of
    ツ/u/enasser/Build/J6.0_64/lib/s390x/jvm.cfg'
    Warning: missing VM type on line 4 of
    ツ/u/enasser/Build/J6.0_64/lib/s390x/jvm.cfg'
    Warning: no leading - on line 5 of
    ツ/u/enasser/Build/J6.0_64/lib/s390x/jvm.cfg'
    Warning: unknown VM type on line 5 of
    ツ/u/enasser/Build/J6.0_64/lib/s390x/jvm.cfg'
    Warning: no leading - on line 6 of
    ツ/u/enasser/Build/J6.0_64/lib/s390x/jvm.cfg'
    
    First find out what locale you are using by checking your
    environment variables such as LANG or LC_ALL. If it is not "C"
    or "EN_US" then this might be your problem.
    

Local fix

  • Use iconv to convert the complaining file to corresponding local
    encoding.
    
    For example:
    cp -p tzmappings tzmappings.backup
    iconv -f IBM-1047 -t IBM-277 tzmappings.backup > tzmappings
    chmod 755 tzmappings
    

Problem summary

  • The text files in zOS SDK are shipped with default EBCDIC code
    page IBM-1047. When you set a locale encoding which are
    incompatible with default encoding (for example: IBM-277,
    IBM-278, etc), it can result in the error. To avoid this problem
    you should convert all text files in SDK to locale encoding.
    

Problem conclusion

  • This function is a available in:
    6.0.0 SR9
    
    Your JDK installation can be converted to a different code page
    by using the script named jdkconv and it uses a program named
    cpmod.  Assuming you haveobtained copies of jdkconv and cpmod,
    here is how to run them.
    
    1.  We STRONGLY RECOMMEND you make a copy of your JDK
    installation directory first or be prepared to reinstall if the
    script goes wrong.  The script overwrites files in the JDK
    directory.
    
    2.  jdkconv is shipped in code page IBM-1047.  You might need to
        convert it to your code page before you can run it:
          cp -p jdkconv jdkconv.backup
          iconv -f IBM-1047 -t <CODEPAGE> jdkconv.backup >jdkconv
          chmod 755 jdkconv
        In this command replace CODEPAGE with your code page.
    
    3.  Ensure that the directory containing jdkconv and cpmod is in
        your PATH setting.
    
    4.  Run jdkconv by typing jdkconv <CODEPAGE> <JAVATREE>
         where CODEPAGE is your code page and JAVATREE is the
         directory in
         which JDK is installed eg /usr/lpp/java/J6.0 .
    
    5.  Test the result by executing a java program sensitive to
        locale.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IV01441

  • Reported component name

    JAVA CLASS LIBS

  • Reported component ID

    620700130

  • Reported release

    600

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2011-06-06

  • Closed date

    2011-06-06

  • Last modified date

    2011-06-07

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

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

Fix information

  • Fixed component name

    JAVA CLASS LIBS

  • Fixed component ID

    620700130

Applicable component levels

  • R600 PSY

       UP

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCVQ3Y","label":"Java Class Libraries"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"6.0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
07 June 2011