home *** CD-ROM | disk | FTP | other *** search
/ DOS/V Power Report 1997 August / VPR9708B.ISO / IBM_OS / JAVA102 / JAVAOS2.ZIP / read.me < prev    next >
Text File  |  1997-03-04  |  16KB  |  387 lines
  1.      __________________________________________________________________
  2.      Installing Java** 1.0.2 for OS/2*:  READ.ME
  3.  
  4.        (c) Copyright International Business Machines Corporation, 1997.
  5.            All Rights Reserved.
  6.  
  7.      __________________________________________________________________
  8.      CONTENTS
  9.  
  10.        1. Before You Install
  11.        1.1. Saving a Previous Version of Java
  12.        1.2. Replacing a Previous Version of Java
  13.        1.3. Java Components
  14.        1.4. HPFS and FAT Partition Considerations
  15.        2. Installation
  16.        2.1. Icon Installation Method
  17.        2.2. Command Prompt Installation Method
  18.        2.3. Unattended (CID) Installation Method
  19.        2.3.1. Modifying the Response File
  20.        2.3.2. Starting the Unattended Installation
  21.        2.4. TME-Architected CID Installation Method
  22.        3. After You Install
  23.        3.1. Additional Sources of Information
  24.        3.2. Disabling the Just In Time (JIT) Compiler
  25.        3.2.1. Using Netscape Navigator**
  26.        3.2.2. Setting an Environment Variable
  27.        3.2.3. Specifying a Property on the JAVA invocation
  28.        3.2.4. Renaming the DLL
  29.        3.3.  Considerations for Files on CD-ROM
  30.        3.4.  Viewing HTML or Java Objects in Warp 3 and Warp Connect
  31.        3.5.  Fixing Incorrect Icons in OS/2 Warp 4.0
  32.        4. Trademarks
  33.  
  34.      _________________________________________________________________
  35.      1.  Before You Install
  36.  
  37.          Note:  In this document, the term partition refers to any
  38.          physical or logical drive.
  39.  
  40.          _______________________________________
  41.          1.1.  Saving a Previous Version of Java
  42.  
  43.          If you previously installed Java and wish to keep a copy of
  44.          your previous Java environment, you can install the new
  45.          Java on a different partition by specifying a different
  46.          target drive during installation.  If you have only one
  47.          partition, copy the contents of the \JAVAOS2 directory into
  48.          another directory.  When you take either of these steps,
  49.          the install program does not delete your previous Java
  50.          environment and updates the CONFIG.SYS file to ensure that
  51.          the new version is accessed.
  52.  
  53.          _________________________________________
  54.          1.2. Replacing a Previous Version of Java
  55.  
  56.          If you previously installed Java, the install program
  57.          searches the directories defined in the CLASSPATH statement
  58.          of your CONFIG.SYS file for the Java executable files.
  59.          Based on the CLASSPATH statement and the age of the
  60.          executable files, the install program recommends a
  61.          partition for Java replacement.  Java is always installed
  62.          into a \JAVAOS2 directory on the selected partition.  When
  63.          the install program prompts you to replace an existing
  64.          file, select:
  65.  
  66.                  Yes to all
  67.  
  68.          _____________________
  69.          1.3.  Java Components
  70.  
  71.          The Java for OS/2 product consists of four components:
  72.  
  73.             Runtime
  74.             Toolkit
  75.             Samples
  76.             DBCS Support
  77.  
  78.          The Runtime component is required to execute Java
  79.          applications and applets.  To use the other components,
  80.          you must install the Runtime component.
  81.  
  82.          The Toolkit component contains tools and documentation for
  83.          developing your own Java applications and applets.
  84.  
  85.          The Samples component contains sample source code and
  86.          byte code compiled class files.  The Samples component
  87.          can be installed and run without installing the Toolkit
  88.          component, but you cannot modify and compile the sample
  89.          source code without the Toolkit component.
  90.  
  91.          The Double Byte Character Set (DBCS) Support component
  92.          provides base OS/2 DBCS support fixes required to exploit
  93.          Java DBCS character display and input on OS/2 Warp* 4.0.
  94.          This component is supported only on OS/2 Warp 4.0; it may
  95.          be installed on earlier versions of OS/2 Warp but does not
  96.          provide DBCS function in Java.
  97.  
  98.          Each of the four Java components can be installed at
  99.          different times as long as the Runtime component is
  100.          installed first.
  101.  
  102.          __________________________________________
  103.          1.4. HPFS and FAT Partition Considerations
  104.  
  105.          The Java Toolkit and Java Samples components require an HPFS
  106.          partition.  If you select a FAT partition during installation
  107.          of these components, the install program warns you that an
  108.          HPFS partition is required.
  109.  
  110.          The Java Runtime and DBCS support components can be
  111.          installed on a FAT partition.  However, to use the Java
  112.          Toolkit and Samples components, all of the components must
  113.          be installed in the same partition.  If you install the
  114.          Runtime component on a FAT partition, you cannot install
  115.          the Toolkit and Samples components.  If you attempt to
  116.          install the Toolkit or Samples components on a FAT
  117.          partition, the install program fails with error code
  118.          x'0060' (960 decimal), and the components are not installed.
  119.  
  120.          Note:  If you have only one hard disk with a single FAT
  121.          partition, you have three options:
  122.  
  123.             - Leave your system as it is and install only the Runtime
  124.               component and, if needed, the DBCS Support component.
  125.  
  126.             - Format that partition for HPFS and reinstall all
  127.               software.
  128.  
  129.             - Purchase a disk partitioning program, such as
  130.               PartitionMagic**.   With sufficient space,
  131.               PartitionMagic reduces the size of the current
  132.               partition (drive C) and creates a new partition
  133.               (logical drive D), which can be formatted for HPFS.
  134.  
  135.      _________________________________________________________________
  136.      2.  Installation
  137.  
  138.          To install Java 1.0.2 for OS/2, use one of the following
  139.          methods:
  140.  
  141.          ______________________________
  142.          2.1.  Icon Installation Method
  143.  
  144.          To install from the INSTALL.EXE icon, follow these steps:
  145.  
  146.          1. Open the OS/2 System folder.
  147.          2. Open the Drives object.
  148.          3. Open the drive where the Java files were extracted.
  149.          4. Open the directory where the Java files were extracted.
  150.          5. Select the INSTALL.EXE icon to start the install program.
  151.  
  152.          The Software Installer program leads you through the
  153.          installation steps.
  154.  
  155.          ________________________________________
  156.          2.2.  Command Prompt Installation Method
  157.  
  158.          To start installation, make sure that you are in the
  159.          directory where the Java files were extracted.  At an
  160.          OS/2 Window command prompt, enter:
  161.  
  162.             install
  163.  
  164.          The Software Installer program leads you through the
  165.          installation steps.
  166.  
  167.          __________________________________________
  168.          2.3.  Unattended (CID) Installation Method
  169.  
  170.          Unattended or CID installations of Java for OS/2 can take up
  171.          to 15 to 20 minutes or more.  Please ensure that the
  172.          unattended install completes before re-booting your system.
  173.  
  174.          To install using the unattended method, you must modify the
  175.          response file before entering the install command at an
  176.          OS/2 command prompt.
  177.  
  178.             _________________________________
  179.             2.3.1 Modifying the Response File
  180.  
  181.             Locate the file JAVARESP.RSP in the directory where the
  182.             Java files were extracted.  This file is a standard
  183.             Software Installer response file that contains
  184.             keyword-value pairs to control the unattended install.
  185.             The only Java-unique entries in this file are the
  186.             component names.
  187.  
  188.             The FILE variable specifies the target drive (including a
  189.             colon) for the install.  Java is always installed in the
  190.             \JAVAOS2 directory on the target drive.  If a previous
  191.             version of Java exists on the target drive, the install
  192.             program replaces it.
  193.  
  194.             The COMP variables specify the components to install.
  195.             Component names are OS/2 Java Runtime, OS/2 Java Toolkit,
  196.             OS/2 Java Samples, and OS/2 Java DBCS Support.  Modify
  197.             this list to include the components that you want to
  198.             install.  The Runtime component is a prerequisite for
  199.             installation of the Toolkit, Samples, and DBCS Support
  200.             components.  Consult the Software Installer online
  201.             documentation for further information on variables in
  202.             this file by entering:
  203.  
  204.                view c:\path\EPFIHPLB.HLP
  205.  
  206.             where path is where the Java files were extracted.  After
  207.             Java is installed, this file is in the \JAVAOS2 directory.
  208.             Search on the Response file format.
  209.  
  210.             __________________________________________
  211.             2.3.2 Starting the Unattended Installation
  212.  
  213.             To start an unattended install, enter the following
  214.             single-line command at an OS/2 command prompt:
  215.  
  216.                install /x /a:i /nmsg /o:drive /r:c:\path\javaresp.rsp
  217.                   /L1:c:\path\outputfile1 /L2:c:\path\outputfile2
  218.  
  219.             where /r specifies the fully-qualified location of the
  220.             response file.  The parameters /L1 and /L2 specify the
  221.             fully-qualified locations of the log files.  The command
  222.             above installs the components specified in the response
  223.             file C:\PATH\JAVARESP.RSP.
  224.  
  225.             To delete, update, or restore Java for OS/2, change the
  226.             install parameter /a:i to /a:d, /a:u, or /a:r,
  227.             respectively.
  228.  
  229.             For more information on installing Java using the
  230.             NetView Distribution Manager/2 or the LAN CID Utility
  231.             consult the Software Installer on-line documentation and
  232.             respective product documentation.
  233.  
  234.          _____________________________________________
  235.          2.4.  TME-Architected CID Installation Method
  236.  
  237.             A JAVA.ADF file is provided for use with Tivoli
  238.             Management Environment (TME) architected CID
  239.             installation products, such as Netfinity Server and the
  240.             Tivoli TME-10 Software Distribution Agent.  See the
  241.             documentation pertaining to the CID installation product
  242.             being used for instructions regarding the use of .ADF
  243.             files.
  244.  
  245.      _________________________________________________________________
  246.      3. After You Install
  247.  
  248.          _______________________________________
  249.          3.1.  Additional Sources of Information
  250.  
  251.          The following objects display in the Java folder only if you
  252.          are running OS/2 Warp 4.0.  If you are not running OS/2 Warp
  253.          4.0, you can access the associated documents at the following
  254.          locations, substituting the partition you installed Java on
  255.          for x:
  256.  
  257.             IBM Centre for Java Technology
  258.                http://ncc.hursley.ibm.com/javainfo/
  259.  
  260.             Running Java
  261.                x:\JAVAOS2\runtime.htm
  262.  
  263.             Configure Applet Viewer
  264.                x:\JAVAOS2\cnfgappl.htm
  265.  
  266.             Java Developers Kit for OS/2
  267.                x:\JAVAOS2\index.html
  268.  
  269.             Java Toolkit
  270.                x:\JAVAOS2\toolkit.html
  271.  
  272.             Java API
  273.                x:\JAVAOS2\docs\api\API_users_guide.html
  274.  
  275.             Java Documentation
  276.                http://www.javasoft.com/doc.html
  277.  
  278.          _______________________________________________
  279.          3.2.  Disabling the Just In Time (JIT) Compiler
  280.  
  281.          A Just In Time (JIT) compiler is provided with Java 1.0.2
  282.          for OS/2 which generates machine code for frequently used
  283.          byte code sequences in a Java application or applet
  284.          on-the-fly during execution.
  285.  
  286.          You can disable the JIT to aid in the isolation of a
  287.          problem with a Java application, an applet, or the compiler
  288.          itself in a number of different ways:
  289.  
  290.             _________________________________
  291.             3.2.1. Using Netscape Navigator**
  292.  
  293.             The JIT can be disabled in the Netscape Navigator for
  294.             OS/2 by selecting the Options pulldown, choosing
  295.             Security Preferences..., and checking the Disable Java
  296.             Compiler box.
  297.  
  298.             ______________________________________
  299.             3.2.2. Setting an Environment Variable
  300.  
  301.             You can set the environment variable JAVA_COMPILER to
  302.             the name of a non-existent DLL, such as
  303.             SET JAVA_COMPILER=xyz.  Specify blanks for the name to
  304.             suppress the "Unable to load DLL" warning message.
  305.  
  306.             ___________________________________________________
  307.             3.2.3. Specifying a Property on the JAVA invocation
  308.  
  309.             You can set a property on the invocation of JAVA.EXE to
  310.             point to a non-existent DLL or blanks as shown here:
  311.  
  312.                 java -Djava.compiler=  hello
  313.  
  314.             _______________________
  315.             3.2.4. Renaming the DLL
  316.  
  317.             You can rename the file JAVAX.DLL in the \JAVAOS2\DLL
  318.             directory to something else, such as JAVAX.BAK.  If
  319.             JAVAX.DLL is not found in the LIBPATH, the JIT is
  320.             disabled for both the Netscape Navigator and Java
  321.             applications.
  322.  
  323.          ________________________________________
  324.          3.3.  Considerations for Files on CD-ROM
  325.  
  326.          The CD-ROM file naming specifications have been relaxed
  327.          in recent years to allow the use of long names and names
  328.          in mixed case.  The CD-ROM file system shipped with OS/2
  329.          does not support these features.
  330.  
  331.          _____________________________________________________
  332.          3.4.  Viewing HTML or Java Objects in Warp 3 and Warp Connect
  333.  
  334.          Selecting HTML or Java objects in the Workplace Shell on OS/2
  335.          Warp 3 or OS/2 Warp Connect systems results in no information
  336.          being displayed.  This is caused by an improper setting for
  337.          the Editor for Java object in the Java for OS/2 folder.
  338.  
  339.          To correct the setting, open the settings for the Editor for
  340.          Java object and remove the /R from the Parameters: field on
  341.          the Program page.  Close the settings notebook to save the
  342.          changes.
  343.  
  344.          _____________________________________________
  345.          3.5.  Fixing Incorrect Icons in OS/2 Warp 4.0
  346.  
  347.          If Java for OS/2 is installed on an OS/2 Warp 4.0 system and
  348.          subsequently deleted and re-installed, the icons for the Java
  349.          Applet Viewer from HTML and the Java Applet Viewer from URL
  350.          objects in the Java for OS/2 folder are incorrect.
  351.  
  352.          To correct the icons, run the ICONS40.CMD file by
  353.          entering the name from an OS/2 Window command prompt
  354.          while in the javaos2 directory.
  355.  
  356.  
  357.      _________________________________________________________________
  358.      4.  TRADEMARKS
  359.  
  360.      The following terms, denoted by an asterisk (*) the first time
  361.      they appear in this READ.ME file, are trademarks or registered
  362.      trademarks of the IBM Corporation in the United States or other
  363.      countries or both:
  364.  
  365.           IBM
  366.           NetView
  367.           OS/2
  368.           OS/2 Warp
  369.           Workplace Shell
  370.  
  371.  
  372.      The following terms, denoted by a double asterisk (**) the
  373.      first time they appear in this READ.ME file, are trademarks or
  374.      registered trademarks of other companies:
  375.  
  376.           TRADEMARK            OWNER
  377.           ___________________  _____________________________________
  378.  
  379.           Netscape             Netscape Communications Corporation
  380.           Netscape Navigator
  381.  
  382.           PartitionMagic       PowerQuest Corporation
  383.  
  384.       Java and HotJava are trademarks of Sun Microsystems, Inc.
  385.  
  386. <end of file>
  387.