home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Java / Java.zip / javainrt.zip / readme < prev    next >
Text File  |  1998-06-05  |  84KB  |  1,840 lines
  1.   ________________________________________________________________________
  2.  
  3.   OS/2 Warp Developer's Kit for Java(TM) 1.1.6 Installation README
  4.   ________________________________________________________________________
  5.  
  6.  
  7.   OS/2 Warp Developer's Kit for Java(TM) 1.1.6 provides the Sun
  8.   Microsystems, Inc. Java environment on:
  9.  
  10.      OS/2 Warp 4
  11.      OS/2 Warp Server Version 4
  12.      OS/2 Warp Server Advanced Version 4
  13.      OS/2 Warp Server Advanced Version 4 SMP Feature
  14.      WorkSpace On-Demand clients and servers
  15.      OS/2 Warp Version 3
  16.      OS/2 Warp Connect
  17.  
  18.  
  19.   References in this README to OS/2 Warp 4 refer to the OS/2 Warp 4
  20.   client operating system and the WorkSpace On-Demand client.  OS/2
  21.   Warp Server is used to refer to all of the OS/2 Warp Server
  22.   operating systems and the WorkSpace On-Demand server.  References to
  23.   OS/2 Warp 3 refer to OS/2 Warp Version 3 and OS/2 Warp Connect.
  24.  
  25.   This README guides you through installation of OS/2 Warp Developer's Kit
  26.   for Java 1.1.6 (also referred to in this README as Java 1.1.6) and
  27.   provides information about known problems and temporary fixes for them.
  28.  
  29.   ________________________________________________________________________
  30.   CONTENTS
  31.  
  32.      1.   Before You Install
  33.      1.1   Disk Space Requirements
  34.      1.2   Software Prerequisites
  35.      1.2.1   FixPak Required on OS/2 Warp 3 Systems
  36.      1.2.2   OS/2 Warp Server and Warp 3 Systems Require FixPak for Unicode
  37.              Font Support
  38.      1.2.3   FixPak Required for Eurocurrency Symbol Support
  39.      1.2.4   Feature Install Required for Installing Java 1.1.6
  40.      1.3   HPFS and FAT Partition Considerations
  41.      1.4   Coexistence with Prior Versions of Java
  42.      1.4.1   Coexistence with Java 1.0.1 and 1.0.2
  43.      1.4.2   Replacing Previous Versions of Java 1.1.x
  44.      1.5   Backing Up Base OS/2 Files Not Restored during Uninstallation
  45.      1.6   Making a Copy of Your Current CONFIG.SYS File
  46.      1.7   Minimum Hardware Recommendations
  47.      1.8   Installing FixPaks on OS/2 Warp 4 Systems after Java 1.1.6
  48.      1.9   Installation Panel Text Missing or Too Long in DBCS Countries
  49.      1.10  Installing on OS/2 Warp 4 Japanese version (without VoiceType)
  50.      1.11  Japanese Environment Settings on OS/2 Warp 4 Japanese version
  51.      1.12  Required Fonts on OS/2 Warp Japanese version
  52.      2.   Installing OS/2 Warp Developer's Kit for Java 1.1.6
  53.      2.1   Installing OS/2 Warp Developer's Kit for Java 1.1.6 through the
  54.            Graphical User Interface (GUI)
  55.      2.1.1   Desktop Method
  56.      2.1.2   OS/2 Command Prompt Method
  57.      2.1.3   Selections Grayed during Installation
  58.      2.1.4   Recovering from a Failed Installation
  59.      2.1.5   Unable to Create Feature Install Object on OS/2 Warp Server
  60.              and OS/2 Warp 3 Systems
  61.      2.2    Unattended (CID) Installation Method
  62.      2.2.1   Modifying the CID Response File
  63.      2.2.2   Starting the Unattended Installation
  64.      2.2.3   Performing an Unattended Uninstallation
  65.      2.3    TME-Architected CID Installation Method
  66.      2.4.   NetView DM/2 (NVDM/2) Installation Considerations
  67.      2.4.1   Put Static Command in NVDM/2 Profile
  68.      2.4.2   Customize JAVA116.RSP File
  69.      2.5    Remote IPL Installation Considerations
  70.      2.5.1   Creating Response Files
  71.      2.5.2   Modifying the JAVA116.RSP File
  72.      2.5.3   Updating Files for Feature Install
  73.      2.5.4   Starting the Remote IPL Installation
  74.      2.5.5   Running the Java Samples from a Remote IPL Client
  75.      2.5.6   Upgrading Java 1.1.4 to Java 1.1.6 in the Remote IPL Environment
  76.      2.5.7   Remote IPL Restrictions
  77.      2.6    Installing OS/2 Warp Developer's Kit for Java 1.1.6 on WorkSpace
  78.              On-Demand
  79.      2.6.1   Installing OS/2 Warp Developer's Kit for Java 1.1.6 for Use
  80.               on a WorkSpace On-Demand Server
  81.      2.6.2   Installing OS/2 Warp Developer's Kit for Java 1.1.6 for a
  82.               WorkSpace On-Demand Client
  83.      2.6.2.1  Requirements for Installation on a WorkSpace On-Demand Client
  84.      2.6.2.2  Modifying the CID.CMD and WSOD.RSP Files
  85.      2.6.2.3  Installing Additional Java 1.1.6 Components on the WorkSpace
  86.               On-Demand Client
  87.      2.6.3   Uninstalling from WorkSpace On-Demand
  88.      3.   Uninstalling OS/2 Warp Developer's Kit for Java 1.1.6
  89.      3.1    Desktop Method
  90.      3.2    OS/2 Command Prompt Method
  91.      3.3    Restoring Base OS/2 Files
  92.      3.4    State of CONFIG.SYS File After Uninstalling Java 1.1.6
  93.      3.5    Entries Left in CONFIG.SYS after Uninstalling Toolkit Component
  94.      3.6    Unattended Uninstallation
  95.      3.7    Uninstalling on WorkSpace On-Demand
  96.      4.   After You Install
  97.      4.1    Additional Sources of Information
  98.      4.2    Installing Additional Components
  99.      4.3    Starting a Java Application that Calls a Non-Presentation Manager
  100.             Program
  101.      4.4    Disabling the Just-In-Time (JIT) Compiler
  102.      4.5    Native Methods Need to be Recompiled
  103.      4.6    LIBPATH Changes That Could Affect Your System
  104.      4.7    Timer Resolution
  105.      4.8    Applying OS/2 Service after Installing OS/2 Warp Developer's Kit
  106.              for Java 1.1.6
  107.      4.9    Installing a FixPak on OS/2 Warp Server or OS/2 Warp 3 Systems
  108.             after Java 1.1.6
  109.      4.10   Using 16-Color Mode with OS/2 Warp Developer's Kit for Java 1.1.6
  110.      4.11   JDBC-ODBC Bridge Not Provided
  111.      4.12   AWT TextField and TextArea Considerations
  112.      4.13   Controlling Arabic Number Character Display
  113.      4.14   Modifying Font Properties Files Not Supported
  114.      4.15   Printing Considerations
  115.      4.16   Backslash and Tilde Characters in DBCS Countries
  116.      4.17   Using Java 1.0.2 for OS/2 after Installing OS/2 Warp Developer's
  117.              Kit for Java 1.1.6
  118.      4.18   Problems with Time in Java Applets
  119.      4.19   Korean OS/2 Users Need PTF for Updated Fonts
  120.      4.20   TrueType Fonts Must Be Installed on Chinese Systems
  121.      4.21   Conversion between ShiftJIS and Unicode on OS/2 Warp 4
  122.             Japanese version
  123.      4.22   Installing Japanese FixPak 2 (FX00002) over OS/2 Warp 4
  124.             Japanese version (without VoiceType) and Java 1.1.6
  125.      5.   List of OS/2 Base Modules Changed or Added by OS/2 Warp
  126.            Developer's Kit for Java 1.1.6
  127.      6.   Trademarks
  128.  
  129.  
  130.   ________________________________________________________________________
  131.   1. Before You Install
  132.  
  133.      Note:  In this document, the term partition refers to any
  134.             physical or logical drive.
  135.  
  136.      ____________________________
  137.      1.1.  Disk Space Requirements
  138.  
  139.        OS/2 Warp Developer's Kit for OS/2 Warp consists of the following
  140.        components:
  141.  
  142.          Runtime, including Internationalization Support  11.0 MB
  143.          Times New Roman MT 30 Unicode Font               13.0 MB
  144.          Toolkit                                           3.0 MB
  145.          Toolkit Documentation                             8.0 MB
  146.          Samples                                           3.0 MB
  147.          ICAT Debugger for OS/2 Java                      14.0 MB
  148.                                 ______________________    _______
  149.                                 Total installed size      52.0 MB
  150.  
  151.        For convenience, three separate downloadable packages (separate
  152.        ZIP files) are provided. You can download:
  153.  
  154.         - The runtime package, which contains the Runtime component and
  155.           the JIT compiler. The runtime package allows you to run Java
  156.           applets and applications.
  157.  
  158.         - The runtime package, which contains the Runtime component, the
  159.           JIT compiler, and the Unicode Font.  You need this runtime
  160.           package rather than the first one if you use multiple languages
  161.           on a single system or if you use a double-byte character set
  162.           (DBCS) language.
  163.  
  164.         - The development package, which contains the Toolkit, Toolkit
  165.           Documentation, Samples, and the ICAT Debugger.  This package
  166.           allows you to develop Java applets and applications.
  167.  
  168.        The Runtime component must be installed to use any component
  169.        other than Toolkit Documentation.
  170.  
  171.        The Times New Roman MT 30 Unicode Font component can be
  172.        installed on OS/2 Warp 4 systems.  OS/2 Warp Server and OS/2 Warp 3
  173.        systems must be at a FixPak 30 service level or higher to install
  174.        the Unicode Font component.
  175.  
  176.        Ensure that sufficient disk space is available before installing.
  177.  
  178.        Note: Be sure that when you extracted the OS/2 Warp Developer's Kit
  179.              for Java 1.1.6 files from the original ZIP files, you specified
  180.              the proper option on your file extraction utility to create
  181.              subdirectories.  For pkunzip2 this option is -d.  Failure to
  182.              extract the files properly results in the installation program
  183.              failing while copying files. If you did not use this option,
  184.              you should extract the files again before you install.
  185.  
  186.              The different packages contain some identical files.  To
  187.              save time and effort if you are extracting more than one
  188.              package, use the option on your extraction utility that
  189.              overwrites existing files without prompting.  For pkunzip2,
  190.              this option is -o.  If you do not use the option, you will
  191.              be asked, for each duplicate file, whether you want to overwrite
  192.              that file.  Because the files are identical, it makes no
  193.              difference whether you answer Yes or No.
  194.  
  195.      ___________________________
  196.      1.2. Software Prerequisites
  197.  
  198.        _____________________________________________
  199.        1.2.1. FixPak Required on OS/2 Warp 3 Systems
  200.  
  201.        To use OS/2 Warp Developer's Kit for Java 1.1.6 on an OS/2
  202.        Warp 3 system, apply FixPak 32 or higher for single-byte character
  203.        set (SBCS) languages.  For Japanese, Korean, or Traditional
  204.        Chinese, apply FixPak WX03006.  For Simplified Chinese, apply
  205.        FixPak FX03006.  For information about downloading a particular
  206.        FixPak, contact your local IBM OS/2 support representative.  If
  207.        you choose to install the FixPak after installing OS/2 Warp
  208.        Developer's Kit for Java 1.1.6, be sure to read sections 4.8 and
  209.        4.9 of this README.
  210.  
  211.        _____________________________________________________________________
  212.        1.2.2. OS/2 Warp Server and Warp 3 Systems Require FixPak for Unicode
  213.               Font Support
  214.  
  215.        If you want to use the Unicode Font support on an OS/2 Warp Server
  216.        Server or OS/2 Warp 3 system, you should first apply FixPak 30 (or
  217.        higher) for single-byte character set (SBCS) languages.  For
  218.        Japanese, Korean, or Traditional Chinese, apply FixPak WX03006.
  219.        For Simplified Chinese, apply FixPak FX03006.  To obtain access to
  220.        download a particular FixPak, contact your local IBM OS/2 support
  221.        representative.  If you choose to install the FixPak after installing
  222.        OS/2 Warp Developer's Kit for Java 1.1.6, be sure to read sections
  223.        4.8 and 4.9 of this README.
  224.  
  225.        _______________________________________________________
  226.        1.2.3.  FixPak Required for Eurocurrency Symbol Support
  227.  
  228.        If you want to use the Eurocurrency symbol in Java applications
  229.        and applets on an OS/2 Warp 4 system, apply FixPak 6 or higher.
  230.        For Eurocurrency symbol support on OS/2 Warp Server or OS/2 Warp 3
  231.        systems, apply FixPak 35 or higher.  For information about downloading
  232.        a particular FixPak, contact your local IBM OS/2 support representative.
  233.        If you choose to install the FixPak after installing OS/2 Warp
  234.        Developer's Kit for Java 1.1.6, be sure to read sections 4.8 and 4.9 of
  235.        this README.
  236.  
  237.        _________________________________________________________
  238.        1.2.4. Feature Install Required for Installing Java 1.1.6
  239.  
  240.        OS/2 Feature Install is used to install OS/2 Warp Developer's Kit
  241.        for Java 1.1.6, whether you are installing on a local system or on
  242.        a remote system using an unattended CID or remote IPL install.
  243.        Version 1.2 or higher of OS/2 Feature Install is required.
  244.  
  245.        You can obtain the latest version of Feature Install from the
  246.        IBM Software Choice Web site at:
  247.  
  248.              http://www.software.ibm.com/os/warp/swchoice/
  249.  
  250.      ___________________________________________
  251.      1.3.  HPFS and FAT Partition Considerations
  252.  
  253.        The Runtime and ICAT Debugger components can be installed on a
  254.        FAT partition.  However, for better performance, install them on
  255.        an HPFS partition, which supports long file names.  The Toolkit,
  256.        Toolkit Documentation, and Samples components must be installed
  257.        on an HPFS partition.  The Internationalization Support portion
  258.        of the Runtime component and the Times New Roman MT 30 Unicode Font
  259.        component are installed on the boot partition.
  260.  
  261.        If you use the Guided Install path, all components must reside
  262.        on the same partition.  Use Advanced Install to select specific
  263.        drives and directories for the different components.
  264.  
  265.        Note:  If you have only one hard disk with a single FAT
  266.               partition, you have three options:
  267.  
  268.          - Leave your system as it is and install only the Runtime
  269.            component and, optionally, the ICAT Debugger component.
  270.  
  271.          - Format the FAT partition for HPFS and reinstall all software.
  272.  
  273.          - Purchase a disk partitioning program, such as PartitionMagic.
  274.            With sufficient space, a disk partitioning program reduces the
  275.            size of the current partition (drive C) and creates a new
  276.            partition (logical drive D), which can be formatted for HPFS.
  277.  
  278.      _____________________________________________
  279.      1.4.  Coexistence with Prior Versions of Java
  280.  
  281.         OS/2 Warp Developer's Kit for Java 1.1.6 replaces all previous
  282.         versions of Java 1.1.x for OS/2 Warp and coexists with Java 1.0.x.
  283.  
  284.        ____________________________________________
  285.        1.4.1. Coexistence with Java 1.0.1 and 1.0.2
  286.  
  287.        The 1.0.x versions of Java are installed in a \JAVAOS2 directory.
  288.        The installation program, by default, installs OS/2 Warp Developer's
  289.        Kit for Java 1.1.6 in a \JAVA11 directory, which allows the two
  290.        versions of Java to coexist on the system.
  291.  
  292.        Do not install Java 1.1.6 into the \JAVAOS2 directory.  If you
  293.        overlay the files in the \JAVAOS2 directory, Java applets
  294.        that run in Netscape Navigator for OS/2 no longer work, and
  295.        uninstalling OS/2 Warp Developer's Kit for Java 1.1.6 leaves the
  296.        system without Java support.
  297.  
  298.        Java applications and applets that are run from an OS/2 Command
  299.        Prompt or launched from the Desktop use OS/2 Warp Developer's Kit
  300.        for Java 1.1.6.  The use of Java 1.0.2 for OS/2 outside Netscape
  301.        Navigator for OS/2 is not supported after OS/2 Warp Developer's Kit
  302.        for Java 1.1.6 has been installed.
  303.  
  304.        ________________________________________________
  305.        1.4.2. Replacing Previous Versions of Java 1.1.x
  306.  
  307.        If an earlier version of Java 1.1.x is installed on your system,
  308.        you must either uninstall it before you install Java 1.1.6 or
  309.        replace Java 1.1.x by installing Java 1.1.6 over (in the same
  310.        directory as) Java 1.1.x.
  311.  
  312.        If you plan to install fewer components of Java 1.1.6 than you
  313.        currently have on your system from a previous installation of
  314.        Java 1.1.x, you should uninstall the components that you
  315.        will not be replacing before you install Java 1.1.6.  If you
  316.        attempt to install Java 1.1.6 in such a way that you have
  317.        components from different versions of Java 1.1.x, you receive
  318.        warning messages during installation.
  319.  
  320.      ___________________________________________________________________
  321.      1.5.  Backing Up Base OS/2 Files Not Restored during Uninstallation
  322.  
  323.        OS/2 Warp Developer's Kit for Java 1.1.6 updates base operating
  324.        system modules as part of the installation of the Runtime component.
  325.        Uninstalling OS/2 Warp Developer's Kit for Java 1.1.6 does not
  326.        restore the original versions of these files.
  327.  
  328.        In most cases, you do not need to restore the previous versions
  329.        of these files.  If you want the ability to restore these files,
  330.        you must make copies of them before you install.  Be sure to
  331.        record the location of the copied files so that you can restore
  332.        them if necessary.
  333.  
  334.        A complete list of new and changed base modules is included in
  335.        section 5 of this README.
  336.  
  337.  
  338.      ___________________________________________________
  339.      1.6.  Making a Copy of Your Current CONFIG.SYS File
  340.  
  341.        Before installing OS/2 Warp Developer's Kit for Java 1.1.6, make
  342.        a copy of your current CONFIG.SYS file.  This ensures that you can
  343.        return to your original environment if problems occur during
  344.        installation.
  345.  
  346.  
  347.      ______________________________________
  348.      1.7.  Minimum Hardware Recommendations
  349.  
  350.        A minimum of 32 MB of random access memory (RAM) provides the best
  351.        results when running OS/2 Warp Developer's Kit for Java 1.1.6
  352.        applications and applets.  Use an Intel(R) 486 processor or higher
  353.        for OS/2 Warp 4 clients and OS/2 Warp 3 systems.  Use an Intel
  354.        Pentium(R) processor or higher for OS/2 Warp Server systems.
  355.  
  356.      ________________________________________________________________
  357.      1.8.  Installing FixPaks on OS/2 Warp 4 Systems after Java 1.1.6
  358.  
  359.        If you want to install a FixPak prior to FixPak 6 on an OS/2 Warp 4
  360.        system after you have installed OS/2 Warp Developer's Kit for Java
  361.        1.1.6, make sure that the following files remain as they are before
  362.        the FixPak is installed:
  363.  
  364.            CLIFI.EXE
  365.            INSTALL.DLL
  366.            LIBUNI.DLL
  367.            UCONV.DLL
  368.  
  369.        You can do this by using SERVICE.EXE to install the FixPak and
  370.        select not to update the files during installation of the FixPak.
  371.  
  372.        As an alternative, you can use another method to install the FixPak.
  373.        If you use another method, do one of the following:
  374.  
  375.          - Save the files and then replace them after installing the FixPak.
  376.          - Reinstall Feature Install and Java 1.1.6 after installing the
  377.            FixPak.
  378.  
  379.      ___________________________________________________________________
  380.      1.9.  Installation Panel Text Missing or Too Long in DBCS Countries
  381.  
  382.        When installing OS/2 Warp Developer's Kit for Java 1.1.6 on DBCS
  383.        versions of OS/2, DBCS characters might not be displayed on the
  384.        installation panels or the lines could exceed the right border of
  385.        the display window, even when the window is maximized.
  386.  
  387.        To correct these problems, exit the installation program, open
  388.        the Netscape Navigator for OS/2 object, and select the Options
  389.        menu item.  Open the General Preferences notebook and select the
  390.        Fonts tab.  Choose the proper encoding for your country and then
  391.        set the proportional and fixed fonts to MINCHO.  Press OK to save
  392.        the changes.  When you start the installation of OS/2 Warp
  393.        Developer's Kit for Java 1.1.6 again, the text should be displayed
  394.        correctly.
  395.  
  396.  
  397.      ____________________________________________________________________
  398.      1.10. Installing on OS/2 Warp 4 Japanese version (without VoiceType)
  399.  
  400.        If you plan to install Japanese FixPak 2 (FX00002) over OS/2
  401.        Warp 4 Japanese version (without VoiceType), you should do it
  402.        before installing OS/2 Warp Developer's Kit for Java 1.1.6.
  403.        Otherwise, OS/2 may not reboot.
  404.  
  405.        If this occurs, see section 4.22 of this README.
  406.  
  407.  
  408.      ___________________________________________________________________
  409.      1.11. Japanese Environment Settings on OS/2 Warp 4 Japanese version
  410.  
  411.        Use the following Japanese environment settings for OS/2 Warp 4
  412.        Japanese version:
  413.  
  414.                Codepage                932
  415.                ShiftJIS code           New JIS
  416.  
  417.  
  418.      __________________________________________________
  419.      1.12. Required Fonts on OS/2 Warp Japanese version
  420.  
  421.        To run OS/2 Warp Developer's Kit for Java 1.1.6, the following fonts
  422.        are required on your system:
  423.  
  424.  
  425.            Name          Style
  426.            ------------------------------------------
  427.            GOTHIC        Normal
  428.            GOTHIC        HeiseiKakuGothic-W5-H-90-TT
  429.            MINCHO        HeiseiMincho-W3-H-90-TT
  430.  
  431.  
  432.        You can check them in the Font Palette, which is in the System Setup
  433.        folder in the OS/2 System folder.
  434.  
  435.        GOTHIC Normal font is included in GOTHIC system Japanese font.
  436.  
  437.        GOTHIC HeiseiKakuGothic-W5-H-90-TT is IBM HeiseiKakuGothic
  438.        TrueType font with New JIS order.
  439.  
  440.        MINCHO HeiseiMincho-W3-H-90-TT is IBM HeiseiMincho TrueType font
  441.        with New JIS order.
  442.  
  443.        These fonts can be installed through the Selective Install program
  444.        object, which is in:
  445.  
  446.         - The Install/Remove folder in the System Setup folder on OS/2
  447.           Warp 4 systems
  448.  
  449.         - The System Setup folder on OS/2 Warp Server and OS/2 Warp 3 systems.
  450.  
  451.  
  452.   ______________________________________________________
  453.   2. Installing OS/2 Warp Developer's Kit for Java 1.1.6
  454.  
  455.      OS/2 Warp Developer's Kit for Java 1.1.6 is provided in three
  456.      separate downloadable packages:
  457.  
  458.         - The runtime package
  459.         - The runtime package with the Unicode Font
  460.         - The development package
  461.  
  462.      See Section 1.1 for more information about each of the packages.
  463.  
  464.      Keep in mind the following points before you start to install:
  465.  
  466.         - Be sure to download and extract all the packages you will need
  467.           before you begin the installation.
  468.  
  469.         - Always keep all the Java 1.1.x components at the same level.
  470.           For example, you should not have a Java 1.1.6 Runtime component
  471.           and a Java 1.1.4 Toolkit component from an earlier installation
  472.           on the same machine.
  473.  
  474.         - You cannot install the Toolkit, Samples, or ICAT Debugger
  475.           unless you are also installing the Runtime component or you
  476.           have already installed the Runtime component.
  477.  
  478.         - If you use the Graphical User Interface, components that you
  479.           have not downloaded and extracted are grayed and cannot be
  480.           selected for installation.
  481.  
  482.      The sections that follow tell you how to install OS/2 Warp
  483.      Developer's Kit for Java 1.1.6 using different methods.
  484.  
  485.      _____________________________________________________________________
  486.      2.1.  Installing OS/2 Warp Developer's Kit for Java 1.1.6 through the
  487.            Graphical User Interface (GUI)
  488.  
  489.        To install OS/2 Warp Developer's Kit for Java 1.1.6 through the GUI,
  490.        use one of the following methods:
  491.  
  492.        ______________________
  493.        2.1.1.  Desktop Method
  494.  
  495.        To install using the INSTALL.EXE object, follow these steps:
  496.  
  497.         1. Open the OS/2 System folder.
  498.         2. Open the Drives object.
  499.         3. Open the drive where the Java files were extracted.
  500.         4. Open the folder where the Java files were extracted.
  501.         5. Select the INSTALL.EXE object to start the install program.
  502.  
  503.            The installation program leads you through the installation
  504.            steps.  A Java 1.1.6 for OS/2 folder is created in the Programs
  505.            folder on OS/2 Warp 4 systems and on the Desktop on OS/2 Warp
  506.            Server and OS/2 Warp 3 systems.
  507.  
  508.        After the installation is complete, if you want to clean up
  509.        the directory in which the Java files were extracted, select
  510.        the DELINST.CMD object to remove the Java files and
  511.        subdirectories from the directory where they were extracted.
  512.        Files and subdirectories not extracted from the Java 1.1.6
  513.        package are not erased.
  514.  
  515.        __________________________________
  516.        2.1.2.  OS/2 Command Prompt Method
  517.  
  518.        To start installation, make sure that you are in the directory
  519.        where the OS/2 Warp Developer's Kit for Java 1.1.6 files were
  520.        extracted.  At an OS/2 command prompt, type:
  521.  
  522.            install
  523.  
  524.        The installation program leads you through the installation
  525.        steps.  A Java 1.1.6 for OS/2 folder is created in the Programs
  526.        folder on OS/2 Warp 4 systems and on the Desktop on OS/2 Warp
  527.        Server and OS/2 Warp 3 systems.
  528.  
  529.        Optionally, if you want to remove the Java files and
  530.        subdirectories from the directory where they were extracted,
  531.        make sure that you are in the directory where the OS/2 Warp
  532.        Developer's Kit for Java 1.1.6 files were extracted.  At an OS/2
  533.        command prompt, enter:
  534.  
  535.            delinst
  536.  
  537.        Files and subdirectories not extracted from the Java 1.1.6
  538.        package are not erased.
  539.  
  540.        _____________________________________________
  541.        2.1.3.  Selections Grayed during Installation
  542.  
  543.        If you are using the GUI to install Java 1.1.6 and components
  544.        are grayed that you believe you downloaded and extracted, you
  545.        might not have downloaded and properly extracted all the ZIP
  546.        files you need.  Be sure that you have downloaded all the packages
  547.        you need.  Also, be sure that when extracting files from the ZIP
  548.        files, you specify the proper options on your file extraction
  549.        utility to create subdirectories.  For pkunzip2 this option is -d.
  550.        If the files were not extracted properly, extract them again.
  551.  
  552.        Because the three packages contain some duplicate files, you can
  553.        save time by specifying the option on your extraction utility
  554.        that overwrites existing files without prompting.  For pkunzip2,
  555.        this option is -o.  If you do not use the option, you will be asked,
  556.        for each duplicate file, whether you want to overwrite that file.
  557.        Because the files are identical, it makes no difference whether you
  558.        answer Yes or No.
  559.  
  560.        _____________________________________________
  561.        2.1.4.  Recovering from a Failed Installation
  562.  
  563.        If your installation of OS/2 Warp Developer's Kit for Java 1.1.6
  564.        fails, check for and delete any remaining installation objects.  If
  565.        you do not delete these installation objects, future installations
  566.        could fail with a message stating that one or more components could
  567.        not be installed because the object is read-only or in use by
  568.        another process.
  569.  
  570.        The icon for the installation object shows a blue box with a
  571.        red ribbon and is located on the Desktop for a CID install.
  572.        For an attended installation, the object is in the x:\os2\install
  573.        folder.  To delete the object, select the object with the
  574.        right mouse button and select Delete from the menu.
  575.  
  576.        Alternately, go to the directory containing the object, and
  577.        delete the entire directory tree.  The directory is named
  578.        either "Install object" or "Java 1.1 for OS!2" depending on
  579.        when the installation failed.
  580.  
  581.        After deleting the installation object, shut down and restart the
  582.        system.
  583.  
  584.        ___________________________________________________________________
  585.        2.1.5.  Unable to Create Feature Install Object on OS/2 Warp Server
  586.                and OS/2 Warp 3 Systems
  587.  
  588.        If your installation of OS/2 Warp Developer's Kit for Java 1.1.6 fails
  589.        on an OS/2 Warp Server or OS/2 Warp 3 system and you receive a message
  590.        that the program was unable to locate or create a Feature Install
  591.        object, or that it could not find the response file, shut down and
  592.        restart the system and run the installation program again.  This
  593.        problem was addressed by OS/2 APAR PJ24851.  The fix for the problem
  594.        is included in FixPaks 33 and higher.
  595.  
  596.      __________________________________________
  597.      2.2.  Unattended (CID) Installation Method
  598.  
  599.        Unattended or CID installations of OS/2 Warp Developer's Kit for
  600.        Java 1.1.6 are handled by CLIFI, the command-line interface to
  601.        Feature Install, and can take 15 to 20 minutes or more.  After the
  602.        installation program finishes, the system must be restarted to
  603.        complete the installation.
  604.  
  605.        CLIFI requires two response files: the OS/2 Warp Developer's Kit for
  606.        Java 1.1.6 response file, JAVA116.RSP, and a secondary response file
  607.        where users can override the default selections.  The CID.RSP file
  608.        is included in the installation package as an example of the
  609.        customized response file; this is the only file that needs to be
  610.        modified for unattended installations.
  611.  
  612.        Feature Install version 1.2 or higher is required for CID
  613.        installations.  See section 1.2.3 of this README for details.
  614.  
  615.        ______________________________________
  616.        2.2.1. Modifying the CID Response File
  617.  
  618.        The CID.RSP response file contains variables that allow you to
  619.        select which components to install and the target drive and
  620.        directory for each component, where appropriate.
  621.  
  622.        The component names are:
  623.  
  624.          Runtime  - Java Runtime
  625.          Unicode  - Internationalization Support, part of Java Runtime
  626.                     Environment
  627.          Toolkit  - Toolkit
  628.          TlktDoc  - Toolkit Documentation
  629.          Samples  - Samples
  630.          Debugger - OS/2 ICAT Debugger for Java
  631.          Unifont  - Times New Roman MT 30 Unicode Font
  632.          TTengine - Updated TrueType engine, required for the Unicode Font
  633.  
  634.        The CID.RSP file is originally set to install all components.
  635.        Modify it to install the components you want to install.  Be sure
  636.        that you have downloaded and extracted all the files you need.
  637.        In the CID.RSP file, set "selection=1" for each component you
  638.        want to install, and set "selection=0" for each component you
  639.        do not want to install.
  640.  
  641.        Note:  There is now a config component associated with
  642.               each installable component.  The config selection variable
  643.               for each component must always be set to the same value as
  644.               the selection variable for the component.  For example, if
  645.               you set toolkit.selection=0, you must also set
  646.               toolkitconfig.selection=0.
  647.  
  648.        The Runtime component is always installed in the \JAVA11
  649.        directory on the target drive and is a prerequisite for the
  650.        Toolkit, Samples, and Debugger components.
  651.  
  652.        The Internationalization Support portion of the Runtime
  653.        component and the Times New Roman MT 30 Unicode Font
  654.        component are always installed on the boot drive. If the
  655.        Times New Roman MT30 Unicode Font component is installed,
  656.        the TrueType component is required.
  657.  
  658.        The target drive and directory for the other components can
  659.        be specified by setting the drive and path variables to the
  660.        desired values. For example, to install the Debugger
  661.        component in the F:\JAVADEBUG directory:
  662.  
  663.           debugger.selection=1
  664.           debuggerconfig.selection=1
  665.           debugger.dbgdrv=F:
  666.           debugger.dbgpath=\javadebug
  667.  
  668.        If a previous version of Java exists in the specified directory
  669.        on the target drive, the installation program replaces
  670.        it.  If a previous version of a Java component was installed and
  671.        you have not selected to reinstall that component, the installation
  672.        program displays a window that warns you that this component will be
  673.        downlevel and that lets you choose to upgrade the component.
  674.  
  675.        To suppress this confirmation window, along with any others
  676.        encountered during installation, set the java11.continue variable
  677.        to UNATTENDED:
  678.  
  679.          java11.continue=UNATTENDED
  680.  
  681.  
  682.        ___________________________________________
  683.        2.2.2. Starting the Unattended Installation
  684.  
  685.        The CID.CMD file contains a sample CLIFI command for a CID
  686.        installation.  The CLIFI command can also be entered as a
  687.        single-line command at an OS/2 command prompt as shown below:
  688.  
  689.          clifi /a:c /r2:cid.rsp /r:java116.rsp /b:c: /s:d:\tmp
  690.               /l1:ciderr.log /l2:cidhist.log
  691.  
  692.        where:
  693.             /r           Specifies the fully qualified location of the
  694.                          Feature Install response file
  695.             /b           Specifies the boot drive
  696.             /s           Specifies the fully qualified location of the
  697.                          extracted OS/2 Warp Developer's Kit for Java
  698.                          1.1.6 files
  699.             /l1 and /l2  Specifies the fully qualified locations of the
  700.                          optional log files.  Refer to these files, in
  701.                          addition to the \os2\install\wpinstal.log file
  702.                          on the boot drive, if problems occur during
  703.                          installation.
  704.  
  705.        ______________________________________________
  706.        2.2.3. Performing an Unattended Uninstallation
  707.  
  708.        To uninstall OS/2 Warp Developer's Kit for Java 1.1.6, enter the
  709.        following single-line command at an OS/2 command prompt:
  710.  
  711.          clifi /a:u /f:"<WP_INSTALLED>" /o:INV_JAVA11 /set:Selection=ALL
  712.  
  713.      _____________________________________________
  714.      2.3.  TME-Architected CID Installation Method
  715.  
  716.        A JAVA116.ADF file is provided for use with Tivoli Management
  717.        Environment (TME) architected CID installation products, such as
  718.        NetFinity Server and the Tivoli TME-10 Software Distribution
  719.        Agent.  See the documentation pertaining to the CID installation
  720.        product being used for instructions regarding the use of .ADF
  721.        files.
  722.  
  723.        When doing a TME-architected CID installation, you must add the
  724.        following line to your CID.RSP response file:
  725.  
  726.              java11.CID=TME
  727.  
  728.        Modifying the CID response file is described in section 2.2.1 of
  729.        this README.
  730.  
  731.      _______________________________________________________
  732.      2.4.  NetView DM/2 (NVDM/2) Installation Considerations
  733.  
  734.        A NVDM/2 CID installation requires creating a profile and then
  735.        building and cataloging a change file.  The NVDM/2 profile
  736.        allows you to specify only one response file; however, the
  737.        OS/2 Warp Developer's Kit for Java 1.1.6 unattended installation
  738.        requires two response files.  In addition, variable and argument
  739.        handling in NVDM/2 is different than that used in Feature Install,
  740.        which is used to install OS/2 Warp Developer's Kit for Java 1.1.6.
  741.  
  742.        Use one of the following methods to install OS/2 Warp Developer's
  743.        Kit for Java 1.1.6 using NVDM/2.
  744.  
  745.        ___________________________________________
  746.        2.4.1. Put Static Command in NVDM/2 Profile
  747.  
  748.        In the NVDM/2 profile, specify all the CLIFI options in the
  749.        PARMS variable.  The parameters must be on a single line and
  750.        enclosed in double quotation marks:
  751.  
  752.           Program=c:\os2\install\clifi.exe
  753.           Parms="/a:c /r2:cid.rsp /r:java116.rsp /b:c: /s:d:\tmp
  754.               /l1:ciderr.log /l2:cidhist.log"
  755.  
  756.        This method requires you to modify the profile whenever the
  757.        source directory or log file names are changed.  You could
  758.        replace these values with workstation-specific variable
  759.        values, as shown below:
  760.  
  761.           Program=c:\os2\install\clifi.exe
  762.           Parms="/a:c /r2:$(ResponseFile) /r:$(SourceDir)\java116.rsp
  763.                  /b:c: /s:$(SourceDir) /l1:$(LogFile1) /l2:$(LogFile2)"
  764.           ResponseFile=$(WorkstatName).rsp
  765.           SourceDir=d:\tmp
  766.           LogFile1=$(WorkstatName).log
  767.           LogFile2=$(WorkstatName).lg2
  768.  
  769.        This second method requires a separate response file for each
  770.        workstation and requires WorkstatName to be set appropriately.
  771.  
  772.        _________________________________
  773.        2.4.2. Customize JAVA116.RSP File
  774.  
  775.        You can directly modify the JAVA116.RSP file with the
  776.        appropriate information.  However, because this file is very
  777.        large, modifications can be time consuming and error-prone.
  778.        If you decide to modify the file, see Section 2.5.2 of this
  779.        README before you begin.
  780.  
  781.      ____________________________________________
  782.      2.5.  Remote IPL Installation Considerations
  783.  
  784.        A remote IPL installation requires creating two response
  785.        files and setting up the appropriate directories and files
  786.        on the remote IPL server.
  787.  
  788.        Follow these steps for each client to be installed:
  789.  
  790.         1. Place the extracted Java 1.1.6 installation files on the remote
  791.            IPL server.
  792.         2. Run the GENFIRPL command.  (See Section 2.5.1 for information.)
  793.         3. Run the CLIFI command for one remote IPL client.  (See
  794.            Section 2.5.4 for information.)
  795.         4. Modify the client FIT file (See Sections 2.5.3 and 2.5.5)
  796.  
  797.        ______________________________
  798.        2.5.1. Creating Response Files
  799.  
  800.        After placing the extracted OS/2 Warp Developer's Kit for Java 1.1.6
  801.        installation files on the remote IPL server, the GENFIRPL command is
  802.        used to generate two response files:  FILES.RSP for the remote IPL
  803.        server and JAVA116.RSP for the remote IPL client.  The following is
  804.        a sample GENFIRPL command.  The command should be entered on a
  805.        single line.
  806.  
  807.              genfirpl /m:c:\javacode  /r:c:\ibmlan\rpl
  808.                   /u:c:\ibmlan\rpluser  /f:c:\javacode\java116.rsp
  809.                   /c:client_name  /b:x:
  810.        where:
  811.  
  812.            /m   Specifies the directory containing the unpacked
  813.                 OS/2 Warp Developer's Kit for Java 1.1.6 installation
  814.                 files on the remote IPL server
  815.            /r   Specifies the RPL directory
  816.            /u   Specifies the RPLUSER directory
  817.            /f   Specifies the fully qualified name of the response
  818.                 file for the remote IPL client
  819.            /c   Specifies the name of the remote IPL client
  820.            /b   Specifies the remote IPL client's boot drive
  821.            /nf  Suppresses Java file transfer. Use this flag when installing
  822.                 additional remote IPL clients, after the first one, to prevent
  823.                 the Java 1.1.6 files from being installed again for each
  824.                 new client.
  825.  
  826.        The remote IPL client must not be running when the GENFIRPL
  827.        command is issued.  One GENFIRPL command must be done for
  828.        each remote IPL client, specifying the appropriate client name
  829.        and boot drive.
  830.  
  831.        _____________________________________
  832.        2.5.2. Modifying the JAVA116.RSP File
  833.  
  834.        The JAVA116.RSP file defaults to installing all the components
  835.        of OS/2 Warp Developer's Kit for Java 1.1.6.  You can modify this
  836.        response file to explicitly set which components you
  837.        want to install.  Be sure to download and extract all the files
  838.        you need before you start the installation.
  839.  
  840.        Be sure to use a text editor that handles lines greater than
  841.        255 characters, such as TEDIT, to prevent truncation of the
  842.        long lines in this file.  Because this file is very large,
  843.        modifications can be time consuming and error-prone.  Make
  844.        a backup copy of JAVA116.RSP before modifying it to prevent
  845.        loss of data.
  846.  
  847.        The component names that can be selected are:
  848.  
  849.          Runtime  - Java Runtime
  850.          Unicode  - Internationalization Support, part of Java Runtime
  851.                     Environment
  852.          Toolkit  - Toolkit
  853.          TlktDoc  - Toolkit Documentation
  854.          Samples  - Samples
  855.          Debugger - OS/2 ICAT Debugger for Java
  856.          Unifont  - Times New Roman MT 30 Unicode Font
  857.          TTengine - Updated TrueType engine, required for the Unicode Font
  858.  
  859.        Use the selection variables to select the components to install.
  860.        The selection variables for the Unifont and TTengine components
  861.        must be set to the same value.  For example, to install only the
  862.        Runtime and Unicode Font components, set the following variables,
  863.        which are scattered throughout the JAVA116.RSP file, as shown:
  864.  
  865.            runtime.selection=1
  866.            runtimeconfig.selection=1
  867.            toolkit.selection=0
  868.            toolkitconfig.selection=0
  869.            tlktdoc.selection=0
  870.            tlktdocconfig.selection=0
  871.            samples.selection=0
  872.            samplesconfig.selection=0
  873.            unifont.selection=1
  874.            unifontconfig.selection=1
  875.            TTengine.selection=1
  876.            TTengineconfig.selection=1
  877.  
  878.        Note:  There is now a config component associated with
  879.               each installable component.  The config selection variable
  880.               for each component must always be set to the same value as
  881.               the selection variable for the component.  For example, if
  882.               you set toolkit.selection=0, you must also set
  883.               toolkitconfig.selection=0.
  884.  
  885.        _________________________________________
  886.        2.5.3. Updating Files for Feature Install
  887.  
  888.        The client_name.FIT file for each remote IPL client must be
  889.        modified to include the following, which must be entered on a
  890.        single line:
  891.  
  892.          x:\os2\install\install.inv
  893.             \\server_name\WRKFILES\client_name\os2\install\install.inv
  894.  
  895.        Substitute the name of the remote IPL server and remote IPL client
  896.        for server_name and client_name.
  897.  
  898.  
  899.        ___________________________________________
  900.        2.5.4. Starting the Remote IPL Installation
  901.  
  902.        Remote IPL installations are handled by CLIFI, the Feature Install
  903.        installation program, and can take 15 to 20 minutes or more.
  904.        After logging on to the remote IPL server as an administrator, run
  905.        the CLIFI command, using the response file created for the
  906.        remote IPL server, FILES.RSP:
  907.  
  908.              clifi /a:i  /r:c:\javacode\files.rsp
  909.  
  910.        where /r specifies the fully qualified name of the remote IPL
  911.        server's response file.
  912.  
  913.        It is necessary to reboot the remote IPL Server after running
  914.        clifi if file transfer has not been suppressed.
  915.  
  916.        Run the CLIFI command on each remote IPL client after you run the
  917.        GENFIRPL command for that client.
  918.  
  919.              clifi /a:i  /r:z:\java116.rsp
  920.  
  921.        where /r specifies the fully qualified name of the remote IPL
  922.        client's response file, as specified on the GENFICMD
  923.        command.
  924.  
  925.        ________________________________________________________
  926.        2.5.5. Running the Java Samples from a Remote IPL Client
  927.  
  928.        The remote IPL server administrator must add the following lines to
  929.        the RPL\FITS\client_name.FIT file to give the remote IPL client the
  930.        ability to run the samples provided in the Samples component:
  931.  
  932.           x:\JAVA11\WEBLOGS \\server_name\WRKFILES\client_name\JAVA11\WEBLOGS
  933.           x:\JAVA11\HOTJAVA \\server_name\WRKFILES\client_name\JAVA11\HOTJAVA
  934.  
  935.        Substitute the names of the remote IPL server and remote IPL client
  936.        for server_name and client_name.
  937.  
  938.        The remote IPL clients can compile the sample code if the samples are
  939.        placed in a directory to which the remote IPL client has write access.
  940.  
  941.  
  942.        _______________________________________________________________________
  943.        2.5.6. Upgrading Java 1.1.4 to Java 1.1.6 in the Remote IPL Environment
  944.  
  945.        To upgrade Java 1.1.4 to Java 1.1.6 in the remote IPL environment:
  946.  
  947.         1. Place the extracted Java 1.1.6 installation files on the remote IPL
  948.            server.
  949.         2. Run the GENFIRPL command.  (See Section 2.5.1 for information.)
  950.         3. Run the CLIFI command for one remote IPL client.  (See Section 2.5.4
  951.            for information.
  952.  
  953.         This process updates the Java files on the remote IPL server.
  954.         Because all remote IPL clients access the same files on the server,
  955.         the upgrade is done for all clients.  The client configuration
  956.         information is present from the Java 1.1.4 installation.
  957.  
  958.  
  959.        ______________________________
  960.        2.5.7. Remote IPL Restrictions
  961.  
  962.        You cannot uninstall OS/2 Warp Developer's Kit for Java 1.1.6
  963.        in the remote IPL environment.
  964.  
  965.      ____________________________________________________________
  966.      2.6.  Installing OS/2 Warp Developer's Kit for Java 1.1.6 on
  967.            WorkSpace On-Demand
  968.  
  969.        WorkSpace On-Demand is a client-server system that uses network
  970.        computers (clients) that are designed to be remotely loaded from
  971.        a network server. The WorkSpace On-Demand client runs Java
  972.        applications, Netscape Navigator, and the Personal Communications
  973.        Entry Level host access application, as well as other applications;
  974.        it also supports native execution of DOS, Windows 3.1, and OS/2
  975.        applications. The WorkSpace On-Demand server runs on an OS/2 Warp
  976.        Server and provides enhanced server support to manage the clients.
  977.  
  978.        The WorkSpace On-Demand product includes Java 1.1.1 for OS/2 Warp.
  979.        You can install OS/2 Warp Developer's Kit for Java 1.1.6 on
  980.        WorkSpace On-Demand servers and clients to upgrade from Java 1.1.1.
  981.  
  982.        __________________________________________________________________
  983.        2.6.1. Installing OS/2 Warp Developer's Kit for Java 1.1.6 for Use
  984.               on a WorkSpace On-Demand Server
  985.  
  986.        To install Java 1.1.6 on a WorkSpace On-Demand server, use the
  987.        GUI.  See Section 2.1 of this README for instructions for using
  988.        the GUI to install.  During installation on a WorkSpace On-Demand
  989.        server, a warning is displayed explaining that you are not updating
  990.        Java support for the client.  When you select "Yes", installation
  991.        proceeds as for other GUI installations.
  992.  
  993.        ________________________________________________________________
  994.        2.6.2. Installing OS/2 Warp Developer's Kit for Java 1.1.6 for a
  995.               WorkSpace On-Demand Client
  996.  
  997.        Installation of Java 1.1.6 on a WorkSpace On-Demand Client is done
  998.        as an unattended (CID) installation.  You can use the instructions
  999.        in Section 2.2 of this README and use the CID.CMD and WSOD.RSP
  1000.        files that are included in the Java 1.1.6 installation package.
  1001.  
  1002.          _______________________________________________________________
  1003.          2.6.2.1. Requirements for Installation on a WorkSpace On-Demand
  1004.                   Client
  1005.  
  1006.          Before you can install Java 1.1.6 for a WorkSpace On-Demand client,
  1007.          Java 1.1.1 must already be installed.  If the Times New Roman MT 30
  1008.          Unicode Font (the Unifont component) is selected for installation,
  1009.          it must also have been previously installed with WorkSpace On-Demand.
  1010.          If this support is not present, the installation is completed
  1011.          without transferring files.  In this case, the wpinstal.log shows
  1012.          that installation completed successfully but it does not show that
  1013.          any files were transferred.
  1014.  
  1015.          _________________________________________________
  1016.          2.6.2.2. Modifying the CID.CMD and WSOD.RSP Files
  1017.  
  1018.          Before starting the installation, modify the CID.CMD and WSOD.RSP
  1019.          files as follows:
  1020.  
  1021.          1. In the CID.CMD file, change /r2:cid.rsp to /r2:wsod.rsp.
  1022.  
  1023.          2. As described in Section 2.2.2:
  1024.  
  1025.             - Replace /s:d:\javainst in the CID.CMD file with the drive
  1026.               and directory where you unzipped the install package.
  1027.             - Be sure that /b:c in the CID.CMD file points to the boot drive.
  1028.  
  1029.          3. Verify that the selections in the WSOD.RSP files are
  1030.             appropriate for what you want to install.  By default the
  1031.             Java Runtime Environment and Unicode Font are selected; all
  1032.             other components are deselected.  Be sure to download and
  1033.             extract all the files you need.
  1034.  
  1035.          ___________________________________________________________
  1036.          2.6.2.3. Installing Additional Java 1.1.6 Components on the
  1037.                   Workspace On-Demand Client
  1038.  
  1039.          If you want to install components other than the Java Runtime
  1040.          Environment and Unicode font for the WorkSpace On-Demand client,
  1041.          you can select these components in the WSOD.RSP file.  If you
  1042.          install the ICAT Debugger, a WorkSpace On-Demand administrator
  1043.          must make the following additions to the CONFIG.SYS files for
  1044.          the clients:
  1045.  
  1046.            - Add  Z:\java11\icatjava\dll; to the LIBPATH statement.
  1047.            - Add  Z:\java11\icatjava\bin; to the SET PATH statement.
  1048.            - Add  Z:\java11\icatjava\help; to the SET DPATH and SET HELP
  1049.              statements.
  1050.            - Add Z:\java11\icatjava\daemon\javaprob.zip; to the
  1051.              SET CLASSPATH statement.
  1052.            - Add  RUN=Z:\mptn\bin\ifconfig.exe lo 127.0.0.1 up
  1053.  
  1054.          Substitute the drive and directory where the ICAT debugger is
  1055.          installed for Z:\java11.
  1056.  
  1057.        ____________________________________________
  1058.        2.6.3. Uninstalling from WorkSpace On-Demand
  1059.  
  1060.        Support for uninstalling Java 1.1.6 requires access to an inventory
  1061.        object in the Installed Features directory (\os2\install\installed
  1062.        features).  If you install Java 1.1.6 both for the WorkSpace On-Demand
  1063.        client and the WorkSpace On-Demand server, the Java 1.1.6 inventory
  1064.        object is damaged or replaced.
  1065.  
  1066.        To remove Java 1.1.6 from the client space, reinstall the WorkSpace
  1067.        On-Demand version of Java 1.1.1.  This installation will replace
  1068.        Java 1.1.6.
  1069.  
  1070.        To remove Java 1.1.6 from the server, delete the \java11 directory
  1071.        structure.  You can delete the directory structure from the Drives
  1072.        folder in the OS/2 System folder.  In addition, if you installed
  1073.        the Unicode Font, delete the file \os2\dll\tnrmt30.ttf, which is
  1074.        on the boot drive.
  1075.  
  1076.   ________________________________________________________
  1077.   3. Uninstalling OS/2 Warp Developer's Kit for Java 1.1.6
  1078.  
  1079.      To uninstall OS/2 Warp Developer's Kit for Java 1.1.6, use the Remove
  1080.      Java 1.1.6 for OS/2 object or the UNINSTAL program.  These methods are
  1081.      described in the sections that follow.
  1082.  
  1083.      These sections also describe how to optionally restore some OS/2 base
  1084.      operating system files to their previous versions.
  1085.  
  1086.      ____________________
  1087.      3.1.  Desktop Method
  1088.  
  1089.        To uninstall using the Remove Java 1.1.6 object, follow these
  1090.        steps:
  1091.  
  1092.        1. Open the OS/2 System folder.
  1093.        2. Open the System Setup folder.
  1094.        3. If you are uninstalling from an OS/2 Warp 4 system only, open
  1095.           the Install/Remove folder.
  1096.        4. Open the Uninstall Features folder.
  1097.        5. Select the Remove Java 1.1.6 for OS/2 object to start the
  1098.           uninstall program.
  1099.        6. (Optional) Follow the instructions in section 3.3 to restore
  1100.           base OS/2 files if they were saved before installing
  1101.           OS/2 Warp Developer's Kit for Java 1.1.6.
  1102.  
  1103.      ________________________________
  1104.      3.2.  OS/2 Command Prompt Method
  1105.  
  1106.        To start uninstalling, make sure that you are either in the directory
  1107.        where the OS/2 Warp Developer's Kit for Java 1.1.6 files were
  1108.        extracted or in the \JAVA11\UNINSTAL directory.  At an OS/2 command
  1109.        prompt, enter:
  1110.  
  1111.            uninstal
  1112.  
  1113.        The uninstall program leads you through the uninstallation process.
  1114.        Only files and directories created by the installation process are
  1115.        removed.  For instance, the HOTJAVA directory created by running
  1116.        the Applet Viewer is not removed during uninstallation.
  1117.  
  1118.        You can optionally choose to restore base OS/2 files that were
  1119.        saved before installing OS/2 Warp Developer's Kit for Java 1.1.6
  1120.        by following the instructions in the next section.
  1121.  
  1122.      _______________________________
  1123.      3.3.  Restoring Base OS/2 Files
  1124.  
  1125.        In most cases, the base OS/2 files replaced during the
  1126.        installation of OS/2 Warp Developer's Kit for Java 1.1.6 can be
  1127.        used after you uninstall OS/2 Warp Developer's Kit for Java 1.1.6.
  1128.        If you made copies of the original files, as described in section
  1129.        1.5 of this README, you can optionally choose to restore them.
  1130.  
  1131.        Some of the files you backed up are locked during normal system
  1132.        operation and cannot be overwritten with the backup copy while
  1133.        the system is running.  To replace these files, follow these
  1134.        steps:
  1135.  
  1136.        1. Restart the computer.
  1137.        2. When the white block and the name OS/2 are displayed in the top
  1138.           left hand-corner of the display, press Alt+F1.
  1139.        3. Select the option to boot to an OS/2 command line.
  1140.        4. Restore the files with the ones you saved before
  1141.           installing OS/2 Warp Developer's Kit for Java 1.1.6.
  1142.        5. At an OS/2 command prompt, type:
  1143.  
  1144.            exit
  1145.  
  1146.        and press Enter.  The system now restarts.
  1147.  
  1148.      ___________________________________________________________
  1149.      3.4. State of CONFIG.SYS File After Uninstalling Java 1.1.6
  1150.  
  1151.        If you installed Java 1.1.6 over Java 1.1.x and you later uninstall
  1152.        Java 1.1.6, the CONFIG.SYS file is returned to the Java 1.1.x
  1153.        level.
  1154.  
  1155.      _________________________________________________________________________
  1156.      3.5. Entries Left in CONFIG.SYS File after Uninstalling Toolkit Component
  1157.  
  1158.         If you install the Toolkit component of Java 1.1.6 and later
  1159.         uninstall the component, the SET LIB= and SET INCLUDE= statements
  1160.         in the CONFIG.SYS might still contain references to the directory
  1161.         where the Toolkit component was installed.
  1162.  
  1163.      _______________________________
  1164.      3.6.  Unattended Uninstallation
  1165.  
  1166.        For information about performing an unattended uninstallation, see
  1167.        Section 2.2.3 of this README.
  1168.  
  1169.      _________________________________________
  1170.      3.7.  Uninstalling on WorkSpace On-Demand
  1171.  
  1172.        For information about uninstalling on WorkSpace On-Demand, see
  1173.        Section 2.6.3 of this README.
  1174.  
  1175.   ________________________________________________________________________
  1176.   4. After You Install
  1177.  
  1178.      The following sections provide additional information you might
  1179.      need after you install OS/2 Warp Developer's Kit for Java 1.1.6.
  1180.      _______________________________________
  1181.      4.1.  Additional Sources of Information
  1182.  
  1183.        The objects in the following list are displayed in the Java 1.1.6
  1184.        for OS/2 folder only if you are running OS/2 Warp 4.  If you are
  1185.        running OS/2 Warp Server or OS/2 Warp 3, you can access the associated
  1186.        documents at the locations shown.  (x: is the partition where you
  1187.        installed Java.)
  1188.  
  1189.           IBM Centre for Java Technology
  1190.              http://ncc.hursley.ibm.com/javainfo/hurindex.html
  1191.  
  1192.           Running Java
  1193.              x:\JAVA11\runtime.htm
  1194.  
  1195.           Configure Applet Viewer
  1196.              x:\JAVA11\cnfgappl.htm
  1197.  
  1198.           Java Documentation
  1199.              http://www.javasoft.com/doc.html
  1200.  
  1201.           Java Developer's Kit for OS/2
  1202.              x:\JAVA11\index.html
  1203.  
  1204.           Java Toolkit
  1205.              x:\JAVA11\toolkit.html
  1206.  
  1207.           Java API
  1208.              x:\JAVA11\docs\api\API_users_guide.html
  1209.  
  1210.           ICAT Debugger for OS/2 Java
  1211.              x:\JAVA11\ICATJAVA\help\icatjava.htm
  1212.  
  1213.  
  1214.        If you installed the Toolkit, Toolkit Documentation, or ICAT
  1215.        Debugger for OS/2 Java components in different directories than the
  1216.        Runtime component, specify the appropriate directory for the last
  1217.        four objects listed above.  The links to the Runtime documentation,
  1218.        the ICAT Debugger for OS/2 Java, and README in the Toolkit
  1219.        documentation do not work if the components are in different places.
  1220.  
  1221.      ______________________________________
  1222.      4.2.  Installing Additional Components
  1223.  
  1224.        After the initial installation of OS/2 Warp Developer's Kit for Java
  1225.        1.1.6, you can install additional components by re-running the
  1226.        installation procedure.  This requires that you keep all of the
  1227.        extracted files on your system or that you keep the original ZIP
  1228.        files and extract the files again when needed.
  1229.  
  1230.      _______________________________________________________________________
  1231.      4.3.  Starting a Java Application that Calls a Non-Presentation Manager
  1232.            Program
  1233.  
  1234.      If you start a Java application that calls a non-Presentation Manager
  1235.      program, use the -norestart option.  For example, if Java application
  1236.      JavaApp calls a non-Presentation Manager program, start it by typing
  1237.  
  1238.              java -norestart JavaApp
  1239.  
  1240.      at the OS/2 command prompt.  Errors occur if you do not use the
  1241.      -norestart option.
  1242.  
  1243.      _______________________________________________
  1244.      4.4.  Disabling the Just-In-Time (JIT) Compiler
  1245.  
  1246.        A just-in-time (JIT) compiler is provided with OS/2 Warp Developer's
  1247.        Kit for Java 1.1.6.  This compiler generates machine code for
  1248.        frequently used byte-code sequences in a Java application or applet
  1249.        on-the-fly during execution.  The JIT is enabled by default.
  1250.  
  1251.        You can disable the JIT to aid in the isolation of a problem with
  1252.        a Java application, an applet, or the compiler itself.  See the
  1253.        RUNTIME.HTM file in the x:\JAVA11 directory for details.  (x is the
  1254.        drive on which Java is installed.)
  1255.  
  1256.        When the JIT compiler is enabled, an uncaught exception generates
  1257.        a trace back without source line numbers.  You must disable the
  1258.        JIT and run the failing application again to obtain a trace back
  1259.        with line numbers.
  1260.  
  1261.      __________________________________________
  1262.      4.5.  Native Methods Need to be Recompiled
  1263.  
  1264.        Java methods implemented using version 1.0x of Java in a native
  1265.        language, such as C or C++, need to be recompiled for OS/2 Warp
  1266.        Developer's Kit for Java 1.1.6.  See the TOOLKIT.HTML file for
  1267.        details.  This file is in the directory where you installed the
  1268.        Java Toolkit component.
  1269.  
  1270.      ___________________________________________________
  1271.      4.6.  LIBPATH Changes That Could Affect Your System
  1272.  
  1273.        When the installation program determines that the OS/2 base DLL
  1274.        modules that need to be replaced exist in a directory other than
  1275.        x:\OS2\DLL, the position of x:\OS2\DLL is changed in the LIBPATH
  1276.        to ensure that the correct version of the modules are loaded.
  1277.  
  1278.        The IBM Developer's Toolkit for OS/2 Warp is one product that
  1279.        includes OS/2 base DLL modules in a different directory.  This
  1280.        change does not affect the Toolkit, but could affect other products
  1281.        that include OS/2 base DLL modules.
  1282.  
  1283.      ______________________
  1284.      4.7.  Timer Resolution
  1285.  
  1286.        The environment variable JAVA_CLOCK_RESOLUTION allows you to specify
  1287.        the timer resolution you require from the currentTimeMillis method
  1288.        in the java.lang.System class.  The resolution is specified in
  1289.        milliseconds.  For example:
  1290.  
  1291.             SET JAVA_CLOCK_RESOLUTION = 1
  1292.  
  1293.        sets the minimum timer resolution to 1 millisecond (the highest
  1294.        resolution) for Java applications that use currentTimeMillis.
  1295.  
  1296.        The timer resolutions available are dependent on those provided by
  1297.        the OS/2 system. The Java system rounds down to the nearest available
  1298.        resolution.  1 millisecond is always available and is the highest
  1299.        resolution available.  The default for JAVA_CLOCK_RESOLUTION is
  1300.        10 milliseconds, and this is generally rounded to 1 millisecond
  1301.        accuracy.
  1302.  
  1303.        If you need to ensure that the best Java performance is obtained
  1304.        when using currentTimeMillis, set JAVA_CLOCK_RESOLUTION = 32. This
  1305.        can be important when running Java benchmarks.
  1306.  
  1307.  
  1308.      ______________________________________________________________________
  1309.      4.8.  Applying OS/2 Service after Installing OS/2 Warp Developer's Kit
  1310.            for Java 1.1.6
  1311.  
  1312.        OS/2 Warp Developer's Kit for Java 1.1.6 replaces base operating
  1313.        system modules as part of installation.  When you apply service to
  1314.        your OS/2 system after installing OS/2 Warp Developer's Kit for Java
  1315.        1.1.6, you are normally prompted if you attempt to replace a module
  1316.        that is newer than the one on the FixPak.  However, if you install
  1317.        service by booting from the FixPak diskettes, you are not prompted
  1318.        when this condition exists, which could result in one or more modules
  1319.        being regressed.  Either do not apply service by booting from the
  1320.        diskettes, or back up the base OS/2 modules before installing service
  1321.        and replace them after applying service.
  1322.  
  1323.        A complete list of new and changed base modules is provided in
  1324.        section 5 of this README.
  1325.  
  1326.  
  1327.      ____________________________________________________________________
  1328.      4.9.  Installing a FixPak on OS/2 Warp Server or OS/2 Warp 3 Systems
  1329.            after Java 1.1.6
  1330.  
  1331.        If you install FixPak 30 or greater (or DBCS equivalent) on an OS/2
  1332.        Warp Server or OS/2 Warp 3 system after you have installed OS/2 Warp
  1333.        Developer's Kit for Java 1.1.6, and you want to use the Unicode Font
  1334.        support, you must reinstall the Runtime and Times New Roman MT 30
  1335.        Unicode Font components.
  1336.  
  1337.      _______________________________________________________________________
  1338.      4.10. Using 16-Color Mode with OS/2 Warp Developer's Kit for Java 1.1.6
  1339.  
  1340.        The Java 1.1.6 specification requires 256-color mode (or greater).
  1341.        OS/2 Warp Developer's Kit for Java 1.1.6 does not support Java
  1342.        applications and applets using the Abstract Window Toolkit (AWT)
  1343.        in 16-color mode.
  1344.  
  1345.      ___________________________________
  1346.      4.11. JDBC-ODBC Bridge Not Provided
  1347.  
  1348.        OS/2 Warp Developer's Kit for Java 1.1.6 provides JDBC (Java
  1349.        Database Connectivity), a database access interface that provides
  1350.        access to a wide range of relational databases.  However, not all
  1351.        relational databases provide a JDBC driver.  To access databases
  1352.        that support the Open Database Connectivity (ODBC) standard, a
  1353.        JDBC-ODBC Bridge is needed.  The JDBC-ODBC Bridge allows ODBC
  1354.        drivers to be used as JDBC drivers by using native code to interface
  1355.        with ODBC.  OS/2 Warp Developer's Kit for Java 1.1.6 does not
  1356.        provide a JDBC-ODBC bridge.
  1357.  
  1358.      _______________________________________________
  1359.      4.12. AWT TextField and TextArea Considerations
  1360.  
  1361.        The AWT TextField and TextArea controls do not support characters
  1362.        outside of the current code page.  Users running on US English
  1363.        systems can switch to code page 850 (the multilingual code page, which
  1364.        supports the Western European languages) to see additional language
  1365.        characters in these controls.
  1366.  
  1367.      _________________________________________________
  1368.      4.13. Controlling Arabic Number Character Display
  1369.  
  1370.        Users in some countries could unexpectedly see Arabic number
  1371.        characters appear.  Some country-specific versions of OS/2 map the
  1372.        characters x'00B0' through x'00B9' to the Arabic numbers 0 through
  1373.        9.  To see the desired characters, change the Bidirectional
  1374.        Attributes in CONFIG.SYS or use the Language page in the
  1375.        Properties Notebook (Settings Notebook in OS/2 Warp Server or OS/2
  1376.        Warp 3) of the object to obtain the desired effect.
  1377.  
  1378.      ___________________________________________________
  1379.      4.14. Modifying Font Properties Files Not Supported
  1380.  
  1381.        Modifying the font properties files provided with OS/2 Warp
  1382.        Developer's Kit for Java 1.1.6 is not supported.
  1383.  
  1384.  
  1385.      _____________________________
  1386.      4.15. Printing Considerations
  1387.  
  1388.        Java provides no mechanism to communicate with the printer driver
  1389.        in order to set or retrieve job properties.
  1390.  
  1391.        Printing from a Java application or applet results in a printer
  1392.        properties dialog box being displayed.  OS/2 Warp Developer's Kit
  1393.        for Java 1.1.6 provides an environment variable called
  1394.        JAVA_NOPRINTDLG that suppresses the dialog box and prints the file
  1395.        using the default properties.
  1396.  
  1397.        To suppress the dialog box and use the default print properties:
  1398.  
  1399.                SET JAVA_NOPRINTDLG=1
  1400.  
  1401.  
  1402.      ______________________________________________________
  1403.      4.16. Backslash and Tilde Characters in DBCS Countries
  1404.  
  1405.  
  1406.        Certain DBCS code pages (for example, 932, 942, 943, 949) do not
  1407.        have a backslash or tilde character at the same code point as all
  1408.        other ASCII code pages.
  1409.  
  1410.        In most ASCII code pages, code point 0x5c is a backslash and code
  1411.        point 0x7e is a tilde.  In code pages 932, 942, and 943, code point
  1412.        0x5c is a Japanese Yen mark and code point 0x7e is an overline.  In
  1413.        code page 949, code point 0x5c is a Korean Won sign.
  1414.  
  1415.        The Java compiler, javac, first converts the Java source program
  1416.        from the local code page to Unicode.  It then processes the character
  1417.        escape sequences, such as \n, by reading the backslash character,
  1418.        then the 'n' character, and then combining them as a character escape
  1419.        to generate a Unicode newline, U+000A, before compiling the program.
  1420.  
  1421.        A problem exists because the backslash character, which is character
  1422.        0x5C in code page 850, is not in the same position in certain DBCS
  1423.        code pages.  For example, in code page 943, character 0x5C is a Yen
  1424.        character.  If the javac compiler converted code point 0x5c in the
  1425.        local code page (a Yen mark) in the Java source program to a Unicode
  1426.        Yen mark (U+00A5), then  no backslash characters would be present,
  1427.        so no character escape sequence processing would be performed.
  1428.  
  1429.        Furthermore, in code pages 932, 943, and 949, there is no backslash
  1430.        anywhere in the local code page, so there is no way for a programmer
  1431.        to generate a Unicode backslash (for use in generating other Unicode
  1432.        characters using Unicode escape sequences) after code page conversion
  1433.        in the javac compiler.
  1434.  
  1435.        To allow programmers to write programs containing a backslash, the
  1436.        Java virtual machine uses modified code page conversion tables for
  1437.        code pages 932, 943, and 949.  These modified tables pass through
  1438.        characters 0x00 to 0x7F in the local code page to U+0000 to U+007F
  1439.        in Unicode.  This means that a programmer can use a Yen mark (0x5c)
  1440.        in code page 932 and 943 and a Won sign (0x5c) in code page 949 to
  1441.        represent a backslash character (U+005C) in Unicode.  An overline
  1442.        (0x7e) in code pages 932 and 943 can be used to represent a tilde
  1443.        (U+007E) in Unicode.
  1444.  
  1445.        These modified codepage conversion tables are also used as the default
  1446.        for the Java Virtual Machine when running in OS/2 code pages 932, 943,
  1447.        and 949.  These are used for PrintStream, PrintWriter, OutputWriter
  1448.        and InputReader classes when no explicit character encoding is
  1449.        specified.
  1450.  
  1451.        Although using 0x5C in the local code page may be printed as a Yen
  1452.        mark in the local code page, if an application programmer really
  1453.        wants a Yen mark, then a Unicode escape should be used to generate
  1454.        a Unicode character U+00A5.  This is needed to make the application
  1455.        portable to other code pages, and also to cause AWT to display the
  1456.        correct character glyph.  Similar considerations apply if the
  1457.        programmer wants a real overline: Unicode character U+203E should
  1458.        be used within the Java program.
  1459.  
  1460.  
  1461.        Code page 942
  1462.  
  1463.        Code page 942 has both tilde and backslashes present, though at
  1464.        different code points from other code pages.  Because this code page
  1465.        does have backslashes and tildes present, even though they are in
  1466.        different positions from other ASCII code pages, the modified code
  1467.        page converters are not used by default.
  1468.  
  1469.        Programs written in this code page can be written using real
  1470.        backslashes and tilde symbols in the local code page.  If programs
  1471.        are written in another ASCII code page where backslash is code point
  1472.        0x5C and they need to be compiled, then in most cases, the proper
  1473.        behavior can be achieved by using one of the following methods:
  1474.  
  1475.          -  Replace the 0x5c character in the Java source program with
  1476.             the backslash character in the local code page (code point
  1477.             0xfe).
  1478.  
  1479.          -  When compiling the Java application or applet, indicate that
  1480.             the file is written in a code page different from the local
  1481.             code page.  For example, if the source code was written in
  1482.             code page 850, use the following command to compile it:
  1483.  
  1484.                 javac  -encoding 850  myprogram.java
  1485.  
  1486.             If the file is written with DBCS characters in code page 942,
  1487.             using 0x5C to represent the backslash, then the -encoding option
  1488.             of javac can be used to force the use of character encoding
  1489.             Cp942c', which passes through characters 0x00 to 0x7F in the
  1490.             local code page to U+0000 to U+007F in Unicode.  For example:
  1491.  
  1492.                 javac  -encoding Cp942c myprogram.java
  1493.  
  1494.        If the source program is written in code page 942 using a real
  1495.        backslash (code point 0xfe) and must be compiled on another system,
  1496.        then use the native2ascii program to convert the Java source
  1497.        program from the local code page to a basic ASCII code page.
  1498.        For example:
  1499.  
  1500.            native2ascii myprogram.java d:\mydest\myprogram.java
  1501.  
  1502.        To convert from a specific code page to a basic ASCII code page:
  1503.  
  1504.            native2ascii -encoding 942 myprogram.java d:\mydest\myprogram.java
  1505.  
  1506.        The file separator character in most ASCII code pages on OS/2 is a
  1507.        backslash.  The file separator character is accessible in a Java
  1508.        program using the system property 'file.separator' or the static
  1509.        constant 'java.io.File.separator'.
  1510.  
  1511.        In code pages 932 and 943, the local file separator character is still
  1512.        code point 0x5C, but this is displayed at the command prompt as a
  1513.        Yen mark.  Similarly, in code page 949, the separator character is
  1514.        displayed as a Won sign.  The default character converter for these
  1515.        code pages converts the file.separator character to a backslash in
  1516.        Unicode, so a Java application sees the file separator as a Unicode
  1517.        backslash (U+005C).
  1518.  
  1519.        In code page 942, the local file separator is also a Yen mark, but this
  1520.        is converted by the Java character converter to a Yen mark in Unicode,
  1521.        so the Java application sees the file separator character as a
  1522.        Unicode Yen mark (U+00A5).
  1523.  
  1524.        Because well-written Java applications always use the file.separator
  1525.        system property so that they can work on UNIX systems where the file
  1526.        separator is a forward slash, this should not be a problem.  Application
  1527.        programmers should be sure not to embed path separators in their
  1528.        programs.
  1529.  
  1530.        For example, do not use:
  1531.  
  1532.        FileInputStream x = new FileInputStream("mydir\myfile.ext");
  1533.  
  1534.        Instead, use:
  1535.  
  1536. FileInputStream x = new FileInputStream("mydir" + File.separator+ "myfile.ext");
  1537.  
  1538.  
  1539.      ______________________________________________________________________
  1540.      4.17. Using Java 1.0.2 for OS/2 After Installing OS/2 Warp Developer's
  1541.            Kit for Java 1.1.6
  1542.  
  1543.        The use of Java 1.0.2 for OS/2 is not supported from an OS/2 Command
  1544.        Prompt or the Desktop after you have installed OS/2 Warp Developer's
  1545.        Kit for Java 1.1.6.
  1546.  
  1547.        You can attempt to run Java 1.0.2 for OS/2 from an OS/2 Command
  1548.        Prompt by setting the LIBPATH, PATH, and CLASSPATH in the session as
  1549.        follows:
  1550.  
  1551.              SET BEGINLIBPATH=x:\JAVAOS2\DLL;
  1552.              SET PATH=x:\JAVAOS2\BIN;%PATH%
  1553.              SET CLASSPATH=x:\JAVAOS2\LIB\JEMPCL10.ZIP;.\.
  1554.  
  1555.        where x: is the drive that contains Java 1.0.2 for OS/2.  This
  1556.        method of running Java 1.0.2 for OS/2 has not been officially
  1557.        tested and is not supported.
  1558.  
  1559.  
  1560.      ________________________________________
  1561.      4.18. Problems with Time in Java Applets
  1562.  
  1563.        If you have problems with time in your Java applets, you might need
  1564.        to set or change the timezone (TZ) variable.  To set the TZ
  1565.        variable, do one of the following:
  1566.  
  1567.          - Go to the General page in the TCP/IP Configuration notebook.
  1568.            Set the timezone field, using the online help provided.
  1569.          - Edit the CONFIG.SYS file and add or change the SET TZ= statement.
  1570.  
  1571.  
  1572.      __________________________________________________
  1573.      4.19. Korean OS/2 Users Need PTF for Updated Fonts
  1574.  
  1575.        If you want to install OS/2 Warp Developer's Kit for Java 1.1.6 on
  1576.        a Korean OS/2 system, you must apply PTF PK0817 to your system first.
  1577.        To obtain the PTF, contact your local IBM OS/2 support representative.
  1578.  
  1579.        Without this PTF applied, Korean characters might not display
  1580.        correctly on your OS/2 system after installing OS/2 Warp Developer's
  1581.        Kit for Java 1.1.6.
  1582.  
  1583.  
  1584.      _________________________________________________________
  1585.      4.20. TrueType Fonts Must Be Installed on Chinese Systems
  1586.  
  1587.        On Simplified or Traditional Chinese systems, ensure that all
  1588.        available OS/2 TrueType fonts have been installed.  To install
  1589.        these fonts, do the following:
  1590.  
  1591.         1. Start the Selective Install program by typing
  1592.  
  1593.                 C:\OS2\INSTALL\INSTALL
  1594.  
  1595.            at an OS/2 command prompt, where C: is the boot drive.
  1596.            A panel titled "System Configuration" is displayed.
  1597.  
  1598.         2. Continue to the OS/2 Setup and Installation panel by
  1599.            clicking on the Next buttons (for Warp 4.0) or the
  1600.            OK button (for Warp Server 4.0 or OS/2 Warp 3).
  1601.  
  1602.         3. On the OS/2 Setup and Installation panel, click on the
  1603.            TrueType Fonts check box.
  1604.  
  1605.         4. Select the More button to the right of this check box.
  1606.  
  1607.         5. Make sure all font check boxes are selected.  Click OK.
  1608.  
  1609.         6. Insert the operating system CD (OS/2 Warp Server 4.0,
  1610.            OS/2 Warp 4.0, OS/2 Warp 3) into the CD drive.
  1611.  
  1612.         7. Click OK on the Source Directory panel.
  1613.  
  1614.        The appropriate fonts are installed.  Restart your system
  1615.        when the font installation is completed.
  1616.  
  1617.  
  1618.  
  1619.      ____________________________________________________________
  1620.      4.21. Conversion between ShiftJIS and Unicode on OS/2 Warp 4
  1621.            Japanese version
  1622.  
  1623.  
  1624.        In the Japanese environment, the following conversion tables for
  1625.        ShiftJIS code (PC code) and Unicode are available:
  1626.  
  1627.        SJIS
  1628.        Cp943c
  1629.        Cp943 = IBM-943
  1630.        Cp942 = IBM-942
  1631.        Cp942c
  1632.  
  1633.        The system default conversion tables are:
  1634.  
  1635.          - Cp943c for code pages 943 and 932
  1636.          - Cp942 for code page 942
  1637.  
  1638.        To use the Cp942 table, set the table name explicitly in a method
  1639.        or as a parameter. These tables do the following conversions:
  1640.  
  1641.        For SBCS characters:
  1642.  
  1643.                                   PC code      Unicode
  1644.        -------------------------------------------------------------------
  1645.        SJIS                       0x00-0x7F    U0000-U007F
  1646.        Cp942c
  1647.        Cp943c
  1648.  
  1649.  
  1650.        Cp942                      0x00-0x5B    U0000-U005B
  1651.        Cp943                Yen sign   0x5c         U00A5        Yen Sign
  1652.                                   0x5D-0x7D    U005D-U007D
  1653.                        Overline   0x7E         U203E        Overline
  1654.                                   0x7F         U007F
  1655.                        Cent sign  0x80         U00A2        Cent sign
  1656.                        Pound sign 0xA0         U00A3        Pound sterling sign
  1657.                        Not sign   0xFD         U00AC        Not sign
  1658.                        Backslash  0xFE         U005C        Backslash
  1659.                        Tilde      0xFF         U007E        Tilde
  1660.  
  1661.  
  1662.        For example, in the Cp943c table, the PC code for the range
  1663.        range 0x00 - 0x7F is converted to Unicode for the range U0000 - U007F
  1664.        straight. In the Cp942 table, the PC code Yen sign (0x5c) is
  1665.        converted to the Unicode Yen sign (U00A5).
  1666.  
  1667.  
  1668.        For DBCS characters:
  1669.  
  1670.        In the Cp943, Cp943c and SJIS table, the PC code is regarded as the
  1671.        new JIS order.
  1672.  
  1673.        In the Cp942 and Cp942c table, the PC code is regarded as the old
  1674.        JIS order.
  1675.  
  1676.  
  1677.        For User-Defined Characters and IBM Extended Characters:
  1678.  
  1679.        In the Cp943 and Cp943c tables, these PC code characters are converted
  1680.        to Unicode.
  1681.  
  1682.        In the SJIS table, these PC code characters are NOT converted
  1683.        to Unicode.
  1684.  
  1685.        In the Cp942 and Cp942c tables, these PC code characters are converted
  1686.        to Unicode.
  1687.  
  1688.  
  1689.      _____________________________________________________________
  1690.      4.22. Installing Japanese FixPak 2 (FX00002) over OS/2 Warp 4
  1691.            Japanese version (without VoiceType) and Java 1.1.6
  1692.  
  1693.        Before you apply the Japanese FixPak 2 after installing OS/2 Warp
  1694.        Developer's Kit for Java 1.1.6 on OS/2 Warp 4 Japanese version
  1695.        (without VoiceType), back up the following files to another
  1696.        directory:
  1697.  
  1698.            \os2\dll\INSTALL.DLL
  1699.            \os2\dll\UCONV.DLL
  1700.            \os2\dll\TRUETYPE.DLL
  1701.  
  1702.        After applying the FixPak, restore them. To restore them:
  1703.  
  1704.        1. Restart the system.
  1705.        2. When the white box with "OS/2" next to it is displayed in the
  1706.           upper-left corner, press Alt+F1.
  1707.        3. From the menu selection, press F2.
  1708.        4. At an OS/2 command prompt, copy these files back into the
  1709.           \os2\dll directory.
  1710.        5. Type: exit
  1711.           The system restarts.
  1712.  
  1713.  
  1714.        Note: OS/2 Warp 4 Japanese version (with VoiceType) includes
  1715.              FixPak 2(FX00002).
  1716.  
  1717.  
  1718. ________________________________________________________________________
  1719.   5. List of OS/2 Base Modules Changed or Added by OS/2 Warp Developer's
  1720.      Kit for Java 1.1.6
  1721.  
  1722.      When you install OS/2 Warp Developer's Kit for Java 1.1.6 on your
  1723.      system, the following OS/2 base files are updated, or they are added
  1724.      if they do not already exist:
  1725.  
  1726.         \os2\dll\libaux.dll
  1727.         \os2\dll\libcm.dll
  1728.         \os2\dll\libcn.dll
  1729.         \os2\dll\libcs.dll
  1730.         \os2\dll\libtk.dll
  1731.         \os2\dll\libuni.dll
  1732.         \os2\dll\locale.dll
  1733.         \os2\dll\uconv.dll
  1734.         \language\codepage\ibm437
  1735.         \language\codepage\ibm813
  1736.         \language\codepage\ibm819
  1737.         \language\codepage\ibm850
  1738.         \language\codepage\ibm852
  1739.         \language\codepage\ibm855
  1740.         \language\codepage\ibm857
  1741.         \language\codepage\ibm860
  1742.         \language\codepage\ibm861
  1743.         \language\codepage\ibm862
  1744.         \language\codepage\ibm863
  1745.         \language\codepage\ibm864
  1746.         \language\codepage\ibm865
  1747.         \language\codepage\ibm866
  1748.         \language\codepage\ibm869
  1749.         \language\codepage\ibm874
  1750.         \language\codepage\ibm878
  1751.         \language\codepage\ibm912
  1752.         \language\codepage\ibm913
  1753.         \language\codepage\ibm914
  1754.         \language\codepage\ibm915
  1755.         \language\codepage\ibm916
  1756.         \language\codepage\ibm920
  1757.         \language\codepage\ibm921
  1758.         \language\codepage\ibm922
  1759.         \language\codepage\ibm942
  1760.         \language\codepage\ibm943
  1761.         \language\codepage\ibm949
  1762.         \language\codepage\ibm950
  1763.         \language\codepage\ibm1004
  1764.         \language\codepage\ibm1089
  1765.         \language\codepage\ibm1200
  1766.         \language\codepage\ibm1207
  1767.         \language\codepage\ibm1208
  1768.         \language\codepage\ibm1250
  1769.         \language\codepage\ibm1251
  1770.         \language\codepage\ibm1252
  1771.         \language\codepage\ibm1253
  1772.         \language\codepage\ibm1254
  1773.         \language\codepage\ibm1255
  1774.         \language\codepage\ibm1256
  1775.         \language\codepage\ibm1257
  1776.         \language\codepage\ibm1275
  1777.         \language\codepage\ibm1280
  1778.         \language\codepage\ibm1281
  1779.         \language\codepage\ibm1282
  1780.         \language\codepage\ibm1283
  1781.         \language\codepage\ibm1381
  1782.         \language\codepage\ibm1386
  1783.         \language\codepage\os2ugl
  1784.         \language\codepage\ucstbl.lst
  1785.  
  1786.      The following file is replaced on OS/2 Warp 4 systems and on
  1787.      OS/2 Warp Server or OS/2 Warp 3 systems at a FixPak 30 service
  1788.      level or higher:
  1789.  
  1790.         \os2\dll\truetype.dll
  1791.  
  1792.      The following file contains Monotype Corporation's Times New Roman
  1793.      MT 30 TrueType Unicode Font and is installed on OS/2 Warp 4
  1794.      systems and on OS/2 Warp Server or OS/2 Warp 3 systems at a FixPak 30
  1795.      or higher level.  If you have previously installed a font with the
  1796.      same file name, this file replaces it:
  1797.  
  1798.         \os2\dll\tnrmt30.ttf
  1799.  
  1800.  
  1801.   ________________________________________________________________________
  1802.   6. TRADEMARKS
  1803.  
  1804.  
  1805.      The following terms are trademarks of the IBM Corporation in the
  1806.      United States or other countries or both:
  1807.  
  1808.          IBM
  1809.          OS/2
  1810.  
  1811.      Java and HotJava are trademarks of Sun Microsystems, Inc. in the U.S.
  1812.      and other countries.  The Java technology is owned and exclusively
  1813.      licensed by Sun Microsystems, Inc.
  1814.  
  1815.      Netscape and Netscape Navigator are trademarks of Netscape
  1816.      Communications Corporation.
  1817.  
  1818.      PartitionMagic is a trademark of PowerQuest Corporation.
  1819.  
  1820.      Intel and Pentium are registered trademarks of Intel Corporation
  1821.      in the United States and other countries.
  1822.  
  1823.      Other company, product, and service names may be trademarks or
  1824.      service marks of others.
  1825.  
  1826.      THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF
  1827.      ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER
  1828.      EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE
  1829.      IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE
  1830.      AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN
  1831.      THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS
  1832.      NO LICENSES TO ANY PATENTS OR COPYRIGHTS.
  1833.  
  1834.      (C) Copyright IBM Corporation 1998, All rights reserved.
  1835.  
  1836.   ________________________________________________________________________
  1837.  
  1838.   END-OF-README-FILE
  1839.   ________________________________________________________________________
  1840.