home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 February / CHIPinte022000.iso / office51 / os2 / misc / java / jre117 / JAVAINUF.EXE / readme.br < prev    next >
Encoding:
Text File  |  1998-11-20  |  64.0 KB  |  1,461 lines
  1.   ________________________________________________________________________
  2.  
  3.   IBM OS/2 Warp Developer Kit, Java(TM) Edition, Version 1.1.7 
  4.   Installation README
  5.   ________________________________________________________________________
  6.  
  7.   IBM OS/2 Warp Developer Kit, Java(TM) Edition, Version 1.1.7 (Developer 
  8.   Kit) is based on Sun Microsystems' Java 1.1.7A maintenance level.   
  9.   
  10.   The Developer Kit provides the Sun Microsystems, Inc. Java environment for
  11.   the following products:
  12.  
  13.     OS/2 Warp 4 
  14.     OS/2 Warp Server Version 4 
  15.     OS/2 Warp Server Advanced Version 4 
  16.     OS/2 Warp Server Advanced Version 4 SMP Feature 
  17.     WorkSpace On-Demand clients and servers
  18.     OS/2 Warp 3 
  19.     OS/2 Warp Connect 
  20.  
  21.     Note:  Simplified Chinese is not supported on OS/2 Warp 3.
  22.  
  23.   References in this README to OS/2 Warp 4 refer to the OS/2 Warp 4 client 
  24.   operating system and the WorkSpace On-Demand client.  OS/2 Warp Server is 
  25.   used to refer to all of the OS/2 Warp Server operating systems and the 
  26.   WorkSpace On-Demand server.  References to OS/2 Warp 3 refer to OS/2 Warp 
  27.   Version 3 and OS/2 Warp Connect. 
  28.  
  29.   This README guides you through installation of the Developer Kit 
  30.   and provides information about known problems and temporary fixes for 
  31.   them.  References to objects specific to this product are referred to as, 
  32.   Java 1.1.7 objects.
  33.   ________________________________________________________________________
  34.   CONTENTS
  35.  
  36.      1.0.  BEFORE YOU INSTALL
  37.      1.1.  Making a Copy of Your Current CONFIG.SYS File
  38.      1.2.  Disk Space Requirements
  39.      1.3.  Hardware Requirements
  40.      1.4.  FixPaks   
  41.      1.5.  Installing FixPaks after the Developer Kit
  42.      1.6.  HPFS and FAT Partition Considerations
  43.      1.7.  Coexistence with Previous Versions of Java
  44.      1.8.  Replacing Previous Versions of Java 1.1.x
  45.      1.9.  Backing Up Base OS/2 Files
  46.      1.10. Netscape 2.02 Refresh and Java 1.1.x
  47.      1.11. Running Netscape 4.04 While Installing the Developer Kit    
  48.    
  49.      2.0.  INSTALLING THE DEVELOPER KIT
  50.      2.1.  Installing the Developer Kit Through the Graphical 
  51.            User Interface (GUI)
  52.      2.1.1.  Desktop Method
  53.      2.1.2.  OS/2 Command Prompt Method
  54.      2.1.3.  Components Not Selectable During Installation
  55.      2.1.4.  Recovering from a Failed Installation
  56.      2.1.4.1.  Cannot Remove the Install Object 
  57.      2.1.5.  Unable to Create Feature Install Object on OS/2 
  58.              Warp Server and OS/2 Warp 3 Systems
  59.      2.2.  Unattended (CID) Installation Method
  60.      2.2.1.  Modifying the CID Response File
  61.      2.2.2.  Starting the Unattended Installation
  62.      2.3.  TME-Architected CID Installation Method
  63.      2.4.  Installing the Developer Kit on WorkSpace 
  64.            On-Demand     
  65.      2.4.1.  Installing the Developer Kit on a WorkSpace 
  66.              On-Demand Server 
  67.      2.4.2.  Installing the Developer Kit for a WorkSpace 
  68.              On-Demand Client 
  69.      2.4.2.1.  Requirements for Installation on a WorkSpace 
  70.                On-Demand Client
  71.      2.4.2.2.  Modifying the CID.CMD and WSOD.RSP Files
  72.      2.4.2.3.  Multiple Releases of Workspace On-Demand on the 
  73.                Same Server     
  74.      2.4.2.4.  Installing Additional Developer Kit Components on the 
  75.                Workspace On-Demand Client
  76.      2.5.  NetView DM/2 (NVDM/2) Installation Considerations 
  77.      2.5.1.  Put Static Command in NVDM/2 Profile
  78.      2.6.  Remote IPL Installation 
  79.      2.6.1.  Creating Response Files
  80.      2.6.2.  Modifying the JAVA117.RSP File
  81.      2.6.3.  Updating Files for Feature Install
  82.      2.6.4.  Starting the Remote IPL Installation
  83.      2.6.5.  Running the Java Samples from a Remote IPL Client
  84.      2.6.5.1.  Issuing a Trust on WorkSpace On-Demand
  85.      2.6.6.  Upgrading Java 1.1.6 to the Developer Kit in the 
  86.              Remote IPL Environment
  87.      
  88.      3.0.  UNINSTALLING THE DEVELOPER KIT
  89.      3.1.  Desktop Method
  90.      3.2.  OS/2 Command Prompt Method
  91.      3.3.  Uninstalling from WorkSpace On-Demand     
  92.      3.4.  Performing an Unattended Uninstallation
  93.      3.5.  Restoring Base OS/2 Files   
  94.  
  95.      4.0.  AFTER YOU INSTALL
  96.      4.1.  Additional Sources of Information
  97.      4.2.  Installing Additional Components
  98.      4.3.  JDBC-ODBC Bridge Not Provided
  99.      4.4.  AWT TextField and TextArea Considerations
  100.      4.5.  Modifying Font Properties Files Not Supported
  101.      4.6.  Time Problems in Java Applets 
  102.      4.7.  LIBPATH Changes That Could Affect Your System
  103.      4.8.  Verification Exception
  104.  
  105.      5.0.  DOUBLE-BYTE CHARACTER SET (DBCS) CONSIDERATIONS
  106.      5.1.  Installation Panel Text Missing or Too Long in DBCS Countries
  107.      5.2.  Korean OS/2 Users Need PTF for Updated Fonts
  108.      5.3.  TrueType Fonts Must Be Installed on Chinese Systems
  109.      5.4.  Controlling Arabic Number Character Display 
  110.      5.5.  Installing Japanese FixPak 2 (FX00002) over OS/2 Warp 4
  111.            Japanese version (without VoiceType) and the Developer Kit
  112.      5.6.  Japanese Environment Settings on OS/2 Warp 4 Japanese Version
  113.      5.7.  Required Fonts on OS/2 Warp Japanese Version
  114.      5.8.  Modifying the CONFIG.SYS File for Japanese on Warp 3 Connect
  115.      
  116.      6.0.  LIST OF OS/2 BASE MODULES CHANGED OR ADDED BY THE DEVELOPER KIT
  117.      
  118.      7.0.  TRADEMARKS
  119.  
  120.  
  121.   1.0.  BEFORE YOU INSTALL
  122.   ________________________________________________________________________
  123.  
  124.   Note:  In this document, the term partition refers to any
  125.          physical or logical drive.
  126.        
  127.          The Runtime package must be installed to use any component other 
  128.          than the Toolkit Documentation.  You cannot install the Toolkit, 
  129.          Samples, or ICAT Debugger unless you are also installing the 
  130.          Runtime component or have previously installed the Runtime 
  131.          component and rebooted the system.
  132.  
  133.     1.1.  Making a Copy of Your Current CONFIG.SYS File
  134.     ______________________________________________________________________
  135.  
  136.     Before installing the Developer Kit, make a copy of your current 
  137.     CONFIG.SYS file.  This ensures that you can return to your original 
  138.     environment if problems occur during installation.     
  139.  
  140.     1.2.  Disk Space Requirements
  141.     ______________________________________________________________________
  142.  
  143.     IBM OS/2 Warp Developer Kit, Java(TM) Edition consists of the 
  144.     following components: 
  145.  
  146.       Runtime, including Internationalization Support         11.0 MB
  147.       Times New Roman MT 30 Unicode Font                     13.0 MB
  148.       Toolkit                              3.0 MB
  149.       Toolkit Documentation                                   8.0 MB
  150.       Samples                              3.0 MB
  151.       ICAT Debugger for OS/2 Java                            14.0 MB
  152.       _________________________________________________      ________
  153.                                    Total installed size      52.0 MB
  154.  
  155.     You should ensure that sufficient disk space is available 
  156.     before installing.       
  157.                     
  158.     1.3.  Hardware Requirements
  159.     ______________________________________________________________________
  160.  
  161.     o  A minimum of 32 MB of random access memory (RAM) provides the best 
  162.        results when running the Developer Kit applications and applets.  
  163.        
  164.     o  IBM strongly recommends using an Intel(R) Pentium (or comparable) 
  165.        processor or higher for all OS/2 systems. 
  166.  
  167.     o  The Developer Kit specification requires 256-color mode (or greater).  
  168.        The Developer Kit does not support Java applications and applets 
  169.        using the Abstract Window Toolkit (AWT) in 16-color mode.
  170.       
  171.     1.4.  FixPaks   
  172.     ______________________________________________________________________        
  173.  
  174.     The following considerations apply:       
  175.  
  176.     To use the Developer Kit on OS/2 Warp 3: 
  177.       o  Single-Byte Character Set Languages (SBCS)     FixPak 32 or higher    
  178.       o  For Japanese, Traditional Chinese, or Korean   FixPak WX03006  
  179.          
  180.     To use the Unicode Font support on OS/2 Warp Server and OS/2 Warp 3: 
  181.       o  Single-Byte Character Set Languages (SBCS)     FixPak 30 or higher
  182.       o  For Japanese, Traditional Chinese, or Korean   FixPak WX03006
  183.        
  184.     To use the Eurocurrency Symbol (the Euro) in Java applications 
  185.     and applets:
  186.       o  OS/2 Warp 4                                    FixPak 6 or higher
  187.       o  OS/2 Warp Server or OS/2 Warp 3                FixPak 35 or higher  
  188.      
  189.     Note:  The display and code conversion of the Euro is supported on 
  190.            the code pages containing the Euro. 
  191.            
  192.            If you want to input the Euro, the SBCS version of OS/2 is 
  193.            required. The U.S. International keyboard, UX103, supports 
  194.            input of the Euro, but a standard English keyboard does not.  
  195.            In all cases, if you do not have a keyboard that supports 
  196.            input of the Eurocurrency symbol, you are able to display it, 
  197.            but you are not able to input it.  
  198.      
  199.     For information about downloading a particular FixPak, visit the IBM 
  200.     FixPak web site at: 
  201.   
  202.       http://ps.software.ibm.com/pbin-usa-ps/getobj.pl?/pdocs-usa
  203.            /otherservices.html
  204.  
  205.     1.5.  Installing FixPaks after the Developer Kit
  206.     ______________________________________________________________________
  207.              
  208.       o  Installing from Diskettes:       
  209.          The Developer Kit replaces base operating system modules 
  210.          as part of installation.  When you install a FixPak to your 
  211.          OS/2 system after installing the Developer Kit, you are 
  212.          normally prompted if you attempt to replace a module that 
  213.          is newer than the one on the FixPak.  
  214.  
  215.          However, if you install the FixPak by booting from the FixPak 
  216.          diskettes when this condition exists, you are not prompted.  
  217.          This could result in one or more modules being regressed. 
  218.          Either do not install the FixPak by booting from the diskettes, 
  219.          or back up the base OS/2 modules before installing the FixPak 
  220.          and replace them after installing the FixPak.
  221.  
  222.       o  On OS/2 Warp 4:
  223.          If you want to install a FixPak prior to FixPak 6, make sure 
  224.          that the following files remain as they are before the FixPak 
  225.          is installed: 
  226.  
  227.            -  CLIFI.EXE
  228.            -  INSTALL.DLL
  229.            -  LIBUNI.DLL
  230.            -  UCONV.DLL
  231.  
  232.          You can do this by using SERVICE.EXE to install the FixPak and
  233.          select not to update the files during installation of the FixPak.
  234.  
  235.          If you use another method, do one of the following:
  236.  
  237.            -  Save the files, and then replace them after installing the 
  238.               FixPak. 
  239.          
  240.            -  Reinstall Feature Install and the Developer Kit after 
  241.               installing the FixPak.        
  242.         
  243.       o  On OS/2 Warp Server or OS/2 Warp 3:
  244.          If you install FixPak 30 or greater (or DBCS equivalent), and 
  245.          you want to use the Unicode Font Support, you must reinstall 
  246.          the Runtime and Times New Roman MT 30 Unicode Font Components.
  247.  
  248.     1.6.  HPFS and FAT Partition Considerations
  249.     ______________________________________________________________________
  250.  
  251.     The Runtime and ICAT Debugger components can be installed on a FAT 
  252.     partition.  However, for better performance, install them on
  253.     an HPFS partition, which supports long file names.  The Toolkit,
  254.     Toolkit Documentation, and Samples components must be installed
  255.     on an HPFS partition.  The Internationalization Support portion
  256.     of the Runtime component and the Times New Roman MT 30 Unicode 
  257.     Font component are installed on the boot partition.
  258.  
  259.     If you use the Guided Install path, all components must reside
  260.     on the same partition.  Use Advanced Install to select specific
  261.     drives and directories for the different components.
  262.  
  263.     Note:  If you have only one hard disk with a single FAT
  264.            partition, you have these options:
  265.  
  266.            o  Leave your system as it is and install only the Runtime
  267.               component and, optionally, the ICAT Debugger component.
  268.  
  269.            o  Format the FAT partition for HPFS and reinstall all 
  270.               software.
  271.      
  272.            o  Purchase a disk partitioning program, such as 
  273.               PartitionMagic.  With sufficient space, a disk 
  274.               partitioning program reduces the size of the current 
  275.               partition (drive C) and creates a new partition (logical 
  276.               drive D), which can be formatted for HPFS.
  277.     
  278.     1.7.  Coexistence with Previous Versions of Java
  279.     ______________________________________________________________________
  280.  
  281.     IBM OS/2 Warp Developer Kit, Java(TM) Edition, Version 1.1.7 replaces 
  282.     all previous versions of Java 1.1.x for OS/2 Warp.
  283.       
  284.     1.8.  Replacing Previous Versions of Java 1.1.x 
  285.     ______________________________________________________________________
  286.     
  287.     If you do not uninstall the previous version, the installation program 
  288.     will replace it with the Developer Kit. If a previous version of a 
  289.     Java component was installed and you have not selected to reinstall 
  290.     that component, the installation program displays a window warning you 
  291.     that this component will be downlevel and then lets you choose to 
  292.     upgrade the component.
  293.        
  294.     1.9.  Backing Up Base OS/2 Files 
  295.     ______________________________________________________________________
  296.  
  297.     The Developer Kit updates base operating system modules as part of 
  298.     the installation of the Runtime component. Uninstalling the Developer 
  299.     Kit does not restore the original versions of these files.  
  300.  
  301.     In most cases, you do not need to restore the previous versions of 
  302.     these files.  If you want the ability to restore these files, you 
  303.     must make copies of them before you install.  Be sure to record the 
  304.     location of the copied files so that you can restore them if necessary.
  305.  
  306.     A complete list of new and changed base modules is included in the 
  307.     section "List of OS/2 Base Modules Changed or Added by the Developer 
  308.     Kit" of this README.
  309.  
  310.     1.10.  Netscape 2.02 Refresh and Java 1.1.x
  311.     ______________________________________________________________________
  312.  
  313.     If you have the latest Netscape 2.02 refresh and it is using Java 
  314.     1.1.x, and you uninstall Java 1.1.x, Netscape prevents you from 
  315.     installing the Developer Kit because it looks for the previous 
  316.     Java 1.1.x.
  317.  
  318.     To recover, you must remove all references to Java 1.1.x from the 
  319.     CONFIG.SYS file and reboot.        
  320.  
  321.     1.11.  Running Netscape 4.04 While Installing the Developer Kit    
  322.     ______________________________________________________________________
  323.  
  324.     You will not be able to install the Developer Kit if you are running
  325.     Netscape 4.04 while executing the INSTALL command.  You must shut down
  326.     Netscape 4.04 and then execute the INSTALL command.
  327.  
  328.   2.0.  INSTALLING THE DEVELOPER KIT
  329.   ________________________________________________________________________
  330.   
  331.   Note:  The Runtime package must be installed to use any component other 
  332.          than the Toolkit Documentation.  You cannot install the Toolkit, 
  333.          Samples, or ICAT Debugger unless you are also installing the 
  334.          Runtime component or have previously installed the Runtime 
  335.          component and rebooted the system. 
  336.     
  337.     2.1.  Installing the Developer Kit Through 
  338.           the Graphical User Interface (GUI)
  339.     ________________________________________________________________________
  340.  
  341.     You can install the Developer Kit using either the desktop method or 
  342.     the OS/2 command prompt method.  
  343.                         
  344.       2.1.1.  Desktop Method
  345.       ____________________________________________________________________
  346.         
  347.       To install using the INSTALL.EXE object, follow these steps:
  348.         1. Open the OS/2 System folder.
  349.         2. Open the Drives object.
  350.         3. Open the drive where the Java files were extracted.
  351.         4. Open the folder where the Java files were extracted.
  352.         5. Double-click the INSTALL.EXE object to start the 
  353.            installation program.
  354.  
  355.       The INSTALL.EXE command brings up a GUI with eleven buttons 
  356.       specifying the languages you can install the program in. Click the 
  357.       language your prefer and the installation program will lead you 
  358.       through the installation steps.  A Developer Kit for OS/2 folder is 
  359.       created in the Programs folder on OS/2 Warp 4 and on the Desktop in 
  360.       OS/2 Warp Server and OS/2 Warp 3.
  361.  
  362.       After the installation is complete, if you want to clean up the 
  363.       directory in which the Java files were extracted, select the 
  364.       DELINST.CMD object to remove the Java files and subdirectories 
  365.       from the directory where they were extracted.  Files and 
  366.       subdirectories not extracted from the Developer Kit are not 
  367.       erased.
  368.  
  369.       2.1.2.  OS/2 Command Prompt Method
  370.       ____________________________________________________________________
  371.  
  372.       To start installation, make sure that you are in the directory 
  373.       where the Developer Kit files were extracted.  At the OS/2 command 
  374.       prompt, type: 
  375.  
  376.         INSTALL
  377.        
  378.       The install command brings up a GUI with eleven buttons specifying 
  379.       the languages you can install the program in. Click the language you 
  380.       prefer and the installation program leads you through the installation 
  381.       steps.  
  382.  
  383.       A Developer Kit for OS/2 folder is created in the Programs folder 
  384.       on OS/2 Warp 4 and on the Desktop in OS/2 Warp Server and OS/2 
  385.       Warp 3.
  386.  
  387.       Optionally, if you want to remove the Java files and subdirectories 
  388.       from the directory where they were extracted, make sure that you are 
  389.       in the directory where the Developer Kit files were extracted.  At 
  390.       an OS/2 command prompt, enter: 
  391.  
  392.         DELINST
  393.  
  394.       Files and subdirectories not extracted from the Developer Kit 
  395.       are not erased.
  396.  
  397.       2.1.3.  Components Not Selectable During Installation
  398.       ____________________________________________________________________
  399.  
  400.       If you are using the GUI to install the Developer Kit and components
  401.       are not selectable that you believe you downloaded and extracted, you 
  402.       might not have downloaded and extracted the ZIP file containing 
  403.       the component you need.  You need to return to the Software Choice 
  404.       catalog page and download the correct self-extracting ZIP file.  
  405.        
  406.       2.1.4.  Recovering from a Failed Installation
  407.       ____________________________________________________________________
  408.  
  409.       If your installation of the Developer Kit fails, check for and 
  410.       delete any remaining installation objects.  If you do not delete 
  411.       these installation objects, future installations could fail with 
  412.       a message stating that one or more components could not be installed 
  413.       because the object is read-only or in use by another process.  
  414.  
  415.       The icon for the installation object shows a blue box with a red 
  416.       ribbon and is located on the Desktop for a CID install.  For an 
  417.       attended installation, the object is in the x:\os2\install folder.  
  418.       To delete the object, click the object with the right mouse button 
  419.       and click Delete on the menu. (Where x is the boot drive.)
  420.  
  421.       Alternately, go to the directory containing the object, and delete 
  422.       the entire directory tree.  The directory is named either "Install 
  423.       object" or "Java 1.1 for OS!2" depending on when the installation 
  424.       failed.
  425.  
  426.       After deleting the installation object, shut down and restart the
  427.       system.
  428.       
  429.       2.1.4.1.  Cannot Remove the Install Object
  430.       __________________________________________________________________
  431.  
  432.       If after following the instructions in section 2.1.4., the install 
  433.       object was not removed, do the following:
  434.  
  435.         1.  Go to your OS/2 command prompt.
  436.         2.  Change to the boot drive, and then change to the os2\install
  437.             directory.         
  438.         3.  Remove the Java 1.1. for OS!2 directory and all subdirectories.
  439.         4.  Reboot.
  440.         
  441.       2.1.5.  Unable to Create Feature Install Object 
  442.               on OS/2 Warp Server and OS/2 Warp 3
  443.       ____________________________________________________________________
  444.  
  445.       If your installation of the Developer Kit fails on an OS/2 Warp 
  446.       Server or OS/2 Warp 3 and you receive a message that the program was 
  447.       unable to locate or create a Feature Install object, or that it 
  448.       could not find the response file, shut down and restart the system 
  449.       and run the installation program again.  The fix for the problem is 
  450.       included in FixPaks 33 and higher.  
  451.  
  452.     2.2.  Unattended (CID) Installation Method
  453.     ______________________________________________________________________
  454.  
  455.     Note: Feature Install version 1.2 or higher is required for CID 
  456.           installations.  
  457.  
  458.     Unattended or CID installations of the Developer Kit are handled by 
  459.     CLIFI, the command-line interface to Feature Install, and can take 15 
  460.     to 20 minutes or more.  After the installation program finishes, the 
  461.     system must be restarted to complete the installation.  
  462.  
  463.     CLIFI requires two response files: the Developer Kit response file 
  464.     (JAVA117.RSP) and a secondary response file where users can override 
  465.     the default selections.  The CID.RSP file is included in the 
  466.     installation package as an example of the customized response file; 
  467.     this is the only file that needs to be modified for unattended 
  468.     installations.  
  469.  
  470.       2.2.1.  Modifying the CID Response File
  471.       ____________________________________________________________________
  472.  
  473.       Where appropriate, the CID.RSP response file contains variables that 
  474.       allow you to select which components to install and the target drive 
  475.       and directory for each component.
  476.  
  477.         The component names are:
  478.  
  479.           Runtime   - Java Runtime
  480.           Unicode   - Internationalization Support, part of Java Runtime
  481.                       Environment
  482.           Unifont   - Times New Roman MT 30 Unicode Font    
  483.           NSFiles   - Netscape Bridge to run Developer Kit applets
  484.           TTengine  - Updated TrueType engine, required for the Unicode Font
  485.           Toolkit   - Toolkit
  486.           TlktDoc   - Toolkit Documentation
  487.           Samples   - Samples
  488.           Debugger  - OS/2 ICAT Debugger for Java
  489.          
  490.       If you want to install the Japanese Toolkit Documentation, add  
  491.       java11.NLVDest=jp to the CID.RSP file. 
  492.        
  493.       The CID.RSP file is originally set to install all components.
  494.       Modify it to install the components you want to install.  Be 
  495.       sure that you have downloaded and extracted all the files you 
  496.       need. In the CID.RSP file, set "selection=1" for each component 
  497.       you want to install, and set "selection=0" for each component 
  498.       you do not want to install. 
  499.  
  500.       Note:  There is a configuration component associated with each 
  501.              installable component.  The configuragation selection 
  502.              variable for each component must always be set to the 
  503.              same value as the selection variable for the component.  
  504.              For example, if you set toolkit.selection=0, you must 
  505.              also set toolkitconfig.selection=0.
  506.  
  507.       The Runtime package is always installed in the \JAVA11
  508.       directory on the target drive and is a prerequisite for the
  509.       Toolkit, Samples, and Debugger components.
  510.  
  511.       The Internationalization Support portion of the Runtime
  512.       component and the Times New Roman MT 30 Unicode Font
  513.       component are always installed on the boot drive. If the
  514.       Times New Roman MT 30 Unicode Font component is installed,
  515.       the TrueType component is required.
  516.  
  517.       The target drive and directory for the other components can
  518.       be specified by setting the drive and path variables to the
  519.       desired values. For example, to install the Debugger
  520.       component in the F:\JAVADEBUG directory:
  521.  
  522.         debugger.selection=1
  523.         debuggerconfig.selection=1
  524.         debugger.dbgdrv=F:
  525.         debugger.dbgpath=\javadebug
  526.  
  527.       If a previous version of Java exists in the specified 
  528.       directory on the target drive, the installation program 
  529.       replaces it.  If a previous version of a Java component 
  530.       was installed and you have not selected to reinstall that 
  531.       component, the installation program displays a window that 
  532.       warns you that this component will be downlevel and lets 
  533.       you choose to upgrade the component.
  534.  
  535.       To suppress this confirmation window, along with any others
  536.       encountered during installation, set the java11.continue 
  537.       variable to UNATTENDED:
  538.  
  539.         java11.continue=UNATTENDED
  540.  
  541.       2.2.2.  Starting the Unattended Installation
  542.       ____________________________________________________________________
  543.  
  544.       The CID.CMD file contains a sample CLIFI command for a CID 
  545.       installation.  The installation process has been modified to include 
  546.       a multilingual installation; therefore, you must specify your language 
  547.       variable in the CID.RSP files. The language variables are as follows:
  548.  
  549.         br = Portuguese, Brazilian Version
  550.         fr = French
  551.         de = German
  552.         it = Italian
  553.         jp = Japanese
  554.         ko = Korean
  555.         cn = Simplified Chinese
  556.         tw = Traditional Chinese
  557.         es = Spanish
  558.         sv = Swedish 
  559.         en = English 
  560.  
  561.       The CLIFI command can also be entered as a single-line command at an 
  562.       OS/2 command prompt as shown below:        
  563.  
  564.         clifi /a:c /r2:cid.rsp /r:\xx\java117.rsp /b:c: /s:d:\tmp\xx
  565.         /l1:ciderr.log /l2:cidhist.log
  566.  
  567.         where:
  568.            xx             Specifies the preferred language variable
  569.            /r             Specifies the fully qualified location of the
  570.                           Feature Install response file
  571.            /b             Specifies the boot drive
  572.            /s             Specifies the fully qualified location of the
  573.                           extracted Developer Kit files
  574.            /l1 and /l2    Specifies the fully qualified locations of the
  575.                           optional log files.  Refer to these files, in
  576.                           addition to the \os2\install\wpinstal.log file
  577.                           on the boot drive, if problems occur during
  578.                           installation.      
  579.  
  580.     2.3.  TME-Architected CID Installation Method
  581.     ______________________________________________________________________
  582.  
  583.     A JAVA117.ADF file is provided for use with Tivoli Management
  584.     Environment (TME) architected CID installation products, such as
  585.     NetFinity Server and the Tivoli TME-10 Software Distribution
  586.     Agent.  See the documentation pertaining to the CID installation
  587.     product being used for instructions regarding the use of .ADF
  588.     files.
  589.  
  590.     When doing a TME-architected CID installation, you must add the
  591.     following line to your CID.RSP response file:
  592.  
  593.       java11.CID=TME
  594.  
  595.     Modifying the CID response file is described in the section 
  596.     "Modifying the CID Response File" of this README.
  597.  
  598.     You also need to modify your JAVADF.CMD file to identify the 
  599.     preferred language variable:
  600.    
  601.       'clifi /a:c /r:'src'\xx\java117.rsp /r2:'src'\cid.rsp /b:c: 
  602.       /s:'src'\xx /l1:'log1' /l2:'log2
  603.             
  604.       xx is the preferred language variable.   
  605.  
  606.     2.4.  Installing the Developer Kit on WorkSpace On-Demand
  607.     ______________________________________________________________________
  608.  
  609.     WorkSpace On-Demand is a client-server system that uses network
  610.     computers (clients) that are designed to be remotely loaded from
  611.     a network server. The WorkSpace On-Demand client runs Java
  612.     applications, Netscape Navigator, and the Personal Communications
  613.     Entry Level host access application, as well as other applications;
  614.     it also supports native execution of DOS, Windows 3.1, and OS/2
  615.     applications. The WorkSpace On-Demand server runs on an OS/2 Warp
  616.     Server and provides enhanced server support to manage the clients.
  617.  
  618.     The WorkSpace On-Demand product includes Java 1.1.1 for OS/2 Warp.  
  619.     You can install the Developer Kit on WorkSpace On-Demand servers and 
  620.     clients to upgrade from Java 1.1.1.  
  621.  
  622.       2.4.1.  Installing the Developer Kit on a WorkSpace On-Demand Server
  623.       ____________________________________________________________________
  624.  
  625.       To install the Developer Kit on a WorkSpace On-Demand server, use 
  626.       the GUI.  See the section "Installing the Developer Kit 
  627.       through the Graphical User Interface (GUI)" of this README for 
  628.       instructions on using the GUI to install.  
  629.  
  630.       2.4.2.  Installing the Developer Kit on a WorkSpace On-Demand Client
  631.       ____________________________________________________________________
  632.  
  633.       Installation of the Developer Kit on a WorkSpace On-Demand Client is 
  634.       done as an unattended (CID) installation.  You can use the 
  635.       instructions in the section "Unattended (CID) Installation Method" 
  636.       of this README and use the CID.CMD and WSOD.RSP files that are 
  637.       included in the Developer Kit installation package.
  638.  
  639.         2.4.2.1.  Requirements for Installation 
  640.                   on a WorkSpace On-Demand Client
  641.         __________________________________________________________________
  642.  
  643.         Before you can install the Developer Kit for a WorkSpace On-Demand 
  644.         client, Java 1.1.x must already be installed.  If the Times New 
  645.         Roman MT 30 Unicode Font (the Unifont component) is selected for 
  646.         installation, it must have been previously installed with WorkSpace 
  647.         On-Demand.  If this support is not present, the installation is 
  648.         completed without transferring files.  In this case, the 
  649.         wpinstal.log shows that installation completed successfully but it 
  650.         does not show that any files were transferred.
  651.  
  652.         2.4.2.2.  Modifying the CID.CMD and WSOD.RSP Files
  653.         __________________________________________________________________
  654.  
  655.         Before starting the installation, modify the CID.CMD and WSOD.RSP
  656.         files as follows:
  657.  
  658.           1. In the CID.CMD file, change /r2:cid.rsp to /r2:wsod.rsp.
  659.  
  660.           2. As described in section "Starting the Unattended Installation"
  661.              of this README:
  662.              
  663.              o  Replace /s:d:\tmp\xx in the CID.CMD file with the drive
  664.                 and directory where you unzipped the install package. 
  665.          
  666.                 xx is the preferred language variable. 
  667.  
  668.              o  Be sure that /b:c in the CID.CMD file points to the client 
  669.                 boot drive.
  670.  
  671.           3. Verify that the selections in the WSOD.RSP files are
  672.              appropriate for what you want to install.  By default the
  673.              Java Runtime Environment and Unicode Font are selected; all
  674.              other components are deselected.  Be sure to download and
  675.              extract all of the files you need.
  676.  
  677.           2.4.2.3.  Multiple Releases of Workspace 
  678.                     On-Demand on the Same Server
  679.           __________________________________________________________________          
  680.  
  681.           If you have multiple releases of Workspace On-Demand on the same
  682.           server, you will need to comment out the java11.cid=WSOD line by 
  683.           inserting a # character (see example below) and add the line 
  684.           java11.TARGET indicating the WorkSpace On-Demand client image you
  685.           want to upgrade.
  686.  
  687.             #java11.cid=WSOD
  688.             java11.TARGET=x:ibmlan\rp\bb10.en
  689.             
  690.             x is the directory path you choose
  691.           
  692.           2.4.2.4.  Installing Additional Developer 
  693.                     Kit Components on the WorkSpace On-Demand Client
  694.           __________________________________________________________________
  695.  
  696.           If you want to install components other than the Java Runtime
  697.           Environment and Unicode font for the WorkSpace On-Demand client,
  698.           you can select these components in the WSOD.RSP file.  If you
  699.           install the ICAT Debugger, a WorkSpace On-Demand administrator
  700.           must make the following additions to the CONFIG.SYS files for
  701.           the clients:
  702.  
  703.             Add  Z:\java11\icatjava\dll; to the LIBPATH statement.
  704.             Add  Z:\java11\icatjava\bin; to the SET PATH statement.
  705.             Add  Z:\java11\icatjava\help; to the SET DPATH and SET HELP
  706.                  statements.
  707.             Add  Z:\java11\icatjava\daemon\javaprob.zip; to the
  708.                  SET CLASSPATH statement.
  709.             Add  RUN=Z:\mptn\bin\ifconfig.exe lo 127.0.0.1 up
  710.  
  711.             Substitute the drive and directory where the ICAT debugger is
  712.             installed for Z:\java11.
  713.         
  714.     2.5.  NetView DM/2 (NVDM/2) Installation Considerations
  715.     ______________________________________________________________________
  716.  
  717.     A NVDM/2 CID installation requires creating a profile and then 
  718.     building and cataloging a change file.  The NVDM/2 profile 
  719.     allows you to specify only one response file; however, the Developer 
  720.     Kit unattended installation requires two response files.  In addition, 
  721.     variable and argument handling in NVDM/2 is different than that used 
  722.     in Feature Install, which is used to install the Developer Kit.
  723.  
  724.     Use one of the following methods to install the Developer Kit using NVDM/2.
  725.  
  726.       2.5.1.  Put Static Command in NVDM/2 Profile
  727.       ____________________________________________________________________
  728.  
  729.       In the NVDM/2 profile, specify all the CLIFI options in the
  730.       PARMS variable.  The parameters must be on a single line and
  731.       enclosed in double quotation marks:
  732.  
  733.         Program=c:\os2\install\clifi.exe
  734.         Parms="/a:c /r2:cid.rsp /r:\xx\java117.rsp /b:c: /s:d:\tmp\xx
  735.         /l1:ciderr.log /l2:cidhist.log"
  736.  
  737.         xx is the preferred language variable.  
  738.  
  739.       This method requires you to modify the profile whenever the
  740.       source directory or log file names are changed.  Alternatively, 
  741.       you could replace these values with workstation-specific variable 
  742.       values, as shown below:
  743.  
  744.         Program=c:\os2\install\clifi.exe
  745.         Parms="/a:c /r2:$(ResponseFile) /r:$(SourceDir)\xx\java117.rsp
  746.           /b:c: /s:$(SourceDir\xx) /l1:$(LogFile1) /l2:$(LogFile2)"
  747.         ResponseFile=$(WorkstatName).rsp
  748.           SourceDir=d:\tmp
  749.           LogFile1=$(WorkstatName).log
  750.           LogFile2=$(WorkstatName).lg2
  751.  
  752.       This second method requires a separate response file for each
  753.       workstation and requires WorkstatName to be set appropriately.
  754.        
  755.     2.6.  Remote IPL Installation 
  756.     ______________________________________________________________________
  757.  
  758.     A remote IPL installation requires creating two response
  759.     files and setting up the appropriate directories and files
  760.     on the remote IPL server.
  761.  
  762.     Follow these steps for each client to be installed:
  763.  
  764.       1. Place the extracted Developer Kit installation files on the 
  765.          remote IPL server.
  766.       2. Run the GENFIRPL command.  (See the section "Creating Response 
  767.          Files" for information.)
  768.       3. Run the CLIFI command for one remote IPL client.  (See
  769.          the section "Starting the Remote IPL Installation" 
  770.          for information.)
  771.       4. Modify the client FIT file (See the sections "Updating Files 
  772.          for Feature Install" and "Running the Java Samples from a Remote 
  773.          IPL Client.")
  774.  
  775.     Note: You cannot uninstall the Developer Kit in the remote IPL 
  776.           environment. 
  777.         
  778.       2.6.1.  Creating Response Files 
  779.       __________________________________________________________________
  780.  
  781.       After placing the extracted Developer Kit installation files on 
  782.       the remote IPL server, the GENFIRPL command is used to generate two 
  783.       response files: FILES.RSP for the remote IPL server and JAVA117.RSP 
  784.       for the remote IPL client.  The following is a sample GENFIRPL 
  785.       command.  The command should be entered on a single line.        
  786.  
  787.         genfirpl /m:c:\javacode\xx  /r:c:\ibmlan\rpl
  788.           /u:c:\ibmlan\rpluser  /f:c:\javacode\xx\java117.rsp
  789.           /c:client_name  /b:x:
  790.            
  791.          where:
  792.       
  793.            xx   Specifies the preferred language variable
  794.            /m   Specifies the directory containing the Developer Kit 
  795.                 installation files on the remote IPL server
  796.            /r   Specifies the RPL directory
  797.            /u   Specifies the RPLUSER directory
  798.            /f   Specifies the fully qualified name of the response
  799.                 file for the remote IPL client
  800.            /c   Specifies the name of the remote IPL client
  801.            /b   Specifies the remote IPL client's boot drive
  802.            /nf  Suppresses Java file transfer. Use this flag when 
  803.                 installing additional remote IPL clients, after the 
  804.                 first one, to prevent the Developer Kit files from 
  805.                 being installed again for each new client
  806.  
  807.       The remote IPL client must not be running when the GENFIRPL
  808.       command is issued.  One GENFIRPL command must be done for
  809.       each remote IPL client, specifying the appropriate client name
  810.       and boot drive.
  811.  
  812.       2.6.2.  Modifying the JAVA117.RSP File
  813.       __________________________________________________________________
  814.  
  815.       The JAVA117.RSP file defaults to installing all the components of 
  816.       Developer Kit.  You can modify this response file to explicitly set 
  817.       which components you want to install.  Be sure to download and 
  818.       extract all of the files you need before you start the installation.  
  819.  
  820.       You need to use a text editor that handles lines greater than 255 
  821.       characters, such as TEDIT, to prevent truncation of the long lines 
  822.       in this file.  Because this file is very large, modifications can be 
  823.       time consuming and error-prone.  Make a backup copy of JAVA117.RSP 
  824.       before modifying it to prevent loss of data.
  825.  
  826.       The component names that can be selected are:
  827.  
  828.         Runtime   - Java Runtime
  829.         Unicode   - Internationalization Support, part of Java Runtime
  830.                     Environment
  831.         Unifont   - Times New Roman MT 30 Unicode Font    
  832.         NSFiles   - Netscape Bridge to run Developer Kit applets
  833.         TTengine  - Updated TrueType engine, required for the Unicode Font
  834.         Toolkit   - Toolkit
  835.         TlktDoc   - Toolkit Documentation
  836.         Samples   - Samples
  837.         Debugger  - OS/2 ICAT Debugger for Java
  838.  
  839.       Use the selection variables to select the components to install.
  840.       The selection variables for the Unifont and TTengine components
  841.       must be set to the same value.  For example, to install only the
  842.       Runtime and Unicode Font components, set the following variables,
  843.       which are scattered throughout the JAVA117.RSP file, as shown:
  844.  
  845.         runtime.selection=1
  846.         runtimeconfig.selection=1
  847.         Unicode.selection=1
  848.         Unicodeconfig.selection=1
  849.         NSfiles.selection=1
  850.         toolkit.selection=0
  851.         toolkitconfig.selection=0
  852.         tlktdoc.selection=0
  853.         tlktdocconfig.selection=0
  854.         samples.selection=0
  855.         samplesconfig.selection=0
  856.         unifont.selection=1
  857.         unifontconfig.selection=1
  858.         TTengine.selection=1
  859.         TTengineconfig.selection=1
  860.  
  861.       Note:  There is now a configuration component associated with
  862.              each installable component.  The configuration selection 
  863.              variable for each component must always be set to the 
  864.              same value as the selection variable for the component.  
  865.              For example, if you set toolkit.selection=0, you must 
  866.              also set toolkitconfig.selection=0.
  867.  
  868.       2.6.3.  Updating Files for Feature Install
  869.       _________________________________________________________________
  870.  
  871.       The client_name.FIT file for each remote IPL client must be
  872.       modified to include the following, which must be entered on a
  873.       single line:
  874.  
  875.         x:\os2\install\install.inv \\server_name\WRKFILES\client_name
  876.         \os2\install\install.inv
  877.  
  878.       Substitute the name of the remote IPL server and remote IPL client
  879.       for server_name and client_name.
  880.        
  881.       2.6.4.  Starting the Remote IPL Installation
  882.       __________________________________________________________________
  883.  
  884.       Remote IPL installations are handled by CLIFI, the Feature Install
  885.       installation program, and can take 15 to 20 minutes or more.
  886.       After logging on to the remote IPL server as an administrator, run
  887.       the CLIFI command, using the response file created for the
  888.       remote IPL server, FILES.RSP:
  889.  
  890.         clifi /a:i  /r:c:\javacode\files.rsp
  891.  
  892.         /r specifies the fully qualified name of the remote IPL 
  893.         server's response file.
  894.  
  895.       It is necessary to reboot the remote IPL Server after running
  896.       clifi if file transfer has not been suppressed.
  897.  
  898.       Run the CLIFI command on each remote IPL client after you run 
  899.       the GENFIRPL command for that client.      
  900.        
  901.         clifi /a:i  /r:z:\xx\java117.rsp
  902.  
  903.         where:  
  904.                xx is the preferred language variable.  
  905.                
  906.                /r is the fully qualified name of the remote IPL 
  907.                   client's response file, as specified on the 
  908.                   GENFICMD command.
  909.  
  910.       2.6.5.  Running the Java Samples from a Remote IPL Client
  911.       ________________________________________________________________
  912.  
  913.       The remote IPL server administrator must add the following lines 
  914.       to the RPL\FITS\client_name.FIT file to give the remote IPL client 
  915.       the ability to run the samples provided in the Samples component:
  916.  
  917.         x:\JAVA11\WEBLOGS \\server_name\WRKFILES\client_name\JAVA11\WEBLOGS
  918.         x:\JAVA11\HOTJAVA \\server_name\WRKFILES\client_name\JAVA11\HOTJAVA
  919.  
  920.       Substitute the names of the remote IPL server and the remote IPL 
  921.       client for server_name and client_name.
  922.  
  923.       The remote IPL clients can compile the sample code if the 
  924.       samples are placed in a directory to which the remote IPL client 
  925.       has write access.
  926.  
  927.         2.6.5.1  Issuing a Trust on WorkSpace On-Demand
  928.         ______________________________________________________________
  929.  
  930.         If you are issuing a trust to connect to a web server, the 
  931.         IDENTITYDB.OBJ file needs to be read/write. Add the following 
  932.         to the FIT file to make the connection:
  933.  
  934.           x:\JAVA11\WEBLOGS \\server_name\WRKFILES\client_name\JAVA11\WEBLOGS
  935.           x:\JAVA11\HOTJAVA \\server_name\WRKFILES\client_name\JAVA11\HOTJAVA 
  936.           Z:\JAVA11\IDENTITYDB.OBJ  \\server\WRKF\client\JAVA11\IDENTITYDB.OBJ
  937.  
  938.         This could also be entered in the default FIT file as part of 
  939.         the installation of Java 1.1.x for WorkSpace On-Demand when running 
  940.         the WSOD.CMD.
  941.  
  942.       2.6.6.  Upgrading Java 1.1.6 to the 
  943.               Developer Kit in the Remote IPL Environment
  944.       __________________________________________________________________
  945.  
  946.       To upgrade Java 1.1.6 to the Developer Kit in the 
  947.       remote IPL environment:
  948.  
  949.         1. Place the extracted Developer Kit installation files on the 
  950.            remote IPL server.
  951.         2. Run the GENFIRPL command.  (See "Creating Response Files" 
  952.            in this README for more information.)
  953.         3. Run the CLIFI command for one remote IPL client.  
  954.            (See "Starting the Remote IPL Installation in this README 
  955.            for more information.)
  956.              
  957.       This process updates the Java files on the remote IPL server.
  958.       Because all remote IPL clients access the same files on the server,
  959.       the upgrade is done for all clients.  The client configuration
  960.       information is present from the Java 1.1.6 installation.    
  961.      
  962.   3.0.  UNINSTALLING THE DEVELOPER KIT
  963.   ______________________________________________________________________
  964.    
  965.   You can uninstall the Developer Kit using the following methods:
  966.  
  967.     3.1.  Desktop Method
  968.     ____________________________________________________________________
  969.  
  970.     To uninstall using the Remove the Developer Kit object, follow these
  971.     steps:
  972.  
  973.       1. Open the OS/2 System folder.
  974.       2. Open the System Setup folder.
  975.       3. If you are uninstalling from OS/2 Warp 4, open the Install/Remove 
  976.          folder.
  977.       4. Open the Uninstall Features folder.
  978.       5. Select the Remove the Developer Kit for OS/2 object to start the
  979.          uninstall program.
  980.        
  981.     To restore base OS/2 files that were saved before installing
  982.     the Developer Kit, see "Restoring Base OS/2 Files" in this README. 
  983.  
  984.     3.2.  OS/2 Command Prompt Method
  985.     ______________________________________________________________________
  986.  
  987.     To start uninstalling, make sure that you are either in the directory 
  988.     where the Developer Kit files were extracted or in the \JAVA11\UNINSTAL
  989.     directory.  At an OS/2 command prompt, enter: 
  990.  
  991.       UNINSTAL
  992.  
  993.     The uninstall program leads you through the uninstallation process.
  994.     Only files and directories created by the installation process are
  995.     removed.  For instance, the HOTJAVA directory created by running
  996.     the Applet Viewer is not removed during uninstallation.
  997.  
  998.     To restore base OS/2 files that were saved before installing
  999.     the Developer Kit, see "Restoring Base OS/2 Files" below. 
  1000.  
  1001.     3.3.  Uninstalling from WorkSpace On-Demand
  1002.     ______________________________________________________________________
  1003.  
  1004.     Support for uninstalling the Developer Kit requires access to an 
  1005.     inventory object (Java 1.1.7) in the Installed Features directory 
  1006.     (\os2\install\installed features).  If you install the Developer 
  1007.     Kit both for the WorkSpace On-Demand client and the WorkSpace 
  1008.     On-Demand server, the Java 1.1.7 inventory object is damaged or 
  1009.     replaced.
  1010.  
  1011.     To remove the Developer Kit from the client space, reinstall the 
  1012.     WorkSpace On-Demand version of Java 1.1.x.  This installation will 
  1013.     replace the Developer Kit.
  1014.  
  1015.     To remove the Developer Kit from the server, delete the \java11 
  1016.     directory structure.  You can delete the directory structure from 
  1017.     the Drives folder in the OS/2 System folder.  In addition, if you 
  1018.     installed the Unicode Font, delete the file \os2\dll\tnrmt30.ttf 
  1019.     that is on the boot drive.
  1020.  
  1021.     3.4.  Performing an Unattended Uninstallation
  1022.     ______________________________________________________________________
  1023.  
  1024.     To uninstall the Developer Kit, enter the following single-line 
  1025.     command at an OS/2 command prompt:
  1026.  
  1027.       clifi /a:u /f:"<WP_INSTALLED>" /o:INV_JAVA11 /set:Selection=ALL  
  1028.  
  1029.     3.5.  Restoring Base OS/2 Files
  1030.     _______________________________
  1031.  
  1032.     In most cases, the base OS/2 files replaced during the installation 
  1033.     of the Developer Kit can be used after you uninstall the Developer Kit.  
  1034.     If you made copies of the original files, as described in the section  
  1035.     "Coexistence with Previous Versions of Java 1.1.x" of this README, 
  1036.     you can optionally choose to restore them.  
  1037.  
  1038.     Some of the files you backed up are locked during normal system
  1039.     operation and cannot be overwritten with the backup copy while
  1040.     the system is running.  To replace these files, follow these
  1041.     steps:
  1042.  
  1043.       1. Restart the computer.
  1044.       2. When the white block and the name OS/2 are displayed in the top
  1045.          left hand-corner of the display, press Alt+F1.
  1046.       3. Select the option to boot to an OS/2 command line.
  1047.       4. Restore the files with the ones you saved before
  1048.          installing the Developer Kit. 
  1049.       5. At an OS/2 command prompt, type:
  1050.  
  1051.            EXIT
  1052.  
  1053.            and press Enter.  The system now restarts.
  1054.        
  1055.     Note:  If you installed the Developer Kit over Java 1.1.x and you 
  1056.            later uninstall the Developer Kit, the CONFIG.SYS file is 
  1057.            returned to the Java 1.1.x level.
  1058.       
  1059.            If you install the Toolkit component of the Developer Kit 
  1060.            and later uninstall the component, the SET LIB= and SET 
  1061.            INCLUDE= statements in the CONFIG.SYS might still contain 
  1062.            references to the directory where the Toolkit component 
  1063.            was installed.
  1064.  
  1065.   4.0.  AFTER YOU INSTALL
  1066.   ______________________________________________________________________
  1067.  
  1068.   The following sections provide additional information you might need 
  1069.   after you install the Developer Kit. 
  1070.           
  1071.     4.1.  Additional Sources of Information
  1072.     ____________________________________________________________________
  1073.  
  1074.     The objects in the following list are displayed in the Developer Kit
  1075.     OS/2 folder only if you are running OS/2 Warp 4.  If you are running 
  1076.     OS/2 Warp Server or OS/2 Warp 3, you can access the associated
  1077.     documents at the locations shown.  
  1078.  
  1079.       o  IBM Center for Java Technology:
  1080.          http://ncc.hursley.ibm.com/javainfo/hurindex.html
  1081.  
  1082.       o  Running Java:
  1083.          x:\JAVA11\runtime.htm
  1084.  
  1085.       o  Configure Applet Viewer:
  1086.          x:\JAVA11\cnfgappl.htm
  1087.  
  1088.       o  Java Documentation:
  1089.          http://www.javasoft.com/doc.html
  1090.  
  1091.       o  Java Developer's Kit for OS/2:
  1092.          x:\JAVA11\index.html
  1093.  
  1094.       o  Java Toolkit:
  1095.          x:\JAVA11\toolkit.html
  1096.  
  1097.       o  Java API:
  1098.          x:\JAVA11\docs\api\API_users_guide.html
  1099.  
  1100.       o  ICAT Debugger for OS/2 Java:
  1101.          x:\JAVA11\ICATJAVA\help\icatjava.htm
  1102.  
  1103.       x is the partition where you installed Java.
  1104.  
  1105.     If you installed the Toolkit, Toolkit Documentation, or ICAT 
  1106.     Debugger for OS/2 Java components in different directories than the 
  1107.     Runtime component, specify the appropriate directory for these four 
  1108.     objects.  The links to the Runtime documentation, the ICAT Debugger 
  1109.     for OS/2 Java, and README in the Toolkit documentation do not work 
  1110.     if the components are in different places.
  1111.  
  1112.     4.2.  Installing Additional Components
  1113.     ____________________________________________________________________
  1114.  
  1115.     After the initial installation of the Developer Kit you can install 
  1116.     additional components by re-running the installation procedure.  This 
  1117.     requires that you keep all of the extracted files on your system or 
  1118.     that you keep the original ZIP files and extract the files again when 
  1119.     needed.     
  1120.  
  1121.     4.3.  Java Database Connectivity (JDBC)-Open Database Connectivity 
  1122.           (ODBC) Bridge Not Provided
  1123.     ______________________________________________________________________
  1124.  
  1125.     The Developer Kit provides JDBC, a database access interface that 
  1126.     provides access to a wide range of relational databases.  However, not 
  1127.     all relational databases provide a JDBC driver.  To access databases 
  1128.     that support the ODBC standard, a JDBC-ODBC Bridge is needed.  The 
  1129.     JDBC-ODBC Bridge allows ODBC drivers to be used as JDBC drivers by 
  1130.     using native code to interface with ODBC.  The Developer Kit does not 
  1131.     provide a JDBC-ODBC bridge.
  1132.  
  1133.     4.4.  AWT TextField and TextArea Considerations
  1134.     ______________________________________________________________________
  1135.  
  1136.     The AWT TextField and TextArea controls do not support characters
  1137.     outside of the current code page.  Users running on US English
  1138.     systems can switch to code page 850 (the multilingual code page, 
  1139.     which supports the Western European languages) to see additional 
  1140.     language characters in these controls.
  1141.  
  1142.     4.5.  Modifying Font Properties Files Not Supported
  1143.     ______________________________________________________________________
  1144.  
  1145.     Modifying the font properties files provided with the 
  1146.     Developer Kit is not supported.  
  1147.      
  1148.     4.6.  Time Problems in Java Applets
  1149.     ______________________________________________________________________
  1150.  
  1151.     If you have problems with time in your Java applets, you 
  1152.     might need to set or change the timezone (TZ) variable.  
  1153.     To set the TZ variable, do one of the following:
  1154.  
  1155.       o  Go to the General page in the TCP/IP Configuration notebook.
  1156.          Set the timezone field, using the online help provided.
  1157.       
  1158.       o  Edit the CONFIG.SYS file and add or change the SET TZ= statement.    
  1159.  
  1160.     4.7.  LIBPATH Changes That Could Affect Your System
  1161.     ______________________________________________________________________
  1162.  
  1163.     When the installation program determines that the OS/2 base DLL
  1164.     modules that need to be replaced exist in a directory other than
  1165.     x:\OS2\DLL, the position of x:\OS2\DLL is changed in the LIBPATH
  1166.     to ensure that the correct version of the modules are loaded.
  1167.  
  1168.     The IBM Developer's Toolkit for OS/2 Warp includes OS/2 base 
  1169.     DLL modules in a different directory.  This change does not affect 
  1170.     the Toolkit, but (depending on which DLL module is first in the 
  1171.     LIBPATH) could affect other products that include OS/2 base DLL 
  1172.     modules.    
  1173.     
  1174.     4.8.  Verification Exception
  1175.     _______________________________________________________________________
  1176.  
  1177.     If you are running an application that is obfuscated and receive the error 
  1178.     message:
  1179.  
  1180.       java.lang.verifyerror exception
  1181.  
  1182.     there are two options:
  1183.  
  1184.       o  Inform your application vendor. Your vendor may have an updated
  1185.          version that will run with the Developer Kit (version 1.1.7).  
  1186.       o  Run the Developer Kit using the -noverify option from either your
  1187.          OS/2 command prompt or browser.  
  1188.  
  1189.   5.0.  DOUBLE-BYTE CHARACTER SET (DBCS) CONSIDERATIONS
  1190.   _______________________________________________________________________
  1191.  
  1192.     The following sections describe known DBCS considerations.
  1193.  
  1194.     5.1.  Installation Panel Text Missing or Too Long in DBCS Countries
  1195.     ____________________________________________________________________
  1196.  
  1197.     When installing the Developer Kit on DBCS versions of OS/2, DBCS 
  1198.     characters might not be displayed on the installation panels or the 
  1199.     lines could exceed the right border of the display window, even 
  1200.     when the window is maximized.  
  1201.  
  1202.     To correct these problems, exit the installation program, open 
  1203.     the Netscape Navigator or Netscape Communicator for OS/2 object, 
  1204.     and select the Options menu item.  Open the General Preferences 
  1205.     notebook and select the Fonts tab.  Choose the proper encoding 
  1206.     for your country and then set the proportional and fixed fonts 
  1207.     to MINCHO.  Press OK to save the changes.  When you start the 
  1208.     installation of the Developer Kit again, the text should be 
  1209.     displayed correctly.  
  1210.  
  1211.     5.2.  Korean OS/2 Users Need PTF for Updated Fonts
  1212.     ____________________________________________________________________
  1213.  
  1214.     If you want to install the Developer Kit on a Korean OS/2 system, 
  1215.     you must first apply PTF PK0817 to your system.  To obtain the PTF, 
  1216.     contact your local IBM OS/2 support representative.  
  1217.  
  1218.     Without this PTF applied, Korean characters might not display 
  1219.     correctly on your OS/2 system after installing Developer Kit.
  1220.  
  1221.     5.3.  TrueType Fonts Must Be Installed on Chinese Systems
  1222.     ____________________________________________________________________
  1223.  
  1224.     On Simplified or Traditional Chinese systems, ensure that all
  1225.     available OS/2 TrueType fonts have been installed.  To install
  1226.     these fonts, do the following:
  1227.  
  1228.       1. At an OS/2 command prompt and where C: is the boot drive, 
  1229.          start the Selective Install program by typing:
  1230.  
  1231.            C:\OS2\INSTALL\INSTALL
  1232.          
  1233.          A panel titled "System Configuration" is displayed.
  1234.  
  1235.       2. Continue to the OS/2 Setup and Installation panel by
  1236.          clicking on the Next buttons (for Warp 4.0) or the
  1237.          OK button (for Warp Server 4.0 or OS/2 Warp 3).
  1238.  
  1239.       3. On the OS/2 Setup and Installation panel, select the
  1240.          TrueType Fonts check box.
  1241.  
  1242.       4. Click the More button to the right of this check box.
  1243.  
  1244.       5. Make sure all font check boxes are selected.  Click OK.
  1245.  
  1246.       6. Insert the operating system CD (OS/2 Warp Server 4.0,
  1247.          OS/2 Warp 4.0, or OS/2 Warp 3) into the CD drive.
  1248.  
  1249.       7. Click OK on the Source Directory panel.
  1250.  
  1251.       The appropriate fonts are installed.  Restart your system
  1252.       when the font installation is completed. 
  1253.     
  1254.     5.4.  Controlling Arabic Number Character Display
  1255.     ____________________________________________________________________
  1256.  
  1257.     Users in some countries could unexpectedly see Arabic number 
  1258.     characters appear.  Some country-specific versions of OS/2 map the
  1259.     characters x'00B0' through x'00B9' to the Arabic numbers zero (0) 
  1260.     through nine (9).  To see the desired characters, change the 
  1261.     Bidirectional Attributes in CONFIG.SYS or use the Language page in 
  1262.     the Properties Notebook (Settings Notebook in OS/2 Warp Server or 
  1263.     OS/2 Warp 3) of the object to obtain the desired effect.
  1264.  
  1265.     5.5.  Installing Japanese FixPak 2 (FX00002) over OS/2 Warp 4
  1266.           Japanese version (without VoiceType) and the Developer Kit
  1267.     ____________________________________________________________________
  1268.  
  1269.     Note:  If you plan to install Japanese FixPak 2 (FX00002) over 
  1270.            OS/2 Warp 4 Japanese version (without VoiceType), you 
  1271.            should do it before installing the Developer Kit.  
  1272.            Otherwise, OS/2 might not reboot.  
  1273.     
  1274.     Before you apply the Japanese FixPak 2 (after installing the 
  1275.     Developer Kit) on OS/2 Warp 4 Japanese version (without VoiceType), 
  1276.     back up the following files to another directory: 
  1277.  
  1278.            \os2\dll\INSTALL.DLL
  1279.            \os2\dll\UCONV.DLL
  1280.            \os2\dll\TRUETYPE.DLL
  1281.  
  1282.     After applying the FixPak, restore them. To restore them:
  1283.  
  1284.       1. Restart the system.
  1285.       2. When the white box with "OS/2" next to it is displayed in the
  1286.          upper-left corner, press Alt+F1.
  1287.       3. From the menu selection, press F2.
  1288.       4. At an OS/2 command prompt, copy these files back into the
  1289.          \os2\dll directory.
  1290.       5. Type: exit
  1291.          The system restarts.
  1292.  
  1293.      Note: OS/2 Warp 4 Japanese version (with VoiceType) includes
  1294.            FixPak 2(FX00002).
  1295.  
  1296.     5.6.  Japanese Environment Settings on OS/2 Warp 4 Japanese Version
  1297.     ____________________________________________________________________
  1298.  
  1299.     Use the following Japanese environment settings for OS/2 Warp 4
  1300.     Japanese version:
  1301.  
  1302.       o  Codepage                932
  1303.       o  ShiftJIS code           New JIS
  1304.  
  1305.     5.7.  Required Fonts on OS/2 Warp Japanese Version
  1306.     ____________________________________________________________________
  1307.  
  1308.     To run the Developer Kit, the following fonts are required on your 
  1309.     system: 
  1310.  
  1311.       Name          Style
  1312.       ------------------------------------------
  1313.       GOTHIC        Normal
  1314.       GOTHIC        HeiseiKakuGothic-W5-H-90-TT
  1315.       MINCHO        HeiseiMincho-W3-H-90-TT
  1316.  
  1317.     You can check them in the Font Palette, which is in the System 
  1318.     Setup folder in the OS/2 System folder.
  1319.  
  1320.     GOTHIC Normal font is included in GOTHIC system Japanese font.
  1321.  
  1322.     GOTHIC HeiseiKakuGothic-W5-H-90-TT is IBM HeiseiKakuGothic
  1323.     TrueType font with New JIS order.
  1324.  
  1325.     MINCHO HeiseiMincho-W3-H-90-TT is IBM HeiseiMincho TrueType font
  1326.     with New JIS order.
  1327.  
  1328.     These fonts can be installed through the Selective Install program
  1329.     object, which is in:
  1330.  
  1331.       o  The Install/Remove folder in the System Setup folder on OS/2
  1332.           Warp 4 systems
  1333.  
  1334.       o  The System Setup folder on OS/2 Warp Server and OS/2 Warp 3 
  1335.          systems.
  1336.  
  1337.     5.8.  Modifying the CONFIG.SYS File for Japanese on Warp 3 Connect 
  1338.     ____________________________________________________________________
  1339.  
  1340.     Verify that the language variable for Japanese is ja_jp. If it is 
  1341.     not set correctly, then the Developer Kit will not be able to find 
  1342.     the Japanese locale.    
  1343.  
  1344.   6.0  LIST OF OS/2 BASE MODULES CHANGED OR ADDED BY THE DEVELOPER KIT
  1345.   ______________________________________________________________________
  1346.  
  1347.   When you install the Developer Kit on your system, the following OS/2 
  1348.   base files are updated, or they are added if they do not already exist: 
  1349.  
  1350.         \os2\dll\libaux.dll
  1351.         \os2\dll\libcm.dll
  1352.         \os2\dll\libcn.dll
  1353.         \os2\dll\libcs.dll
  1354.         \os2\dll\libtk.dll
  1355.         \os2\dll\libuni.dll
  1356.         \os2\dll\locale.dll
  1357.         \os2\dll\uconv.dll
  1358.         \language\codepage\ibm437
  1359.         \language\codepage\ibm813
  1360.         \language\codepage\ibm819
  1361.         \language\codepage\ibm850
  1362.         \language\codepage\ibm852
  1363.         \language\codepage\ibm855
  1364.         \language\codepage\ibm857
  1365.         \language\codepage\ibm860
  1366.         \language\codepage\ibm861
  1367.         \language\codepage\ibm862
  1368.         \language\codepage\ibm863
  1369.         \language\codepage\ibm864
  1370.         \language\codepage\ibm865
  1371.         \language\codepage\ibm866
  1372.         \language\codepage\ibm869
  1373.         \language\codepage\ibm874
  1374.         \language\codepage\ibm878
  1375.         \language\codepage\ibm912
  1376.         \language\codepage\ibm913
  1377.         \language\codepage\ibm914
  1378.         \language\codepage\ibm915
  1379.         \language\codepage\ibm916
  1380.         \language\codepage\ibm920
  1381.         \language\codepage\ibm921
  1382.         \language\codepage\ibm922
  1383.         \language\codepage\ibm942
  1384.         \language\codepage\ibm943
  1385.         \language\codepage\ibm949
  1386.         \language\codepage\ibm950
  1387.         \language\codepage\ibm1004
  1388.         \language\codepage\ibm1089
  1389.         \language\codepage\ibm1200
  1390.         \language\codepage\ibm1207
  1391.         \language\codepage\ibm1208
  1392.         \language\codepage\ibm1250
  1393.         \language\codepage\ibm1251
  1394.         \language\codepage\ibm1252
  1395.         \language\codepage\ibm1253
  1396.         \language\codepage\ibm1254
  1397.         \language\codepage\ibm1255
  1398.         \language\codepage\ibm1256
  1399.         \language\codepage\ibm1257
  1400.         \language\codepage\ibm1275
  1401.         \language\codepage\ibm1280
  1402.         \language\codepage\ibm1281
  1403.         \language\codepage\ibm1282
  1404.         \language\codepage\ibm1283
  1405.         \language\codepage\ibm1381
  1406.         \language\codepage\ibm1386
  1407.         \language\codepage\os2ugl
  1408.         \language\codepage\ucstbl.lst
  1409.  
  1410.   The following file is replaced on OS/2 Warp 4 and on OS/2 Warp 
  1411.   Server or OS/2 Warp 3 at a FixPak 30 service level or higher:
  1412.  
  1413.         \os2\dll\truetype.dll
  1414.  
  1415.   The following file contains Monotype Corporation's Times New Roman
  1416.   MT 30 TrueType Unicode Font and is installed on OS/2 Warp 4 and on 
  1417.   OS/2 Warp Server or OS/2 Warp 3 at a FixPak 30 or higher level.  
  1418.   If you have previously installed a font with the same file name, this 
  1419.   file replaces it:
  1420.  
  1421.         \os2\dll\tnrmt30.ttf
  1422.   
  1423.   7.0  TRADEMARKS
  1424.   ______________________________________________________________________
  1425.  
  1426.   The following terms are trademarks of International Business Machines 
  1427.   Corporation in the U.S., or other countries, or both:
  1428.  
  1429.          IBM
  1430.          OS/2
  1431.  
  1432.   Java and HotJava are trademarks of Sun Microsystems, Inc. in the U.S.
  1433.   and other countries.  The Java technology is owned and exclusively
  1434.   licensed by Sun Microsystems, Inc.
  1435.  
  1436.   Netscape and Netscape Navigator are trademarks of Netscape
  1437.   Communications Corporation.
  1438.  
  1439.   PartitionMagic is a trademark of PowerQuest Corporation.
  1440.  
  1441.   Intel and Pentium are registered trademarks of Intel Corporation
  1442.   in the United States and other countries.
  1443.  
  1444.   Other company, product, and service names may be trademarks or
  1445.   service marks of others.
  1446.  
  1447.   THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF
  1448.   ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER
  1449.   EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE
  1450.   IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE
  1451.   AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN
  1452.   THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS
  1453.   NO LICENSES TO ANY PATENTS OR COPYRIGHTS.
  1454.  
  1455.   (C) Copyright IBM Corporation 1998, All rights reserved.
  1456.  
  1457.   ________________________________________________________________________
  1458.  
  1459.   END-OF-README-FILE
  1460.   ________________________________________________________________________
  1461.