README
======

On November 21st of 2006, the Parliament of Western Australia enacted
legislation to change to DST effective Sunday December 3, 2006.

The README document describes the procedure for updating the affected
java timezone data rules as a result of new Western Australia DST rules.


Relevant Files
==============

  Perth			- timezone file
  README		- this README info doc
  WATimeZone.java	- Testcase source file
  WATimeZone.class	- 1.4.2 precompiled testcase


Supported J2SE Versions
=======================

  All J2SE 1.4.2 update releases through 1.4.2.13b (1.4.2Mb on OpenServer)  
  All J2SE 5.0 update releases 06 and 09
           - 1.5.0.06 & 1.5.0.09   on UW 7.1.4
           - 1.5.0Fa  & 1.5.0Ia    on OSR 6.0.0


Procedure for Installing New Timezone Data
==========================================

Note: Both Java 2 SE 1.4.2 and J2SE 5.0 may be installed on your SCO
      UNIX system.  Repeat this process for each installed J2SE

      DO NOT ATTEMPT to update Java 2 SE 1.3.1 with this patch.  Timezone
      corrections for J2SE version 1.3.1 will be incorporated in 
      update 19 (1.3.1.19).

a) Unwind the downloaded WA.DST.TZ.tar file into a "work" directory of your
   chosing.

	mkdir <tar unwind dir>
	cp WA.DST.TZ.tar <tar unwind dir>
	cd <tar unwind dir>
	tar -xf WA.DST.TZ.tar

b) Locate the installation directory of the JRE.  This will be
   referred to as JAVA_HOME below.

     J2SE 1.4.2:
        /opt/java2-1.4.2			on UW 7.1.x and OSR 5.0.7
	/opt/K/SCO/j2se142/opt/java2-1.4.2	on OSR 6.0.0


     J2SE 5.0:
        /opt/java2-1.5.0			on UW 7.1.x and OSR 5.0.7
	/opt/K/SCO/j2se150/opt/java2-1.5.0	on OSR 6.0.0

   NOTE: On OpenServer 6.0.0, the changes must be made relative to
         the /opt/K/SCO/j2se1?? installation directory, not the user
         visible path - /opt/java2-1.?.?.

c) Verify that this J2SE is supported for the purposes of this update.

   Run
	$JAVA_HOME/bin/java -version

   The version reported should be in the supported version ranges listed
   above.

d) To avoid any corrupt timezone data being returned to running java
   applications, terminate any applications using the J2SE being
   updated.  

e) Change directory into the JAVA_HOME/jre/lib/zi/Australia directory

	cd $JAVA_HOME/jre/lib/zi/Australia

f) As root, remove the installed "Perth" file by backing it up to a temporary
   location.

	mv Perth Perth.REL

g) As root, install the supplied (new) Perth file in this directory.

	cp <tar unwind dir>/Perth .

h) Run the supplied testcase with the update J2SE to verify the changes
   have taken effect.  The testcase output will indicate the result.

   To run the testcase:
	- a precompiled J2SE 1.4.2 class file is available
	- change directory to the temporary work directory containing the
	  provided class file

	     cd <tar unwind dir>

	- run

	     $JAVA_HOME/bin/java WATimeZone

	- a PASS message will indicate that the J2SE has been updated.

	- a source file has also been provided - WATimeZone.java 

i) After verifying successful test output, restart applications dependent 
   on this J2SE.

j) Repeat steps b) through i) for the other J2SE version if installed.


Additional Notes
================
The patch provided here is only for a temporary work-around.  All customers
should upgrade to the next available SCO J2SE update release which will
contain the new Western Australia DST rules.

The SCO provided J2SE update release scheduled to incorporate these
new timezone rules are:

	J2SE 1.3.1.19		(1.3.1Sa)
	J2SE 1.4.2.14		(1.4.2Na)
	J2SE 5.0, update 10	(1.5.0Ja)
