Readmefirst file for IBM(R) zSeries Developer Kit for Linux, Java(TM) 2
-----------------------------------------------------------------------
Technology Edition
------------------


This READMEFIRST file provides late-breaking information that was not 
incorporated into the README files.  This file must be read in conjunction 
with the README files listed below.

General information
--------------------
In some sections of the READMEs there are detailed instructions 
on how to reach specific information on a Web site. At the 
time of writing these instructions were correct. However, 
since then, the Web sites might have changed.

If you use the Konqueror Web browser to view the READMEs you 
might encounter formatting problems. You will not encounter these 
problems if you use Netscape or Mozilla.



IBM zSeries Runtime Environment for Linux, Java 2 Technology Edition 
--------------------------------------------------------------------
README 
------

Configuring the Runtime Environment for Linux
---------------------------------------------

Change PATH statement from '/opt/IBMJava2-ppc-131/jre/bin ' to 
'/opt/IBMJava2-s390-131/jre/bin'.

Installing additional fonts
---------------------------

Delete this section

Installing on Red Hat
---------------------

Delete this section.

Known Limitations
------------------
In the third bullet, under 'General information', delete the numbered list '1,2' and replace 
with a new bullet item:

The Developer Kit for Linux implements Java threads as native threads, which 
results in each thread being a separate Linux process.  If the number of Java 
threads exceeds the maximum number of processes allowed, your program might get 
an error message, a SIGSEGV error, or your system might hang.

The maximum number of threads available is determined by the minimum of:
      
   The user processes setting (ulimit -u) in /etc/security/limits.conf 

   The limit MAX_TASKS_PER_USER defined in 
    /usr/include/linux/tasks.h (change requires Linux kernel to be recompiled) 

   The limit PTHREAD_THREADS_MAX defined in libpthreads.so (change requires Linux 
   kernel to be recompiled)
    
However, you might run out of virtual storage prior to reaching the maximum 
number of threads. 

In the seventh bullet, under 'General information', add at the end of the bullet item:

This is why the Developer Kit for Linux considers that Meta is being pressed 
together with Alt. As a workaround, you can remove the Meta_x mapping by typing 
the following at a shell prompt:
     
         xmodmap -e "keysym Alt_L = Alt_L" -e "keysym Alt_R = Alt_R"
   
Note: This workaround might affect other X-Windows applications running 
on the same display if they use the Meta-key that was removed.

Information for Japanese users
------------------------------

Replace the paragraph immediately under this heading with:

This release supports only US English and Japanese. Japanese language support was 
tested only with TurboLinux Server 6.5 for zSeries and S/390, and not tested with 
SuSE Linux 7.0. This was because, at present, only TurboLinux Server for 
zSeries and S/390 supports Japanese. 


Japanese fonts
--------------

Replace the first paragraph with the following sentence:

Java uses the Japanese TrueType fonts supplied by the distribution.

Tested environments
-------------------

Replace the paragraph under bullet point 2 with:

TurboLinux Server 6.5 for zSeries and S/390 does not have any IM (Input Method) 
interface such as kinput2. As a result only the second option above has 
been tested for this release. 






