Tib Adadb Release Notes

TIBCO Adapter™ for ActiveDatabase

Release NotesSoftware Release 5.1.0November 2003

Important Information

SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCH EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THE EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE.

USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THE CLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN THE TIBCO ADAPTER FOR ACTIVEDATABASE USER’S GUIDE). USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE BOUND BY THE SAME.

This document contains confidential information that is subject to U.S. and international copyright laws and treaties. No part of this document may be reproduced in any form without the written authorization of TIBCO Software Inc.

TIB, TIBCO, Information Bus, The Power of Now, TIBCO ActiveEnterprise, TIBCO Adapter, TIBCO Administrator, TIBCO Designer, TIBCO Hawk, TIBCO IntegrationManager, TIBCO Rendezvous, and TIBCO Runtime Agent are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries.

EJB, J2EE, JMS and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.

All other product and company names and marks mentioned in this document are the property of their respective owners and are mentioned for identification purposes only.

This software may be available on multiple operating systems. However, not all operating system platforms for a specific software version are released at the same time. Please see the readme.txt file for the availability of this software version on a specific operating system platform.

THIS DOCUMENT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.

THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCO SOFTWARE INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENT AT ANY TIME.

PORTIONS OF THIS SOFTWARE ARE COPYRIGHTED BY DATADIRECT TECHNOLOGIES, 1991-2002.

Copyright © 1999-2003 TIBCO Software Inc. ALL RIGHTS RESERVED.

TIBCO Software Inc. Confidential Information

| i

Contents

Release Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Changes in Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Deprecated Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Compatibility and Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11TIBCO IntegrationManager 4.x Engines and Adapter 5.x RPC Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Additional Related Release Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Closed Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Known Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

TIBCO Adapter for ActiveDatabase Release Notes

ii | Contents


| 1

Release Notes

Check the TIBCO Product Support web site at http://support.tibco.com for product information that was not available at release time. Entry to this site requires a username and password. If you do not have a username, you can request one from the same site. You must have a valid maintenance or support contract to use this site.

Topics

• New Features, page 2

• Changes in Functionality, page 5

• Compatibility and Migration, page 11

• Additional Related Release Notes, page 12

• Closed Issues, page 13

• Known Issues, page 25


2 | Release Notes

New Features

This section lists new features added since the last major release of this product.

Introduced in Release Feature

5.1.0 Support for TIBCO BusinessWorks 5.1

The adapter can be used in a TIBCO BusinessWorks 5.1 process.

5.1.0 Added Platform Support

The following platforms are now supported:

• Red Hat Linux AS 2.1

• Solaris 9

• Windows 2003

5.1.0 Added Database Support

DB2 on AS400 V5R2 (via remote connection) is now supported.

5.1.0 Trigger on Specific Columns (Microsoft SQL Server)

In previous versions of the adapter, the palette would generate publishing triggers for Oracle that would fire only if a certain column was updated in the source table—as opposed to the default behavior where an update to any column in the source table causes the trigger to fire. This functionality has been extended to the publishing triggers generated for Microsoft SQL Server.

5.1.0 Parent-child NULL Check

When doing a parent-child publish, the adapter now checks if the foreign key for a particular parent row is NULL. If it is, the adapter does not perform the child table query. This reduces the number of unnecessary child queries that might be executed.

5.1.0 Publishing Objects

If you specify a publishing table to be in a user schema that is different than the default user, the indexes will also be generated in that schema.

5.0.1 Added Encoding Support

Added support for the EUC-JP encoding.


New Features | 3


The following platform is now supported:

• Red Hat Linux 7.2

5.0.0 Support for the JMS transport

In previous releases, an adapter service could use only the TIBCO Rendezvous transport. In this release, the JMS (Java Messaging Service) transport is also available. An adapter service that uses the JMS transport can communicate only with the TIBCO Enterprise for JMS server.

5.0.0 Support for multi-file format projects

TIBCO Designer 5.0 now allows you to save TIBCO Adapter for ActiveDatabase projects in multi-file format at design-time. This format is useful if multiple adapter configurations are defined in the same project and worked on by several developers. TIBCO Adapter for ActiveDatabase configuration files can be managed by a version control system.

5.0.0 Standard connection management

All TIBCO adapters now use the same mechanism to handle connection loss to the vendor application.

5.0.0 Standard error management

All TIBCO adapters now use the same mechanism to report errors. Error messages provide more detail, are contextual and can be applied uniformly across adapters. Low-level exception messages like system and TIBCO Rendezvous messages now have appropriate adapter-level information. The error message descriptions and resolutions are documented in the TIBCO Adapter for ActiveDatabase User’s Guide.

5.0.0 New installer

The new installer program has three modes available for installation: GUI, console and silent. The GUI mode presents panels that allow you to make choices about product selection, product location, and so on. Console mode allows you to make installation choices from the command line. Silent mode either installs using the default settings or uses a response file that was saved during an earlier installation.


Support for AIX 5.1 has been added.

Introduced in Release Feature (Cont’d)


4 | Release Notes

5.0.0 Added Product Support

Support has been added for DB2 for AS/400 V5R1 (via remote connection). See the TIBCO Adapter for ActiveDatabase Installation Guide for the list of operating systems that offer support for this version.

5.0.0 Added TIBCO Hawk Microagent

A new TIBCO Hawk microagent provides statistics about the business operations carried out by the adapter.

5.0.0 Additional New Features

• Standard user exits have been added that can be used across adapters.

• The Polling Interval and Polling Batch Size parameters can be configured.

• An optional security module available with TIBCO Administrator allows you to set security access to the projects managed by the server. For more information, see the TIBCO Administrator documentation.

• As an alternative to creating an RPC client using a pre-defined request and reply object schema, you can now specify the stored procedure to be executed at design time.

• Tables can be filtered based on table title.

• Select all or deselect all columns in a publish or subscribe table.

• Load an arbitrary database table into a repository and create a repository class.

Introduced in Release Feature (Cont’d)


Changes in Functionality | 5

Changes in Functionality

This section lists changes in functionality since the last major release of this product.

Changed in Release Functionality

5.1.0 Changed TIBCO Hawk Methods

The following TIBCO Hawk methods have changed parameters and are now available in the adapter’s class microagent.

• getActivityStatistics()

• getActivityStatisticsByOperation()

• getActivityStatisticsBySchema()

• getActivityStatisticsByService()

• getThreadStatistics()

• getQueueStatistics()

• getConnectionStatistics()

The following parameters for the above methods are new or have changed (where applicable). In addition, the parameter order for some of the above methods has changed.

• The new output parameter MeasurementInterval displays the time (in seconds) since last time the adapter was reset, or if never reset, since the adapter started.

• The Total, Success, and Failure output parameters type has changed from string to integer.

• The new output parameter LineIndex is used as an index for the method. Its value is a concatenated string of the Operation and ServiceName parameters separated by a comma.

• The new output parameter NumLostConnections displays the total amount of time the connection has been lost.

5.1.0 TIBCO Rendezvous TX No Longer Supported

The TIBCO Rendezvous Transactional quality of service option is no longer supported. The option is still available in the adapter’s palette for backward compatibility with previous adapter releases.


6 | Release Notes

5.1.0 Installer Changes

The following changes have been made to the installer:

• For adapter installations on Microsoft Windows platforms, all DLLs are placed in the adapter installation lib subdirectory.

• The adapter installation has a new subdirectory called hotfix. The hotfix directory has two subfolders called lib and bin. Hotfix patches will be placed in these sub folders.

• All paths in the tra file will first be prepended with <ADADB_HOME>/hotfix/lib and <>/hotfix/bin followed by <ADADB_HOME>/lib and <ADADB_HOME>/bin.

5.1.0 TIBCO Hawk Class Agent Property

The adb.addCustomHawkMethodsToClassMAgent <on/off> property has been added to the adapter’s property file. The property is not set by default. Setting the property to off disallows adding custom methods to the adapter’s standard microagent. Setting to on allows custom methods to be added to the adapter’s standard microagent.

5.1.0 Dropped Platform Support

AIX 4.3 is no longer supported.

Red Hat Linux 7.2 is no longer supported.

5.0.1 Dropped Platform Support

Solaris 2.6 is no longer supported.

5.0.1 Palette Changes

Instance level fields and tabs in the palette have been rearranged and improved.

Changed in Release Functionality (Cont’d)


Changes in Functionality | 7

5.0.0 Installer Changes

The TIBCO Adapter for ActiveDatabase installation program no longer includes the TIBCO Runtime Agent software, which is required by TIBCO Adapter for ActiveDatabase. The software must be installed prior to installing the adapter.

In previous releases, TIBCO software could be uninstalled using the TIBCO Uninstaller program. In this release, each software component is uninstalled separately by navigating to the _uninst folder and running the Tibuninstall utility.

In previous releases, TIBCO Adapter for ActiveDatabase was installed in TIBCO_home\Adapter\adb\version. In this release, it is installed in TIBCO_home\Adapter\adadb\version.

5.0.0 Schema Location Changes

The location of the RPC server schemas has changed.

Schema classes for TIBCO ActiveEnterprise operations are now stored in a different location.

5.0.0 User Interface Changes

Connection screen in the palette has a new look and feel.

5.0.0 Design-time Adapter

The DTA has been removed. Its functionality has been moved to the palette.

5.0.0 Repository Server

The repository server is now a component of TIBCO Administrator. Access control to the repository server can be set using TIBCO Administrator.

TIBCO Administrator is now installed separately.

5.0.0 Removed Platform Support

The following operating systems are no longer supported:

• Linux 6.2

• DB2 for AS/400 V4R5 (via remote connection)



8 | Release Notes

5.0.0 Reduced Product Support

The following database versions are now supported only on selected operating systems, and require EMS (Extended Maintenance Support). See the TIBCO Adapter for ActiveDatabase Installation Guide for the list of operating systems that offer support for these versions.

• Oracle 8.0.6

• Oracle 7.3.4

5.0.0 Removed Product Support

The following database versions are no longer supported on any platform:

• Oracle 8.1.6

• Oracle 8.1.5

• Oracle 8.0.5

• Sybase 11.9.2



Deprecated Features | 9

Deprecated Features

This section describes deprecated features and lists equivalent features that accomplish the same result, if relevant. Any use of a deprecated feature should be discontinued as it may be removed in a future release. You should avoid becoming dependent on deprecated features and become familiar with the equivalent feature.

Deprecated in Release Feature

5.1.0 Deprecated feature The following 5.0.1 and earlier TIBCO Hawk methods available in the adapter’s custom microagent have been deprecated:• getActivityStatistics()

• getActivityStatisticsByOperation()

• getActivityStatisticsBySchema()

• getActivityStatisticsByService()

• getThreadStatistics()

• getQueueStatistics()

• getConnectionStatistics()

Equivalent functionality

The above methods are now available in the adapter’s class microagent and have been enhanced (as described in Changes in Functionality on page 5).

If you use TIBCO Designer 5.1 to modify a 5.0 or earlier adapter configuration for use with a 5.0 or earlier run-time adapter, you must use the methods in the custom microagent, not the methods in the class microagent.


10 | Release Notes

5.1.0 Deprecated feature The ability to set the following properties at design-time is deprecated.

General Tab

• Debug Level

• Generate Verbose Output

• Adapter Encoding

Adapter Services Tab

• Publish Child Data

• Batch Publish Status Updates

• Publisher Batch Confirm Size

• Publisher Batch Confirm Timeout

• Use Exception Table

• Rendezvous Maximum Queue Size

• Subscriber Batch Commit Size

• Subscriber Batch Commit Timeout

• Subscriber Bulk Insert Size

• Polling Interval

• Polling Batch Size

Equivalent functionality The properties can be set when deploying the adapter, using TIBCO Administrator or by changing the corresponding properties in the adapter’s properties file.

Deprecated in Release Feature


Compatibility and Migration | 11

Compatibility and Migration

See the TIBCO ActiveEnterprise Features, Migration and Compatibility guide for general information about how the adapter interoperates with previous adapter versions and other TIBCO ActiveEnterprise applications. The guide is part of the TIBCO Runtime Agent documentation set.

TIBCO IntegrationManager 4.x Engines and Adapter 5.x RPC ServersA TIBCO IntegrationManager 4.x engine can run a process that invokes an ActiveEnterprise operation on an RPC server created in TIBCO Adapter for ActiveDatabase 4.x. The IM 4.x process will also run with an ADB 4.x RPC server that has been opened in TIBCO Adapter for ActiveDatabase 5.0 and saved in the TIBCO ActiveEnterprise 5.x configuration format.

However, the IM 4.x process will not run with an RPC server created in TIBCO Adapter for ActiveDatabase 5.x, even if you save the RPC server in the ActiveEnterprise 4.x configuration format.

An IM 5.x process can run with an RPC server created in TIBCO Adapter for ActiveDatabase 4.x or 5.x, regardless of the AE configuration format the RPC server is saved in.

The supported IM process versions and RPC server formats are shown in the following table.

Make a backup copy of the project you are migrating to ActiveEnterprise 5.0 before starting the migration process.

Operation created in which version of TIBCO Adapter for ActiveDatabase?

ADB 4.x ADB 4.x ADB 5.x ADB 5.x

Operation saved in which TIBCO ActiveEnterprise RPC server configuration format?

AE 4.x AE 5.x AE 4.x AE 5.x

Can a process created in IM 4.x run this operation? Yes Yes No No

Can a process created in IM 5.x run this operation? Yes Yes Yes Yes


12 | Release Notes

Additional Related Release Notes

TIBCO Adapter for ActiveDatabase is supported by infrastructure products from TIBCO. See the following release notes for information about open and closed issues that may affect TIBCO Adapter for ActiveDatabase.

• TIBCO Designer release notes are available in:

<install-path>\tibco\designer\5.1\doc\

• TIBCO BusinessWorks release notes are available in:

<install-path>\tibco\bw\5.1\doc\

• TIBCO Runtime Agent release notes are available in:

<install-path>\tibco\tra\5.1\doc\

• TIBCO Administrator Repository Edition release notes are available in:

<install-path>\tibco\admin\5.1\doc\

• TIBCO Enterprise for JMS release notes are available in:

<install-path>\tibco\jms\doc\

The readme.txt file for each product includes information about platform support and details about installed components.


Closed Issues | 13

Closed Issues

This section lists product defects that were closed in the named release.

Closed in Release Defect # Summary

5.1.0 1-11XWM4 The adapter attempted to create a Hawk dispatcher thread even when the HawkEnabled property was set to false. This has been fixed.

5.1.0 1-17S6F5 When a project contained an adapter instance with a circular reference in a parent-child configuration, clicking on any adapter service caused TIBCO Designer to stop responding, utilizing nearly 100% CPU and rapidly increasing its memory usage. This has been fixed.

5.1.0 1-1ARXTJ The adapter request-response service when configured to use the JMS transport has a memory leak. This has been fixed.

5.1.0 1-ZHKO5 On DB2, when short names were used for columns the generated triggers were not referencing the short names correctly. This has been fixed.

5.1.0 1-11P3SD In TIBCO Designer, when saving a publication service that had a column name that began with the '@' character, the service was not saved correctly. This has been fixed.

5.1.0 1-17Q4DF On DB2 AS400, the ADB_SEQTAB table was created even though the Deploy on Save check box was not checked. Note that the check box has been renamed to Write to Database. This has been fixed.

5.1.0 1-1C2PRR On Linux, the adapter’s subscription service was unable to read strings from a message when the adb.encoding was set to LATIN_1. This has been fixed.

5.1.0 1-1AWPYV The adapter would flush the 'P' to 'C' update statements when no new confirmations arrived for that publishing table. This has been fixed.

5.1.0 1-PPMM9 A publication service configured for JMS transport did not support parameterized subjects or subject changes through the ADB_SUBJECT field in the publishing table. This has been fixed.

5.1.0 1-119DRK When the adapter failed to publish a message because of an incorrectly formed Rendezvous subject, the adapter printed the subject that caused the error and updated the publishing table with delivery status to 'F'. This has been fixed.


14 | Release Notes

5.1.0 1-11ISMY If the adapter could not process a row, it marked the row with a status of 'F' and went into a hung state on the offending row. Manual intervention was required to get out of this state. This has been fixed.

5.1.0 1-11ISO1 The adapter did not recognize a list of preregistered listeners separated by commas when specified in TIBCO Designer. This has been fixed.

5.1.0 1-12SXH3 The adapter’s subscription services inserted NULL values for fields using the custom type fixed.p.s. This has been fixed.

5.1.0 1-13M3PH A publishing table was created with datatype NUMBER(38) when the source table had a column NUMBER. This was a problem because floating point numbers cannot be copied into the publishing table correctly. This has been fixed.

5.1.0 1-13X4F5 The adapter did not report Rendezvous error advisories in the errorRole. This has been fixed.

5.1.0 1-152BD9 The adapter’s request-response service did not attempt to reconnect to the database even though the service was configured to do so. This has been fixed.

5.1.0 1-16PRLT When connecting to Microsoft SQL Server, the Design-Time Connection tab did not allow the Username and Password to be optional. This is required so the JDBC driver can use Windows authentication as the login and password. This has been fixed.

5.1.0 1-1802A8 The adapter’s request-response service would corrupt the date time field. This has been fixed.

5.1.0 1-18D763 An alerter process configured with max-rows only published the max-rows number of records, not all unpublished records in the publishing table. This has been fixed.

5.1.0 1-198HJV The OPAQUE wire format did not work correctly. This has been fixed.

5.1.0 1-1A6J1A The adapter updated the parent record, but did not delete the child records for a parent-child configuration where a message received by the subscription service had parent data only with opcode '2'. This has been fixed.

Closed in Release Defect # Summary (Cont’d)


Closed Issues | 15

5.1.0 1-1OZAL For publish by reference, when a parent-child relationship involved a parent column that was not a database key or a user-defined key, deleting a row in the source table caused an error in the subscription service. This has been fixed.

5.1.0 1-5HHHP The palette did not allow editing capabilities to its configuration when the underlying table definitions changed in the database. This has been fixed.

5.1.0 1-9HAUQ You could not update triggers if using Microsoft SQL Server. This has been fixed.

5.1.0 1-A8XZK For Microsoft SQL Server, a publication service using the DataDirect SQL Server 4.1 native driver does not publish any rows. (DataDirect defect logged as case #15001838.) This has been fixed.

5.1.0 1-BBRNR After configuring and saving an instance with multiple publication services, if you attempted to delete all of them in one action, the palette deleted all publication services from the repository, but only deleted one service from the database. This has been fixed.

5.1.0 1-BPI5M When you created a publication service in TIBCO Designer, saved it, linked the service, saved and closed the project, then opened it again, the linked publication service was missing. This has been fixed.

5.1.0 1-DQK7O For a request-response service, you could not create a request that used bind information from two tables. This has been fixed.

5.1.0 1-FWO7D For DB2/AS400, users did not have the option to generate a publishing table that used AS400 data queues to insert new rows asynchronously. This has been fixed.

5.1.0 1-G3YZL For Oracle, the DataDirect Oracle native driver and Oracle ODBC driver could not execute a procedure through a synonym. This has been fixed.

5.1.0 1-I80LU When inserting a NULL value into a table, you could not use two single quotes to specify NULL ( ’’ ). This has been fixed.

5.1.0 1-IMLCX The installodbc.exe program displayed a success message for any path entered against Enter the path of your DataDirect ODBC drivers, even if the path did not exist or when nothing was entered. This has been fixed.



16 | Release Notes

5.1.0 1-T9CAR For Sybase, a test connection never timed out for a connection attempt to a Sybase database when the database was unavailable. This has been fixed.

5.1.0 1-UEAX3 For Oracle, when a subscription service used the DataDirect Oracle wire protocol to connect to the database, the LONG datatype was truncated. This happened on Japanese Unix with EUC-JP encoding and Traditional Chinese W2K Server SP3. This has been fixed.

5.1.0 1-UM2SX Two problems could occur when you changed a request-response service from the default Request/Reply mode to RPC mode and created a custom operation, then changed the service back to Request/Reply mode. These could cause errors when you validated the service or project for deployment.

• The custom operation item remained in the AESchemas>ae>ADB>InstanceName>Classes folder. The item should be gone.

• If you deleted the instance containing the request-response service, the AESchemas>ae>ADB>InstanceName folder remains. The folder should be gone.

The problems have been fixed.

5.1.0 1-UT06M The adapter’s subscription service did not roll back a transaction correctly when an error occurred while performing a child table operation. This has been fixed.

5.1.0 1-UU8RF Extended copy sometimes copied some extra information along with the copied service when an adapter had two services that shared a child table. This has been fixed.

5.1.0 1-UUS5M Repeated execution of a stored procedure on DB2/AS400 led to an L517 cursor error that made the database connection unusable. This was a DataDirect defect and has been fixed.

5.1.0 1-UUS67 The adapter was unable to publish a NUMBER(p,s) column when the ActiveEnterprise type was a custom type, such as fixed.p.s and p < 10. This has been fixed.



Closed Issues | 17

5.1.0 1-VT3N4 The following error occurred when ADB_SEQUENCE handled large values(15 digit) in Sybase and the -max-rows option was used.

2003 May 29 03:13:50:483 GMT 8 seqtest.seqtest Info [Adapter] AEADB-700001 SQL: SELECT * FROM P_testnum WHERE ADB_L_DELIVERY_STATUS = 'N' AND ADB_SEQUENCE <= ? + 10 ORDER BY ADB_SEQUENCE 2003 May 29 03:13:50:484 GMT 8 seqtest.seqtest Debug [debug] AESDKC-0000 ADB_SEQUENCE = 800000000080949 2003 May 29 03:13:50:523 GMT 8 seqtest.seqtest Error [Database] AEADB-100004 Database driver code: 34y¿ Database server code: 247 Database driver message: [DataDirect][ODBC 20101 driver][SQL Server]Arithmetic overflow during implicit conversion of NUMERIC value '800000000080949' to a INT field.

This has been fixed.

5.1.0 1-XA7VP For Sybase, the adapted would crash when trying to publish a DATETIME column as a string. This has been fixed.

5.1.0 1-XIXZ6 When adding a table to the adapter, if the field's datatype was timestamp, the table would not appear. This has been fixed.

5.1.0 1-XYWNI The adapter did not decoding certain LATIN_1 characters from UTF8 correctly. This has been fixed.

5.1.0 1-YEYXS For DB2/AS400, calling a stored procedure with CHAR OUT parameters returned an illegal column type 23 error. This has been fixed.

5.1.0 1-YMAUX For DB2 on OS/390, creation of adapter objects using Add Table from Other Schema failed. This has been fixed.

5.1.0 1-YRRCS The default Hawk microagent session name could be changed. This has been fixed such that the name cannot be changed.

5.1.0 1-YV7KM For HP-UX, the adapter would terminates when TIBCO Hawk 4.0.5 was started. This has been fixed.

5.1.0 1-Z5COV On Sybase, identities had to be created with a GAP clause so the identities didn’t become large numbers when the server restarted. This has been fixed.



18 | Release Notes

5.1.0 1-ZDOMH A Rendezvous Certified Messaging (RVCM) session was created when only the reliable service was used. This has been fixed.

5.1.0 1-ZH6PD A join was performed on the parent and child table even though the foreign key was NULL. This has been fixed.

5.1.0 1-ZQUEY For DB2/OS390, the publication service update statement from 'N' to 'P' timed out with an error and the adapter shut down if the publishing table was locked for a long period. This has been fixed.

5.1.0 1-OHPZ7 If you deleted an adapter instance, it still appeared in the design panel. This has been fixed.

5.0.1 1-17O7D IBM's trigger now produces correct results when the primary key column(s) is defined as VARCHAR. It detects in the source table that the primary key has a VARCHAR column and rejects the publication setup.

5.0.1 1-41MAP If a folder containing an adapter is copied into another folder in TIBCO Designer, the design panel now correctly shows the new folder.

5.0.1 1-BNJKI When you change an existing subscription service to use an opaque table, and then change it back to a non-opaque table, an error message no longer displays when you try to save the project.

5.0.1 1-BQAB8 If a subscription service uses the opaque table format, the table name can now be modified.

5.0.1 1-C3VOP Previously, the run-time agent crashed when sending an incorrect SQL statement to the adapter. The run-time agent now displays an error message and does not crash.

5.0.1 1-JQ1HR When you open a TIBCO Adapter for ActiveDatabase 4.2 project in TIBCO Designer 5.0 and modify it, then try to run it with a TIBCO Adapter for ActiveDatabase 4.2 adapter instance, an error message no longer appears on startup.

5.0.1 1-LU40U For Sybase: the palette no longer generates an incorrect CustomOps class for a stored procedure containing output parameters.

5.0.1 1-LU41E The palette no longer allows you to manually delete the adbmetadata loadUrl entry after reopening a project.



Closed Issues | 19

5.0.1 1-MB8MF When you delete a class belonging to a service and then validate the project for deployment, the palette no longer indicates that it has found a broken reference.

5.0.1 1-MIFV0 The overwrite trigger value is now saved in the project.

5.0.1 1-O84H1 For DB2/AS400: the palette no longer displays an error when saving a publication service for which a trigger already exists in the database.

5.0.1 1-O8WMI For DB2/OS390 using the DataDirect DB2 JDBC driver: the palette can now find synonyms. (DataDirect defect logged as case #15005054.)

5.0.1 1-OQ1CY For DB2 UDB: A request-response service can now bind to a stored procedure parameter of datatype TIMESTAMP.

5.0.1 1-P0RXL When the database connection is lost, a request-response service no longer throws an error during reconnection.

5.0.1 1-P9MAU An adapter instance no longer crashes on Windows when you specify a.tra file that does not exist. (Also logged as Wrapper defect 1-NYW75.)

5.0.1 1-PUXZD When you save a TIBCO Adapter for ActiveDatabase 5.0 project as a 4.x project, and it contains a request-response service using the ActiveEnterprise wire format, an error now appears when you validate the project for deployment. This indicates (correctly) that the AE wire format is not supported in the 4.x AE configuration format.

5.0.1 1-Q7W3D An adapter instance that is copied into a folder now contains the correct subject. The endpoint and class reference are also no longer empty. (Also logged as TIBCO Designer bug 1-OZWZP.)

5.0.1 1-QCOR5 You can now publish or subscribe to non-ASCII or Latin-1 data by setting repo.encoding to UTF-8.

5.0.1 1-QQSF1 A memory leak with the RV RPC operation has been fixed.

5.0.1 1-TNN1P The error text in a subscription service reply message is now encoded correctly.

5.0.0 1-1AGXM The Create Index DDL has been improved.

5.0.0 1-1WWV9 The adapter can now automatically reconnect to the database if it loses its connection.



20 | Release Notes

5.0.0 1-2NKR1 In TIBCO Designer, you can specify a subset of tables to choose from.

5.0.0 1-41MAC Copy/Paste is no longer disabled for the Adapter Services folder, Advanced folder and Log Sinks folder (and all folders under these).

5.0.0 1-41OK9 Reset button now works in all places.

5.0.0 1-48TEY When you configure a subscription service that already exists in the database, an error dialog no longer reappears after clicking OK.

5.0.0 1-4FUHF A one-way ActiveEnterprise operation class is now supported.

5.0.0 1-4NQKX The palette now has a load schema function to describe any arbitrary table or view in the database and put its class in the Repository. This feature is used by the publish by reference object.

5.0.0 1-6FB0M For a subscription service, TIBCO Designer no longer displays the class regeneration question for the exception table when the table is first created.

5.0.0 1-6MZ7I You now use a subject prefix of _LOCAL instead of _Local to restrict messages to your local machine.

5.0.0 1-73WYP The adapter can now be installed on UNIX without X-windows.

5.0.0 1-73WZ2 The adapter can now be installed on UNIX using a regular account. Installing using the root account is still supported.

5.0.0 1-8B4DI The TIBCO Adapter for ActiveDatabase Installation Guide now explains how to prepare DB2 packages when using the DataDirect driver for DB2/OS390.

5.0.0 1-8OLAI In the Tables tab, you can now select or unselect all columns of a table for publishing or subscribing.

5.0.0 1-9ME7B For DB2/OS390: selecting a type of LONG VARGRAPHIC from a table no longer crashes the DataDirect ODBC driver.

5.0.0 1-9VDZD For DB2As400: TIBCO Designer now refreshes the connection when picking a table from a different schema.

5.0.0 1-A8XZV The Oracle DataDirect drivers no longer display a Numeric value out of range for a NUMBER(10,-2) datatype.



Closed Issues | 21

5.0.0 1-AR33X Child data can now be published when the joined key is of type STRING and the encoding is IBM-1386.

5.0.0 1-BKL35 For Oracle: the DataDirect driver now correctly returns an error when a SELECT...INTO statement in a PL/SQL procedure has no data.

5.0.0 1-BNJLJ If a project has an ActiveDatabaseAdapterConfiguration instance in a folder and you then drag a new instance to the root folder, the palette recognizes that an instance already exists in the project and correctly increments the name of the new TIBCO Adapter for ActiveDatabase instance by 1.

5.0.0 1-CWV4F TIBCO Administrator now correctly displays the state of the adapter as Running.

5.0.0 1-CWYQN For Microsoft SQL Server 2000: when configuring a publication service against any table that has a primary key or user key defined, an error message no longer appears stating that there is no key defined for the table.

5.0.0 1-CXGL2 A publication agent using the max_rows option now works when the ADB_SEQUENCE value is larger than 4300000000.

5.0.0 1-CZ9M5 For DB2/AS400: the adapter no longer truncates the last character of the string when a stored procedure contains an OUTPUT parameter using the maximum string size.

5.0.0 1-CZUWH For OracleApplications: the statement is now properly rebuilt when a column that is not set has a name that is also a prefix of one or more column names in front of it.

5.0.0 1-D28E9 After setting the encoding of the operating system, child tables are now populated with data.

5.0.0 1-D3WO7 For subscription service data errors (such as a string value being too large for a column), the exception table now truncates the string and successfully inserts it.

5.0.0 1-D4PO5 When encoding is specified for an adapter, the exception table now updates completely.



22 | Release Notes

5.0.0 1-D68BY For DB2/AS400, the palette now checks that the table portion of a schema.table name is 18 characters or less, instead of checking that the entire schema.table name is 18 characters or less.

5.0.0 1-DBWKB For Oracle: the adapter now supports Oracle Functions in request-response mode.

5.0.0 1-DFMLK For Oracle: the adapter now SJIS encoded strings into an Oracle database that has an SJIS character set. It no longer inserts a UTF-8 encoded string.

5.0.0 1-DKHAS An adapter publisher can now be configured to send a message with a response subject.

5.0.0 1-DRZPS Adding a preregistered listener now correctly displays %%Domain%%.%%Deployment%%.adb.%%InstanceId%%.CM.

5.0.0 1-DUPQO For Oracle: an Oracle synonym can now be configured for publication and subscription services using the DataDirect JDBC driver.

5.0.0 1-DUPR1 Opening a TIBCO Adapter for ActiveDatabase 4.0.1 project in 4.2.0 no longer results in adapter services disappearing after saving, exiting and opening again.

5.0.0 1-DYXCC For SequeLink: the documentation now contains the correct URL for downloading the SequeLink ODBC Drivers.

5.0.0 1-E5U3D For DB2/AS400: Loading a connection from a user connection no longer changes the AS400 library to the default.

5.0.0 1-EH9Z1 For Oracle on Solaris: a publication service no longer crashes on Solaris 2.7 when using an Oracle wire driver.

5.0.0 1-EOCWT In the documentation, the UniqueIdentifier data type is correctly identified as supported.

5.0.0 1-FVQ00 For Sybase: when a publication service publishes a Sybase datetime field with a millisecond part, all values are now accurate.

5.0.0 1-FWO8L For DB2/AS400: an adapter using the ActiveEnterprise wire format can now return a result set from a stored procedure.

5.0.0 1-GAEJO After starting two adapter services from command lines that specified -system:instanceid and -system:configurl, the second agent no longer terminates with a Duplicate Agent Found error.



Closed Issues | 23

5.0.0 1-GBMWO A publication service can now publish child data with UTF8 encoding.

5.0.0 1-GSE01 A subscription service no longer truncates the child table key field by one character when using UTF8 encoding.

5.0.0 1-H0LHF An adapter using the DataDirect wire protocol driver no longer performs a core dump after updating a view.

5.0.0 1-HNSFM DataDirect ODBC drivers can now use UTF8 encoding.

5.0.0 1-HQYXL An RVCM request-response session is now created only when using the RVCM request-response service.

5.0.0 1-I3FKL TIBCO Designer is now installed and uninstalled separately from the adapter. After uninstalling the adapter, Designer remains available in the Start>Programs>TIBCO menu.

5.0.0 1-I80L9 For Oracle: an adapter service using the Oracle ODBC driver can now return Oracle REF cursors from a stored procedure.

5.0.0 1-I80MY Oracle ODBC drivers 8.1.5.7 and 8.1.6.4 can now use the sub-bulk-insert-size property.

5.0.0 1-IQY9F The documentation now correctly states that the endpoint reference for publication and subscription services is selected from a drop-down menu but the values are not editable.

5.0.0 1-JRE3C For Sybase: an error no longer occurs when executing a stored procedure using SELECT INTO.

5.0.0 1-KFNIP DB2/OS390 only: The documentation now contains instructions for making the ODBC driver return the retrieved data from a request-response operation.

5.0.0 1-KV2W1 For DB2/AS400: the adapter now properly detects a lost connection.

5.0.0 1-KV2WM An adapter using the ActiveEnterprise wire format can now bind table and column names outside the current schema.

5.0.0 1-ME683 CHAR parameters can now be bound in a stored procedure.

5.0.0 1-MIFV0 The overwrite Triggers value is now saved in the Repository.



24 | Release Notes

5.0.0 1-MIN0X In the documentation, the screen captures in the Setting Request-Response Service Configuration Options section now match the text.

5.0.0 1-MRWLD An adapter publication service can now fetch child data when encoding is set other than LATIN_1.

5.0.0 1-NEU4Q A subscription service no longer reports an integrity constraint error message (CLIENT.SYS_C009592) when the property values -sub-bulk-insert-size: 1000 and -sub-batch-commit-size: 1000 are used to start the service.

5.0.0 1-NSRXS The documentation now contains detailed information about how agents behave when a sub-bulk-insert command fails.

5.0.0 1-O2COD A subscription service configured to use JMS transport had a memory leak. This has been fixed in TRA 33 patch 1.

5.0.0 1-O8WM5 The DTA now supports alias.

5.0.0 1-Q76UE The documentation now states the correct value (30 KB) for the default trace file size.



Known Issues | 25

Known Issues

The table in this section lists product defects known in this release.

Defect # Summary/Workaround

1-15BVU7 Summary If the adapter is using encoding ibm-950, and polls a large amount of records (2000+), the adapter will terminate.

Workaround Set the Polling Batch Size to a value- less then 2000. The field is available in Designer under the Adapter Services tab.

1-19YVXS Summary Latin-1 message encoding is not supported for the JMS and Rendezvous transports when configured to use the XML message wire format.

Workaround To use the XML message wire format, the default message encoding, Latin-1 (ISO8859-1) must be changed to UTF-8. Otherwise, use the Rendezvous transport configured with ActiveEnterprise message wire format. It supports both UTF-8 and Latin-1 message encodings.

The message encoding property is set on the project itself at design-time, and when creating a TIBCO administration domain. The default for both is ISO8859-1.

• To change the message encoding on the project, select the root folder and, under the Project Settings tab, change the value for the TIBCO Message Encoding field. This affects only projects used with Adapter Tester, BusinessWorks Tester and projects exported to local repositories.

• To change the message encoding for the administration domain, edit the repo.encoding property in the administration server's tibcoadmin<domain-name>.tra configuration file, which is located in <install-path>/tibco/administrator/n.n/bin. This affects all projects managed by the administration server.

1-1KQ3W Summary For DB2/OS390, a TIBCO Adapter for ActiveDatabase subscription service cannot insert a message into the opaque table.

Workaround None.

1-1M5TT Summary The adapter does not respond to the TERMINATE message when the adb.rvMaxQueueSize limit is reached.

Workaround On Windows, use the Task Manager to kill the adbagent process. On UNIX, use kill -9 to kill the adbagent process.


26 | Release Notes

1-3WB35 Summary If you have saved a project in TIBCO Designer, then click on an adapter folder icon, then try to close the project, you will see a message prompting you to save your changes even though you have not made any changes.

Workaround Ignore the message and close without saving, or click Save.

1-4LN1V Summary For Oracle, a subscription service inserts the wrong value for an r4 type column.

Workaround Use the r8 type instead of r4.

1-BBRMU Summary For Sybase, while TIBCO Adapter for ActiveDatabase is running, if you drop and then recreate a destination table that is part of a cached child select statement in a parent-child relationship, and you are using the DataDirect Sybase wire protocol driver, the subscription service displays an error. This does not happen with cached child non-select statements. (Also logged as DataDirect defect 15006332)

Workaround On Windows, use the Sybase ODBC driver. On Unix, restart the adapter. Then remove the cached child select statement.

1-EOCYB Summary TIBCO Adapter for ActiveDatabase does not support CLOB as an IN parameter. (DataDirect defect logged as case #15003605.)

Workaround None.

1-HVLVI Summary After you enter information for a publication service child table in the Child Table Mappings tab, the Apply button is not enabled.

Workaround Press ENTER or TAB after typing in the changes, or click on the Subscriber Child Table Name value to change the focus. This enables the Apply button.

1-ITDSX Summary DataDirect driver takes up to one minute to describe a procedure on databases that contain many procedures. (DataDirect defect logged as case #15004808.)

Workaround None.

1-LU40G Summary For Oracle: A request-response service terminates with an exception when calling an Oracle stored procedure consisting of an IN OUT parameter that is a LONG datatype, when the input value is shorter than the output value.

Workaround None.

Defect # Summary/Workaround (Cont’d)


Known Issues | 27

1-Q9F6P Summary For Windows: adding instances of RVCMQ subscribers does not improve the message rate, although the messages are load-balanced across all the instances.

Workaround None.

1-XHA8 Summary For Oracle: TIBCO Adapter for ActiveDatabase has a precision limitation of 15 on the unconstrained NUMBER type.

Workaround Specify a constraining number type: NUMBER(38), NUMBER(38,10), etc.

1-XYUBO Summary If you first pick a table to be a destination table and then pick the same table to be a source table with loop detection, the palette first creates the class of the destination without ADB_SOURCE and then does not modify the class to add ADB_SOURCE after the source table is altered to have an ADB_SOURCE column, causing loop detection to fail.

Workaround Manually add ADB_SOURCE as an attribute to the destination table class and loop detection will work.

Defect # Summary/Workaround (Cont’d)


28 | Release Notes


Tib Adadb Release Notes

Documents

microsoft

adapters standard

activedatabase

adapters class

activedatabase

activedatabase

adapters subscription

oracle odbc