IBM DB2 Everyplace Enterprise Edition Version 9.1.1 Release Notes

Welcome to the IBM® DB2® Everyplace® Version 9.1.1 Release Notes.

This document contains the enhancements that are addressed by DB2 Everyplace Version 9 Release 1 Fix Pack 1 (hereafter referred to as DB2 Everyplace V9.1.1). You can also find the link to information about installing, configuring and uninstalling DB2 Everyplace V9.1.1. A list of known restrictions and considerations is also documented.

DB2 Everyplace V9.1.1 new features

This section introduces the new features that are available in DB2 Everyplace V9.1.1.

New supported products

Support for the Windows® Vista operating system
Windows Vista has been tested with DB2 Everyplace database and DB2 Everyplace Sync Client. You can install these two components of DB2 Everyplace on Windows Vista. DB2 Everyplace Sync Server is not supported on it.
Support for Palm OS 5.4
DB2 Everyplace now supports Palm OS 5.4. In Palm OS 5.4, data is stored in the NVFS (non-volatile file system), which ensures data integrity when the battery completely loses power. This new feature includes the following updates:
  • The new connection attribute SQL_ATTR_ACCESS_HIDDEN_VOLUME for the CLI function SQLSetConnectAttr()
  • The new connection method isEnabledAccessHiddenVolume() for DB2eConnection class
  • The new property ISCPROP_DB2eAccessHiddenVolume for the DB2 Everyplace Sync Client API iscServiceOpenEx()
Support for Apache Derby database
DB2 Everyplace Enterprise Edition now supports Apache Derby as a client database. You can use Derby database instead of the DB2 Everyplace database to synchronize data. DB2 Everyplace V9.1.1 includes Apache Derby under the directory <DSYPATH>\Clients\derby, where <DSYPATH> is the root installation directory of DB2 Everyplace. Data type mapping information between Apache Derby and the various source databases is added in the documentation.

Configuration with WebSphere Application Server Version 6.1

Configuring DB2 Everyplace with WebSphere® Application Server Version 6.1 has been tested and is now supported.

Synchronization

Support for triple Data Encryption Standard (triple DES)
With the support for triple DES, DB2 Everyplace provides enhanced security during data transport.
Support for Type 4 JDBC driver and Type 2 Universal JDBC driver
DB2 Everyplace now supports access to DB2 as a source database through Type 4 JDBC driver and Type 2 Universal JDBC driver.
Support for synchronization of BLOB data types
You can now synchronize BLOB data types between your devices and source databases. Palm OS devices and Symbian devices are not supported for this feature; DB2 for z/OS® as a source database is not supported either.

Database and application development

Improved query performance
Support for triple Data Encryption Standard (triple DES)
With the support for triple DES, DB2 Everyplace provides enhanced security for tables on mobile devices.
New system catalog base table DB2eSYSINDEXES
This new system catalog base table stores the index information of the database. You can now view the detailed index information by using SELECT statement. When developing applications, you can use the DB2 CLI function SQLStatistics and the JDBC method DatabaseMetaData.getIndexInfo to retrieve the information.
New connection attribute SQL_ATTR_FORCE_DISCONNECT
You can stop long-running database operations by using this new connection attribute.
JSR-169 package
JSR-169 package is necessary to develop Java™ applications with DB2 Everyplace if you use IBM® J9 virtual machine. DB2 Everyplace includes a JSR-169 package for your convenience.

License changes and new error messages

The Software License Agreement terms are changed in this release. During installation, the license panel will display the complete terms.

The following error messages are new in this release and are available in English only.

DSYC700E: Data too large for synchronization.
DSYM186I: This is a key-only table and the join filter is disabled automatically.
DSYS033E: The device cannot synchronize because the subscription contains BLOB data. BLOB data type cannot be synchronized on Palm or Symbian devices.
DSYS034E: The source data row with primary key value in table table name exceeds data size limit. Either one BLOB in replication is bigger than 4 MB or the row size is bigger than 4 MB because of the BLOB data.
SQLSTATE 08008: Connection is closed.
SQLSTATE 42510: Invalid encryption algorithm.
SQLSTATE HY100: Uniqueness option type out of range.

Fixes contained in this fix pack

The following APARs are fixed in DB2® Everyplace® V9.1.1.

APARs

Installation, configuration and uninstallation

This section points to the installation, configuration and uninstallation instructions.

DB2 Everyplace V9.1.1 includes Apache Derby under the directory <DSYPATH>\Clients\derby.

DB2 Everyplace V9.1.1 includes JSR-169 package jdbc.jar as follows:

To install, configure and uninstall DB2 Everyplace V9.1.1, see DB2 Everyplace V9.1.1 Information Center, or download the Installation and User's Guide from DB2 Everyplace library.

Notes:

Known considerations and restrictions

This section contains known defects in this release of DB2® Everyplace®. It also provides information about any fix or workaround that exists for these limitations and issues.

For configuration

After you complete the basic configuration of DB2 Everyplace with WebSphere® Application Server Version 6 and start the DB2 Everyplace application server, the SystemOut.log will contain the exception message of no permission to write the WebSphere Application Server activity.log. This exception occurs because the owner of the DB2 Everyplace application server does not have the necessary permission to write to the file activity.log in that directory. This issue will not affect system usage and will be fixed in the next release.

For the DB2 Everyplace Sync Client

  • For Java™ Sync Client, the file in a file subscription is not updated on mobile devices after you reset the subscription.

    Workaround: After you make changes to a file referenced in a file subscription, create a new file subscription for the file. Then the DB2 Everyplace Sync Server will replicate the file to the subscribed users on the next synchronization.

  • The changes on mobile devices are synchronized in request messages. If a message size is larger than 5 MB, the synchronization of Java Sync Client will fail and the error message 700 is written to the trace-isyn file.

    Workaround: Synchronizing the Java Sync Client with the server more often might solve the problem.

  • If a table on mobile devices is encrypted with 56-bit data encryption standard or 192-bit data encryption standard, and after the first successful synchronization of the JDBC or upload subscription that references the table, you set the table encryption level to None, the next synchronization will fail and the error message DSYC698E: 42501 is written to the trace-isyn file.

    Workaround: Change the table's encryption level back to 56-bit data encryption standard or 192-bit data encryption standard. Synchronize to obtain changes from mobile devices. Change the table encryption level to None. Delete the target database on the device and synchronize again to obtain data from the server and recreate the target database.

  • The IUpgrade application for Symbian mobile devices is available only in German, English, Spanish, French, and Italian.

For the DB2 Everyplace Sync Server

  • The maximum length of a BLOB column is 4 MB. When you update a BLOB column in a source table from less than 4M to larger than 4M, the updated data will not be replicated to the mirror database, and the error message DSYS034E will be reported. The old data will be sent to the device. To avoid this problem, it is recommended that you limit the BLOB size when creating the source table if possible.
  • On Windows®, after you refresh an item in the left panel of Mobile Devices Administration Center, three dots "..." might display as part of the item name. For example, Users might change to Users... or .... Try to refresh the item again.

For the database

  • Unique user-defined indexes are available in DB2 Everyplace V9.1. Currently, the output generated by the LIST INDEX command in DB2eCLP does not allow you to distinguish between unique and non-unique indexes. It is possible only to identify user-generated indexes from the system-generated indexes for primary key columns.

    Workaround: DB2 Everyplace V9.1.1 contains the SQLStatistics() CLI API, which applications can use to determine whether a user-defined index is unique or not. In DB2eCLP, you can query the contents of the DB2eSYSINDEXES table directly. The NONUNIQUE column contains the value 0 for unique indexes, and the value 1 for non-unique indexes.

  • The output of the DB2LOOK command in DB2eCLP does not generate appropriate DDL for unique user-defined indexes. All CREATE INDEX statements generated by DB2LOOK will create non-unique indexes.

    Workaround: Identify unique indexes by querying the DB2eSYSINDEXES table. The CREATE INDEX statements generated by DB2LOOK need to be modified manually for these indexes.

  • When you run DELETE FROM table-name under physical delete mode, if you have BLOBs larger than 32 KB, the files that store these BLOBs are not deleted from the database. This does not impact database operations, but that the size of the table does not decrease as expected.

For the documentation

If the Sync Server Help page is started in an Internet Explorer browser under Windows® XP, the browser displays the following warning: "To help protect your security, Internet Explorer has restricted this file from showing active content that could access your computer. Click here for options...". Click the warning message to display the content.

Trademarks

The following terms are trademarks of the International Business Machines Corporation in the United States, or other countries, or both.

Cloudscape
DB2
Domino
Everyplace
IBM
Lotus
WebSphere
z/OS  

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft, Windows, and the Windows logo are registered trademarks of Microsoft Corporation in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.