Patch Number : 008
Product      : ST-Developer 
Obsoletes    : 002
Prerequisites: None
Description  : JavaROSE & SDAI Java update

======================================================================
CONTENTS OF THIS README:

Description
Download and Install Instructions
    UNIX
    Windows

======================================================================
DESCRIPTION:

This patch upgrades the JavaROSE API and native library and provides a
new version of the SDAI Java which has been revised to meet the new
specification.

A number of small bugs in the JavaROSE API have been fixed and some
missing functionality has been added.  Use the javadoc documentation
in %ROSE_JAVA%\docs\packages.html to see what methods are available.
If the API is missing any of C++ methods you'd like to use, please
send mail to support@steptools.com so that we can get it into the next
release.

A lot of work went in to the SDAI Java at the Orlando ISO meeting.
This release has been updated to contain many of the changes as of the
end of that meeting.

Changes include:

o Name changes for interfaces and packages.  Schema foo entity bar
  used to be mapped to SDAI.FooS.Bar.  Now it is mapped to
  SDAI.SFoo.EBar.

o Some of the SDAI.lang classes have changed names such as:
  SDAIException -> SdaiException
  SDAIRuntimeException -> SdaiException

o The SDAI.lang.SessionC is now SDAI.Runtime.CSession

o The Session.OpenRepository() method is now Session.OpenRepo().

o Model_contents has some new methods:
  moveInstance() - moves an instance into the contents

  copyInstance() - makes a shallow copy and inserts the copy into the
		   contents

  createSelectInstance() - to create select instances without using
			   the implementation specific class.

o The use of classes directly is discouraged and they have been moved
  out of SDAI.S to SDAI.sti.S

o SDAIutil contains many more convenience functions, including several
  methods for handling arrays (addElement(), insertElement(),
  deleteElement()).

o App_inst now contains GetInstanceType() which returns the
  java.lang.Class for the generated interface and GetInstanceType()
  which returns the express typename.

This patch includes replacements for two chapters in the SDAI Java
manual that have undergone significant changes.  In addition to
reading these new chapters, we recommend that you browse the javadoc
for the SDAI.lang interfaces and classes and the page for
SDAI.sti.SDAIutil.

======================================================================
DOWNLOAD AND INSTALL INSTRUCTIONS

There is a several versions of this patch available -- one for each
architecture that the java tools support.  They are all available for
FTP on the STEP Tools ftp server (ftp.steptools.com).


UNIX:

The UNIX versions of the patch are available in the in the following files
located in ftp://ftp.steptools.com/pub/patches.

  AIX 4.1 on IBM PowerPC patch_008_aix_4.1.tar.Z
  SGI IRIX 5.3/6.2 patch_008_irix_5.3.tar.Z
  Solaris 2.x on SPARC	patch_008_solaris.tar.Z

Each patch is a compressed tar file.  To unpack: 
	% zcat patch_008_ARCH.tar.Z | tar xvf -
	% cd patch_008_ARCH
	% ./install_patch


WINDOWS:	
The Windows versions are available in the following files which are located in
ftp://ftp.steptools.com/pub/patches

  Windows NT/95 on Intel x86	patch_008_i86_win.zip

Each windows patch is a zip file.  (Note: this file contains subdirectories.
You may need to tell you unzip program to extract subdirectories).  
	C:> unzip patch_008_ARCH.zip

After you have extracted the file:
	C:> cd patch_008_ARCH
	C:> install_patch