                      VisualAge(R) for Java(TM)
                             Version 3.0

                            Data Access Beans

                            RELEASE NOTES


Table of contents

1.0 Introduction
2.0 Prerequisites
3.0 Limitations and known problems
    3.1 Using the java.math.BigDecimal class on locales that use a 
        comma as a decimal-separator
    3.2 Timeout Property causes IDE to hang
    3.3 Updates and deletes fail with some versions of DB2(R) net driver

  
1.0 Introduction
----------------

The Data Access Beans provide an easy way to access relational data
through VisualAge for Java's JDBC interface. 

2.0 Prerequisites
-----------------

To use the Data Access Beans, you must manually add the JDBC 
driver that you will be using to your workspace classpath.

3.0 Limitations and known problems
----------------------------------

3.1 Using the java.math.BigDecimal class on locales that use a 
    comma as a decimal-separator

Class java.math.BigDecimal is dependent on the decimal separator 
being a period '.' when in some locales it can be other characters
such as a comma ','. If you have DB2(R) Universal Database, version 5,
installed, then you can work around this problem by setting
the CLI patch2=15 to force the '.' to be used as the decimal point. 
This is done through adding one line in  \SQLLIB\DB2CLI.INI file 
as follows:

patch2=15

The line patch2=15 should be added in the database section of the 
db2cli.ini file.  

This "patch2=15" feature is only supported by DB2 Universal 
Database version 5.0 or higher, with fixpak 6 installed. Users 
can download the fixpak from the following sites: 

Windows Fixpak: WR09074
ftp://ftp.software.ibm.com/ps/products/db2/fixes/english-us/db2ntv5/FP6_WR09074/

OS/2 Fixpak: WR09073
ftp://ftp.software.ibm.com/ps/products/db2/fixes/english-us/db2os2v5/FP6_WR09073/

AIX Fixpak: U459852
ftp://ftp.software.ibm.com/ps/products/db2/fixes/english-us/db2aixv5/FP6_U459852/

3.2 Timeout Property causes IDE to hang

If you are using the DB2 app driver (COM.ibm.db2.jdbc.app.DB2Driver)
and you set the timeout property of a Select, Modify, or ProcedureCall
bean to a value other than 0, and run your application inside of the
VisualAge for Java IDE, an Application Error will occur when the
application terminates, hanging the IDE. 

You can successfully run an application using the timeout property
outside of the VisualAge for Java IDE.

The problem does not occur when the the DB2 net driver is in use.
(COM.ibm.db2.jdbc.net.DB2Driver).

3.3 Updates and deletes fail with some versions of DB2 net driver

By default, the Select and ProcedureCall beans use positioned updates
and deletes. For DB2 version 6 and version 5.2 with fixpack 8 or higher,
positioned updates and deletes fail when the net driver is in use.
(COM.ibm.db2.jdbc.net.DB2Driver). 

To avoid this problem, either set the forceSearchedUpdate property of
the Select or ProcedureCall bean, use the app driver (COM.ibm.db2.jdbc.
app.DB2Driver), or use DB2 version 5.2 with fixpack 7 or earlier. F
orceSearchedUpdate is an expert property that causes searched 
(instead of positioned) updates and deletes to be used.




