TIBCO Adapter for ActiveDatabase Release Notes

Software Release 5.1.0 November 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 USERS 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 TIBCO 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

TIBCO Adapter for ActiveDatabase Release Notes

|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

TIBCO Adapter for ActiveDatabase Release Notes

Release Notes

New Features
This section lists new features added since the last major release of this product. Introduced in Release 5.1.0 Feature
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: 5.1.0 Red Hat Linux AS 2.1 Solaris 9 Windows 2003

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.

TIBCO Adapter for ActiveDatabase Release Notes

New Features 3

Introduced in Release 5.0.1

Feature (Contd) Added Platform Support 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 Users 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.

5.0.0

Added Platform Support Support for AIX 5.1 has been added.

TIBCO Adapter for ActiveDatabase Release Notes

Release Notes

Introduced in Release 5.0.0

Feature (Contd) 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.

TIBCO Adapter for ActiveDatabase Release Notes

Changes in Functionality 5

Changes in Functionality
This section lists changes in functionality since the last major release of this product. Changed in Release 5.1.0 Functionality
Changed TIBCO Hawk Methods

The following TIBCO Hawk methods have changed parameters and are now available in the adapters 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 adapters palette for backward compatibility with previous adapter releases.

TIBCO Adapter for ActiveDatabase Release Notes

Release Notes

Changed in Release 5.1.0

Functionality (Contd)
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 adapters property file. The property is not set by default. Setting the property to off disallows adding custom methods to the adapters standard microagent. Setting to on allows custom methods to be added to the adapters 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.

TIBCO Adapter for ActiveDatabase Release Notes

Changes in Functionality 7

Changed in Release 5.0.0

Functionality (Contd) 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)

TIBCO Adapter for ActiveDatabase Release Notes

Release Notes

Changed in Release 5.0.0

Functionality (Contd) 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

TIBCO Adapter for ActiveDatabase Release Notes

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 5.1.0 Feature
Deprecated feature The following 5.0.1 and earlier TIBCO Hawk methods available in the adapters custom microagent have been deprecated:
getActivityStatistics() getActivityStatisticsByOperation() getActivityStatisticsBySchema() getActivityStatisticsByService() getThreadStatistics() getQueueStatistics() getConnectionStatistics()

Equivalent functionality

The above methods are now available in the adapters 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.

TIBCO Adapter for ActiveDatabase Release Notes

10

Release Notes

Deprecated in Release 5.1.0

Feature
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 adapters properties file.

TIBCO Adapter for ActiveDatabase Release Notes

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. Make a backup copy of the project you are migrating to ActiveEnterprise 5.0 before starting the migration process.

TIBCO IntegrationManager 4.x Engines and Adapter 5.x RPC Servers

A 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. Operation created in which version of TIBCO Adapter for ActiveDatabase? Operation saved in which TIBCO ActiveEnterprise RPC server configuration format? Can a process created in IM 4.x run this operation? Can a process created in IM 5.x run this operation? ADB 4.x AE 4.x Yes Yes ADB 4.x AE 5.x Yes Yes ADB 5.x AE 4.x No Yes ADB 5.x AE 5.x No Yes

TIBCO Adapter for ActiveDatabase Release Notes

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.

TIBCO Adapter for ActiveDatabase Release Notes

Closed Issues 13

Closed Issues
This section lists product defects that were closed in the named release. Closed in Release 5.1.0 5.1.0 Defect # 1-11XWM4 1-17S6F5 Summary The adapter attempted to create a Hawk dispatcher thread even when the HawkEnabled property was set to false. This has been fixed. 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. The adapter request-response service when configured to use the JMS transport has a memory leak. This has been fixed. On DB2, when short names were used for columns the generated triggers were not referencing the short names correctly. This has been fixed. 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. 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. On Linux, the adapters subscription service was unable to read strings from a message when the adb.encoding was set to LATIN_1. This has been fixed. The adapter would flush the 'P' to 'C' update statements when no new confirmations arrived for that publishing table. This has been fixed. 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. 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.

5.1.0 5.1.0

1-1ARXTJ 1-ZHKO5

5.1.0

1-11P3SD

5.1.0

1-17Q4DF

5.1.0

1-1C2PRR

5.1.0 5.1.0

1-1AWPYV 1-PPMM9

5.1.0

1-119DRK

TIBCO Adapter for ActiveDatabase Release Notes

14

Release Notes

Closed in Release 5.1.0

Defect # 1-11ISMY

Summary (Contd) 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. The adapter did not recognize a list of preregistered listeners separated by commas when specified in TIBCO Designer. This has been fixed. The adapters subscription services inserted NULL values for fields using the custom type fixed.p.s. This has been fixed. 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. The adapter did not report Rendezvous error advisories in the errorRole. This has been fixed. The adapters request-response service did not attempt to reconnect to the database even though the service was configured to do so. This has been fixed. 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. The adapters request-response service would corrupt the date time field. This has been fixed. 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. The OPAQUE wire format did not work correctly. This has been fixed. 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.

5.1.0 5.1.0 5.1.0

1-11ISO1 1-12SXH3 1-13M3PH

5.1.0 5.1.0

1-13X4F5 1-152BD9

5.1.0

1-16PRLT

5.1.0 5.1.0

1-1802A8 1-18D763

5.1.0 5.1.0

1-198HJV 1-1A6J1A

TIBCO Adapter for ActiveDatabase Release Notes

Closed Issues 15

Closed in Release 5.1.0

Defect # 1-1OZAL

Summary (Contd) 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. The palette did not allow editing capabilities to its configuration when the underlying table definitions changed in the database. This has been fixed. You could not update triggers if using Microsoft SQL Server. This has been fixed. 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. 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. 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. For a request-response service, you could not create a request that used bind information from two tables. This has been fixed. 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. For Oracle, the DataDirect Oracle native driver and Oracle ODBC driver could not execute a procedure through a synonym. This has been fixed. When inserting a NULL value into a table, you could not use two single quotes to specify NULL ( ). This has been fixed. 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.

5.1.0

1-5HHHP

5.1.0 5.1.0

1-9HAUQ 1-A8XZK

5.1.0

1-BBRNR

5.1.0

1-BPI5M

5.1.0 5.1.0

1-DQK7O 1-FWO7D

5.1.0 5.1.0 5.1.0

1-G3YZL 1-I80LU 1-IMLCX

TIBCO Adapter for ActiveDatabase Release Notes

16

Release Notes

Closed in Release 5.1.0

Defect # 1-T9CAR

Summary (Contd) 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. 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. 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.

5.1.0

1-UEAX3

5.1.0

1-UM2SX

The problems have been fixed. 5.1.0 1-UT06M The adapters subscription service did not roll back a transaction correctly when an error occurred while performing a child table operation. This has been fixed. 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. 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. 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.

5.1.0

1-UU8RF

5.1.0

1-UUS5M

5.1.0

1-UUS67

TIBCO Adapter for ActiveDatabase Release Notes

Closed Issues 17

Closed in Release 5.1.0

Defect # 1-VT3N4

Summary (Contd) 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 5.1.0 5.1.0 5.1.0 5.1.0 5.1.0 5.1.0 5.1.0 1-XA7VP 1-XIXZ6 1-XYWNI 1-YEYXS 1-YMAUX 1-YRRCS 1-YV7KM 1-Z5COV For Sybase, the adapted would crash when trying to publish a DATETIME column as a string. This has been fixed. When adding a table to the adapter, if the field's datatype was timestamp, the table would not appear. This has been fixed. The adapter did not decoding certain LATIN_1 characters from UTF8 correctly. This has been fixed. For DB2/AS400, calling a stored procedure with CHAR OUT parameters returned an illegal column type 23 error. This has been fixed. For DB2 on OS/390, creation of adapter objects using Add Other Schema failed. This has been fixed.
Table from

The default Hawk microagent session name could be changed. This has been fixed such that the name cannot be changed. For HP-UX, the adapter would terminates when TIBCO Hawk 4.0.5 was started. This has been fixed. On Sybase, identities had to be created with a GAP clause so the identities didnt become large numbers when the server restarted. This has been fixed.

TIBCO Adapter for ActiveDatabase Release Notes

18

Release Notes

Closed in Release 5.1.0 5.1.0 5.1.0

Defect # 1-ZDOMH 1-ZH6PD 1-ZQUEY

Summary (Contd) A Rendezvous Certified Messaging (RVCM) session was created when only the reliable service was used. This has been fixed. A join was performed on the parent and child table even though the foreign key was NULL. This has been fixed. 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. If you deleted an adapter instance, it still appeared in the design panel. This has been fixed. 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. If a folder containing an adapter is copied into another folder in TIBCO Designer, the design panel now correctly shows the new folder. 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. If a subscription service uses the opaque table format, the table name can now be modified. 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. 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. For Sybase: the palette no longer generates an incorrect CustomOps class for a stored procedure containing output parameters. The palette no longer allows you to manually delete the adbmetadata loadUrl entry after reopening a project.

5.1.0 5.0.1

1-OHPZ7 1-17O7D

5.0.1 5.0.1

1-41MAP 1-BNJKI

5.0.1 5.0.1

1-BQAB8 1-C3VOP

5.0.1

1-JQ1HR

5.0.1 5.0.1

1-LU40U 1-LU41E

TIBCO Adapter for ActiveDatabase Release Notes

Closed Issues 19

Closed in Release 5.0.1

Defect # 1-MB8MF

Summary (Contd) 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. The overwrite trigger value is now saved in the project. For DB2/AS400: the palette no longer displays an error when saving a publication service for which a trigger already exists in the database. For DB2/OS390 using the DataDirect DB2 JDBC driver: the palette can now find synonyms. (DataDirect defect logged as case #15005054.) For DB2 UDB: A request-response service can now bind to a stored procedure parameter of datatype TIMESTAMP. When the database connection is lost, a request-response service no longer throws an error during reconnection. 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.) 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. 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.) You can now publish or subscribe to non-ASCII or Latin-1 data by setting repo.encoding to UTF-8. A memory leak with the RV RPC operation has been fixed. The error text in a subscription service reply message is now encoded correctly. The Create Index DDL has been improved. The adapter can now automatically reconnect to the database if it loses its connection.

5.0.1 5.0.1 5.0.1 5.0.1 5.0.1 5.0.1 5.0.1

1-MIFV0 1-O84H1 1-O8WMI 1-OQ1CY 1-P0RXL 1-P9MAU 1-PUXZD

5.0.1

1-Q7W3D

5.0.1 5.0.1 5.0.1 5.0.0 5.0.0

1-QCOR5 1-QQSF1 1-TNN1P 1-1AGXM 1-1WWV9

TIBCO Adapter for ActiveDatabase Release Notes

20

Release Notes

Closed in Release 5.0.0 5.0.0 5.0.0 5.0.0 5.0.0 5.0.0

Defect # 1-2NKR1 1-41MAC 1-41OK9 1-48TEY 1-4FUHF 1-4NQKX

Summary (Contd) In TIBCO Designer, you can specify a subset of tables to choose from. Copy/Paste is no longer disabled for the Adapter Services folder, Advanced folder and Log Sinks folder (and all folders under these). Reset button now works in all places. When you configure a subscription service that already exists in the database, an error dialog no longer reappears after clicking OK. A one-way ActiveEnterprise operation class is now supported. 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. For a subscription service, TIBCO Designer no longer displays the class regeneration question for the exception table when the table is first created. You now use a subject prefix of _LOCAL instead of _Local to restrict messages to your local machine. The adapter can now be installed on UNIX without X-windows. The adapter can now be installed on UNIX using a regular account. Installing using the root account is still supported. The TIBCO Adapter for ActiveDatabase Installation Guide now explains how to prepare DB2 packages when using the DataDirect driver for DB2/OS390. In the Tables tab, you can now select or unselect all columns of a table for publishing or subscribing. For DB2/OS390: selecting a type of LONG VARGRAPHIC from a table no longer crashes the DataDirect ODBC driver. For DB2As400: TIBCO Designer now refreshes the connection when picking a table from a different schema. The Oracle DataDirect drivers no longer display a Numeric for a NUMBER(10,-2) datatype.
value out

5.0.0

1-6FB0M

5.0.0 5.0.0 5.0.0 5.0.0

1-6MZ7I 1-73WYP 1-73WZ2 1-8B4DI

5.0.0 5.0.0 5.0.0 5.0.0

1-8OLAI 1-9ME7B 1-9VDZD 1-A8XZV

of range

TIBCO Adapter for ActiveDatabase Release Notes

Closed Issues 21

Closed in Release 5.0.0 5.0.0 5.0.0

Defect # 1-AR33X 1-BKL35 1-BNJLJ

Summary (Contd) Child data can now be published when the joined key is of type STRING and the encoding is IBM-1386. For Oracle: the DataDirect driver now correctly returns an error when a SELECT...INTO statement in a PL/SQL procedure has no data. 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. TIBCO Administrator now correctly displays the state of the adapter as Running. 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. A publication agent using the max_rows option now works when the ADB_SEQUENCE value is larger than 4300000000. 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. 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. After setting the encoding of the operating system, child tables are now populated with data. 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. When encoding is specified for an adapter, the exception table now updates completely.

5.0.0 5.0.0

1-CWV4F 1-CWYQN

5.0.0 5.0.0

1-CXGL2 1-CZ9M5

5.0.0

1-CZUWH

5.0.0 5.0.0

1-D28E9 1-D3WO7

5.0.0

1-D4PO5

TIBCO Adapter for ActiveDatabase Release Notes

22

Release Notes

Closed in Release 5.0.0

Defect # 1-D68BY

Summary (Contd) 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. For Oracle: the adapter now supports Oracle Functions in request-response mode. 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. An adapter publisher can now be configured to send a message with a response subject. Adding a preregistered listener now correctly displays
%%Domain%%.%%Deployment%%.adb.%%InstanceId%%.CM.

5.0.0 5.0.0 5.0.0 5.0.0 5.0.0 5.0.0

1-DBWKB 1-DFMLK 1-DKHAS 1-DRZPS 1-DUPQO 1-DUPR1

For Oracle: an Oracle synonym can now be configured for publication and subscription services using the DataDirect JDBC driver. 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. For SequeLink: the documentation now contains the correct URL for downloading the SequeLink ODBC Drivers. For DB2/AS400: Loading a connection from a user connection no longer changes the AS400 library to the default. For Oracle on Solaris: a publication service no longer crashes on Solaris 2.7 when using an Oracle wire driver. In the documentation, the UniqueIdentifier data type is correctly identified as supported. For Sybase: when a publication service publishes a Sybase datetime field with a millisecond part, all values are now accurate. For DB2/AS400: an adapter using the ActiveEnterprise wire format can now return a result set from a stored procedure. After starting two adapter services from command lines that specified and -system:configurl, the second agent no longer terminates with a Duplicate Agent Found error.

5.0.0 5.0.0 5.0.0 5.0.0 5.0.0 5.0.0 5.0.0

1-DYXCC 1-E5U3D 1-EH9Z1 1-EOCWT 1-FVQ00 1-FWO8L 1-GAEJO

-system:instanceid

TIBCO Adapter for ActiveDatabase Release Notes

Closed Issues 23

Closed in Release 5.0.0 5.0.0 5.0.0 5.0.0 5.0.0 5.0.0

Defect # 1-GBMWO 1-GSE01 1-H0LHF 1-HNSFM 1-HQYXL 1-I3FKL

Summary (Contd) A publication service can now publish child data with UTF8 encoding. A subscription service no longer truncates the child table key field by one character when using UTF8 encoding. An adapter using the DataDirect wire protocol driver no longer performs a core dump after updating a view. DataDirect ODBC drivers can now use UTF8 encoding. An RVCM request-response session is now created only when using the RVCM request-response service. TIBCO Designer is now installed and uninstalled separately from the adapter. After uninstalling the adapter, Designer remains available in the Start>Programs>TIBCO menu. For Oracle: an adapter service using the Oracle ODBC driver can now return Oracle REF cursors from a stored procedure. Oracle ODBC drivers 8.1.5.7 and 8.1.6.4 can now use the sub-bulk-insert-size property. 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. For Sybase: an error no longer occurs when executing a stored procedure using SELECT INTO. DB2/OS390 only: The documentation now contains instructions for making the ODBC driver return the retrieved data from a request-response operation. For DB2/AS400: the adapter now properly detects a lost connection. An adapter using the ActiveEnterprise wire format can now bind table and column names outside the current schema. CHAR parameters can now be bound in a stored procedure. The overwrite Triggers value is now saved in the Repository.

5.0.0 5.0.0 5.0.0

1-I80L9 1-I80MY 1-IQY9F

5.0.0 5.0.0

1-JRE3C 1-KFNIP

5.0.0 5.0.0 5.0.0 5.0.0

1-KV2W1 1-KV2WM 1-ME683 1-MIFV0

TIBCO Adapter for ActiveDatabase Release Notes

24

Release Notes

Closed in Release 5.0.0

Defect # 1-MIN0X

Summary (Contd) In the documentation, the screen captures in the Setting Request-Response Service Configuration Options section now match the text. An adapter publication service can now fetch child data when encoding is set other than LATIN_1. 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. The documentation now contains detailed information about how agents behave when a sub-bulk-insert command fails. A subscription service configured to use JMS transport had a memory leak. This has been fixed in TRA 33 patch 1. The DTA now supports alias. The documentation now states the correct value (30 KB) for the default trace file size.

5.0.0 5.0.0

1-MRWLD 1-NEU4Q

5.0.0 5.0.0 5.0.0 5.0.0

1-NSRXS 1-O2COD 1-O8WM5 1-Q76UE

TIBCO Adapter for ActiveDatabase Release Notes

Known Issues 25

Known Issues
The table in this section lists product defects known in this release. Defect # 1-15BVU7 Summary/Workaround
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. to kill the adbagent process.

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

On UNIX, use kill

-9

TIBCO Adapter for ActiveDatabase Release Notes

26

Release Notes

Defect # 1-3WB35

Summary/Workaround (Contd)
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.

TIBCO Adapter for ActiveDatabase Release Notes

Known Issues 27

Defect # 1-Q9F6P

Summary/Workaround (Contd)
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.

TIBCO Adapter for ActiveDatabase Release Notes

28

Release Notes

TIBCO Adapter for ActiveDatabase Release Notes