RUNTIME ENVIRONMENT for Sun's Java(tm) Programming Environment
--------------------------------------------------------------

This is an OS/2 port of Sun's Java version 1.0.1 programming
environment.

Installation
------------

Ensure that CONFIG.SYS changes are made for the PATH and LIBPATH
statements such that:-

PATH include x:\javaos2\bin;
LIBPATH includes x:\javaos2\dll;

where 'x' is the drive on which the Java runtime was installed.

Configuration
-------------

A number of environment variables are available which will modify
the behavior of the Java runtime:

- set JAVA_CONNECT_TIMEOUT=n

  will adjust the time that Java will wait for a network connection
  before reporting a timeout. 'n' is in seconds, from 1 through to
  a million (default = 30).

- set JAVA_AUDIO_VOLUME=v

  will adjust the volume that Java will use for audio output and is
  a percentage of the maximum volume. 'v' may take a value from 0
  to 100 (default=75).

- set JAVA_AUDIO_RATE=n

  will set the preferred playback sample rate for audio. A value for
  'n' of 8 will replay at 8000 per second, or 11 for 11025 samples
  per second. The Java runtime will normally try 8000 first (to match
  the incoming data stream) and then 11025; some drivers (notably
  some ThinkPad 701C early drivers prior to October 1995) appear to
  support 8000 but then fail; they can be made to work by forcing the
  playback rate to 11025.

- set JAVA_HOME=<dir>

  will set the path to the shared Java runtime directories.

- set JAVA_USER=<dir>

  will set the path to the directory into which and from which user
  specific files will be accessed, eg hotjava\property file.

- set JAVA_WEBLOGS=<dir>

  will set the path to the directory into which the Java runtime will
  write weblog files for each started Java process.

- set JAVA_CONSOLE=1

  when set specifies that java programs executed using "javapm" and "applet"
  will be run with a java console.

Platform Specifics
------------------

There are a number of platform specific changes for OS/2:

- The applet viewer program is called "applet"

- By default, stdout & stderr output from the applet viewer are directed
  to a weblog file in the <JAVA_WEBLOGS>\weblogs directory. The "-nore"
  option will stop the automatic redirection.

- Stand alone Java programs (not applets) that use the Abstract Window
  Toolkit (AWT) should be started with "javapm" not "java". If a Java
  program that uses AWT is started with "java" then it will be unable
  to create any windows due to an OS/2 PM restriction.

- To view stdout & stderr output for java programs executed as Presentation
  Manager processes (using either "javapm" or "applet") a java console is
  provided. To execute under the java console specify the "-cons" option,
  alternatively set the JAVA_CONSOLE environment variable.

- The HOME environment variable is called JAVA_USER

Where to find more information
------------------------------

From IBM: visit our web site at

          http://ncc.hursley.ibm.com/javainfo

          here you will find useful information about on-going Java
          related work within IBM, there are also a number of Java
          mailing lists to which you can subscribe and ask questions.
          Although not an official support channel the mailing lists
          are monitored by IBM.

From Sun: visit Sun's web site at

          http://java.sun.com

          here you will find information on a wide variety of Java
          related topics.