TIBCO ActiveMatrix® Adapter

for Database
Release Notes
Software Release 6.0.0
April 2009
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 LICENSE.PDF) OR IF THERE IS NO SUCH SOFTWARE
LICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT, THE LICENSE(S) LOCATED
IN THE “LICENSE” FILE(S) OF THE SOFTWARE. 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, TIBCO Adapter, Predictive Business, Information Bus, The Power of Now, TIBCO ActiveMatrix
BusinessWorks, TIBCO Rendezvous, TIBCO Administrator, TIBCO Designer, TIBCO Runtime Agent, TIBCO
Hawk, TIBCO Enterprise Message Service, TIBCO Designer Add-in for TIBCO Business Studio, TIBCO
ActiveMatrix Service Grid, TIBCO ActiveMatrix Service Bus, TIBCO ActiveMatrix BusinessWorks Service
Engine, and TIBCO Business Studio are either registered trademarks or trademarks of TIBCO Software Inc. in
the United States and/or other countries.
EJB, Java EE, J2EE, 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. 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.
THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY OR
INDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE, INCLUDING
BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES.
Copyright © 1999-2009 TIBCO Software Inc. ALL RIGHTS RESERVED.
TIBCO Software Inc. Confidential Information
 | iii

Contents

Release Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
New Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Changes in Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Deprecated Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Compatibility and Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Closed Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Known Issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

TIBCO ActiveMatrix Adapter for Database Release Notes

iv
| Contents

TIBCO ActiveMatrix Adapter for Database 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 4
• Deprecated Features, page 5
• Compatibility and Migration, page 6
• Closed Issues, page 7
• Known Issues, page 11

TIBCO ActiveMatrix Adapter for Database Release Notes

2 Release Notes
|

New Features

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

Introduced in
Release Feature

6.0.0 Added Database Support

This release of the adapter adds support for the following databases:
— DB2 v9.1 and v9.5 on Microsoft Windows and Unix platforms.

6.0.0 Added Platform Support

This release of the adapter adds support for the following platforms:
— Microsoft Windows Server 2008 (x86)
— RedHat Enterprise Linux 4.6, 4.7, 5.0, 5.1, and 5.2 (x86)
— Solaris 10 (x86)
— AIX 6.1 (POWER)

6.0.0 Duplicate Agent Detection

Duplicate adapter instances are now detected when using either default JMS or
RV sessions.

6.0.0 Database Reconnection for Fault Tolerance

This release adds support for reconnecting to a database when the adapter is
used in the fault tolerance mode.

6.0.0 Monitoring Polling Activities

Polling activities of the adapter publication services can now be used
monitored using the TIBCO Hawk getActivityStatistics method.

TIBCO ActiveMatrix Adapter for Database Release Notes

 New Features 3
|

Introduced in Feature
Release
6.0.0 Additional TRA Properties
The following new TRA properties have been added:
• adb.setClientInfo: This property is used to control whether the adapters sets
the database session client information.
• adb.createMutexTable: When set to off, the adapter does not create the
mutex table that is used in the fault tolerance mode.
• adb.primary.heartbeat and adb.secondary.heartbeat: These properties are
used by the adapter when running in the fault tolerant mode.
• adb.maxQuery: The maximum number of queries the secondary instance
would send to the primary to determine if the primary instance is still
active.
• adb.customScaleforNumberType: This property sets the default scale of
Oracle Number (empty) datatype.
• adb.useBetweenClause: This property disables the use of the BETWEEN
clause in the select query of the publisher.
See TIBCO ActiveMatrix Adapter for Database Configuration and Deployment for
more information.

TIBCO ActiveMatrix Adapter for Database Release Notes

4 Release Notes
|

Changes in Functionality

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

Changed in
Release Functionality

6.0.0 Dropped Platform Support

The following platforms are no longer supported:
— Microsoft Windows 2000 (x86)
— AIX 5.1

6.0.0 TIBCO IntegrationManager is no longer supported.

TIBCO ActiveMatrix Adapter for Database Release Notes

 Deprecated Features 5
|

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

6.0.0 There are no deprecated features.

TIBCO ActiveMatrix Adapter for Database Release Notes

6 Release Notes
|

Compatibility and Migration

See the TIBCO Runtime Agent documentation for information on how the
adapter interoperates with previous adapter versions and other TIBCO
applications.

TIBCO ActiveMatrix Adapter for Database Release Notes

 Closed Issues 7
|

Closed Issues

This section lists product defects that were closed in the named release.
Additionally refer to the TIBCO Adapter SDK release notes for closed runtime
issues.

Closed in
Release Defect # Summary

6.0.0 1-94M5AC For a parent child operation, under certain circumstances, the adapter
Subscription service inserted incorrect data in the child and
grandchild exception table.
This has been fixed.

6.0.0 1-9CBDXN (Microsoft Windows and Solaris only) The adapter was unable to
connect to the Oracle database when the database is in a restricted
mode.
This has been fixed.

6.0.0 1-9DP9WN (Sybase only) When running in the fault tolerance mode, the adapter
threw an error during initialization when the ddl in TRAN database
option was set to false.
This has been fixed.

6.0.0 1-593C5P Executing the setPollingBatchSize Hawk method while the

adapter was publishing messages would result in errors and the
adapter would terminate.
This has been fixed.

6.0.0 1-8XK2B3 (Microsoft SQL Server only) When the ADB_SEQUENCE value
exceeded 8 digits, the adapter terminated and generated the following
error message:
ADBPubCommunicationInterface::handleDataSendRequest().
This has been fixed.

6.0.0 1-90S5BN (Microsoft SQL Server 2005 only) The adapter did not publish the
correct unicode values for NVARCHAR/NCHAR/NTEXT column.
This has been fixed.

TIBCO ActiveMatrix Adapter for Database Release Notes

8 Release Notes
|

Closed in Defect # Summary

Release
6.0.0 1-917PD7 (DB2 AS40 only) The adapter subscriber did not insert rows into
opaque exception table when an error occurred.
This has been fixed.

6.0.0 1-92CXOV The adapter did not terminate when it failed to reconnect to the EMS
Server.
This has been fixed.

6.0.0 1-92YZCB For the request-response service using ASCII encoding, the adapter
returned invalid values for CHAR/VARCHAR columns.
The adapter also returned incorrect row counts when the binding
parameter type was not NUMBER.
This has been fixed.

6.0.0 1-930PE5 The adb.wchar setting did not take effect, the adapter always set it to
SQL_C_BINARY when adb.encoding setting was UTF8 and
SQL_C_CHAR when adb.encoding was not UTF8. This has been
fixed.

6.0.0 1-95OT8Y The adapter fault tolerance mode was not displayed in TIBCO
Administrator.
This has been fixed. An Application Mode entry is added to the host
information to display the fault tolerance mode (primary or
secondary) of the adapter instance.

6.0.0 1-97NI8N (DB2 Only) The publication service throws a Function sequence
error ODBC error when the parent-child join column type was
BIGINT.
This has been fixed.

6.0.0 1-9C4B7T For request-response service, the adapter corrupted the last character
if the binding parameter is of CHARACTER type.
This has been fixed.

TIBCO ActiveMatrix Adapter for Database Release Notes

 Closed Issues 9
|

Closed in Defect # Summary

Release
6.0.0 1-9CND7H The adapter inserted incorrect values when the input data of a
TIMESTAMP WITH TIMEZONE column contained timezone
information, which is not supported.
This has been fixed. The adapter will return an error when the input
data contains timezone information. The timezone information can be
parsed using the TIBCO BusinessWorks XPath functionality before
passing it to the adapter.

6.0.0 1-9E5BER (Microsoft SQL Server only) For the request-response service, the
adapter truncated the last character of the stored procedure
parameters.
This has been fixed.

6.0.0 1-8WXUNI For the Request-Response service, if the request response thread count
was set to greater than one, the adapter terminated if the incoming
request message rate was high.
This has been fixed.

6.0.0 1-8O3JC0 (Sybase only) For the parent child publication if there were more than
one parent-child objects in the database to be published, only the first
parent-child object was published correctly.
The adapter only fetched and published the parent row of the
remaining parent-child objects.
This has been fixed.

6.0.0 1-8TQ19N (For Oracle, DB2, and Sybase only) When running in the fault
tolerance mode the agent terminated at startup if the adapter did not
have privileges required to create tables.
This has been fixed.

6.0.0 1-8ZNC1R When running in the fault tolerance mode, if you did not have
privileges to select a table for the mutex table, the adapter would
terminate with an incorrect error message Create table permission
denied.

This has been fixed.

6.0.0 1-8Z0JO4 (DB2 OS390 only) The adapter failed to create the mutex table because
it swapped the DB2 tablespace name with the database name.
This has been fixed.

TIBCO ActiveMatrix Adapter for Database Release Notes

10 Release Notes
|

Closed in Defect # Summary

Release
6.0.0 1-9F7J1W (DB2 Only) On Windows, the adapter would publish or subscribe to
corrupted data if the Table CCSID used 1025 (Russian character sets).
This has been fixed.

6.0.0 1-9NWYXF The bind23 executable of the ODBC Driver could not be executed as
it was linked to a wrong library.
This is now fixed.

6.0.0 1-8Y2XTP (Microsoft SQL Server only) When running in the fault tolerance
mode, the secondary instance would create a new database connection
when it issued an exclusive lock on the mutex table. The number of
database connections would continue to increase.
This has been fixed.

TIBCO ActiveMatrix Adapter for Database Release Notes

 Known Issues 11
|

Known Issues

The table in this section lists product defects known in this release.
Additionally refer to the TIBCO Adapter SDK release notes for known runtime
issues.

Defect # Summary/Workaround
1-9MQW2S Summary (DB2 Only) The request response service throw an error and
terminate when the executing a stored procedure with CLOB parameter.
Workaround None.

1-9HZU2L Summary When the adapter is running in fault tolerance mode using RV
certified QOS, the subscription and request-response service of the secondary
instance will receive duplicate messages that are already confirmed by the
primary instance.
Workaround Use RV reliable or JMS transport to avoid duplicate messages.

1-9JXD1V Summary (Oracle Only) The ADB_TIMESTAMP column in the publishing table
is of type TIMESTAMP WITH TIME ZONE, but the generated update and
delete trigger inserts SYSDATE instead of SYSTIMESTAMP into the publishing
table.
Workaround Open the generated SQL script and make the corrections in the
delete trigger creation scripts and execute the script again.

1-9MBXPL Summary (DB2 Only) The custom RPC operation configuration wizard cannot
select functions in the database, so you cannot use custom RPC operations to
execute DB2 functions.
Workaround Use Standard RPC operations.

1-9LYAR4 Summary When the adapter is running in the fault tolerance mode using
RVCMQ certified QOS, after the secondary instance become primary, it might
receive the last message confirmed by the primary instance.
Workaround Use RV reliable or JMS transport to avoid duplicate messages.

TIBCO ActiveMatrix Adapter for Database Release Notes

12 Release Notes
|

Defect # Summary/Workaround
1-9JWG1X Summary (SQL Server only) If the input of the stored procedure is NCHAR and
the input string contains odd number of characters, the adapter will hang when
(Datadirect
executing the procedure. If the input string contains an odd number of
defect
characters, the adapter will return an driver error:
DD00044883)
The incoming tabular data stream (TDS) remote procedure call
(RPC) protocol stream is incorrect.

Workaround Use the NVARCHAR parameter type.

1-99070Y Summary When the adapter encounters a deadlock error (ODBC Error Code =
40001) while fetching the child record, the adapter sometimes publishes an
(Datadirect
empty child record instead of reconnecting.
defect:
DD00045088) Workaround Use the Sybase native driver.

1-9NHHT1 Summary (Microsoft SQL Server 2005 Only) When the username is the same as
the database name, the alerter cannot reconnect to the database and returns the
following error:
Error executing listen_alert procedure call continuously.

Workaround Make sure the username and the database names are different.

1-9OT1MX Summary (Oracle only) When the adapter invokes a standard RPC operation,
(DataDirect the Datadirect ODBC driver causes performance degradation.
defect:
Workaround Use custom RPC operation or the Oracle Native driver.
DD00044598)

1-9DA12C Summary If there are more than one transaction updating the source table, the
BETWEEN clause of the select statement may cause the adapter to publish
message out of order. The BETWEEN clause is used to improve the
performance of the query.
Workaround Set the value of the adb.useBetweenClass property to off. The
select query will not contain the BETWEEN clause.

1-9J2DWB Summary (DB2 AS400 Only) The delete trigger creation script is generated
incorrectly and includes the following SQL statement:
SELECT NEW.<key column name>.., instead of
SELECT OLD.<key column name>.

This results in errors when the script is executed.

Workaround Open the generated SQL script and make the corrections in the
delete trigger creation scripts and execute the trigger creation script again.

TIBCO ActiveMatrix Adapter for Database Release Notes

 Known Issues 13
|

Defect # Summary/Workaround
1-8XPUEL Summary (Oracle only) When connecting to the database via the native driver
provided by Oracle, the datatypes TIMESTAMP WITH TIME ZONE and
TIMESTAMP WITH LOCAL TIME ZONE are not supported.

Workaround The Oracle drivers do not support TIMESTAMP WITH TIME ZONE
and TIMESTAMP WITH LOCAL TIME ZONE datatypes. Use the ADB_TIMESTAMP
column type instead of TIMESTAMP.

1-8WUZTD Summary Copying and pasting an RPC Service with custom operations
configured results in deserialization errors.
Workaround Configure a new RPC service.

1-8W21CB Summary The binary file to uninstall the adapter on HP-UX 11i v3 was missing
from the _uninstall folder under the installation path. As a result, you could
not uninstall the adapter from the command line.
Workaround To uninstall the adapter follow these steps:
$ cd <PRODUCT_HOME >/_uninst
$ java -cp uninstaller.jar run

1-84SFZ1 Summary (DB2 AS400 only) When using the Datadirect JDBC Driver on the
DB2 for iSeries platform, the adapter cannot create a publishing table that has a
column of type TIMESTAMP. The following error is returned:
TIMESTAMP IS AN UNDEFINED NAME

Workaround Use the IBM iSeries JDBC driver.

1-81RJ8X Summary The adapter palette cannot retrieve metadata for Sybase stored
procedures in Request/Response custom operation configurations. This is a
(Data Direct
Datadirect driver issue.
issue: 15023957)
Workaround Use standard Request/Response operations.

1-6RUBUH Summary (IBM DB2 z/OS only) Custom operations cannot be configured using
the adapter palette where the return value is a result set.
Workaround Use standard operations for configurations.

1-7VWSTL Summary If columns are unselected from the Table tab of a subscribing service,
the subscribing schema is not changed. This only happens when there is a
publication service on the same table.
Workaround Use a view, synonym, or alias to give that subscriber table a
different name.

TIBCO ActiveMatrix Adapter for Database Release Notes

14 Release Notes
|

Defect # Summary/Workaround
1-845BWV Summary While the adb.unicode option as well as the character set used in
the source database are UTF8 the adapter adds blank characters after the string
values in the published message for nchar and nvarchar2 column.
Workaround None at this time.

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 than 2000. The field is
available under the Adapter Services tab.

1-XHA8 Summary For Oracle, the adapter 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.

1-ZQUEY Summary (DB2 for z/OS only) A publication service update statement from 'N'
to 'P' times out with an error and the adapter shuts down if the publishing table
is locked for a long period.
Workaround None.

TIBCO ActiveMatrix Adapter for Database Release Notes

 Known Issues 15
|

Defect # Summary/Workaround
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-1J4NBA Summary The publication service logs delivery status entries in reverse order
in the trace log file. For example, as shown next, the UPDATE entry is printed
before the Published entry. The UPDATE entry should be printed after the
Published entry.

2004 Nov 03 13:43:07:040 GMT -8 cisco_aepub.cisco_aepub Info

[Adapter] AEADB-700001
Publisher: UPDATE P_SO_LINES_ALL SET ADB_SUBJECT = ?,
ADB_L_DELIVERY_STATUS = 'P', ADB_L_CMSEQUENCE = ? WHERE
ADB_SEQUENCE = ?
2004 Nov 03 13:43:07:040 GMT -8 cisco_aepub.cisco_aepub Info
[Adapter] AEADB-700083
Published message on ADB.SOLINESALL
2004 Nov 03 13:43:07:040 GMT -8 cisco_aepub.cisco_aepub Info
[Adapter] AEADB-700041
Publisher: data = {...}

Workaround None.

1-1KQ3W Summary (DB2 for z/OS only) A subscription service cannot insert a message
into the opaque table.
Workaround None.

TIBCO ActiveMatrix Adapter for Database Release Notes

16 Release Notes
|

Defect # Summary/Workaround
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.

1-1WJFLI Summary The log file field value is not saved correctly if changed from the
default. For example, if you change the log file field value from the default
%%DirTrace%%/%%Deployment%%.%%InstanceId%%.log to
%%DirTrace%%/foo.log and create an EAR file and deploy it, the log is saved
correctly at "%%DirTrace%%/foo.log". If you change the log file value back to
the default and deploy again, the log file is still generated at
%%DirTrace%%/foo.log.

Workaround None.

1-1X3DCO Summary If an Oracle client is on a network drive, or on the same machine but
on a different drive than the operating system, the adapter cannot start as a
service.
Workaround There are two workarounds:
• Rename the tra properties file to adbagent.tra. This only works for a
single instance.
• Rename the adbagent.exe to the same name as the tra properties file and
modify the ntservice.binary.path.absolute property in each tra
properties file to use the new name.

TIBCO ActiveMatrix Adapter for Database Release Notes

 Known Issues 17
|

Defect # Summary/Workaround
1-271E0J Summary (DB2 for iSeries only) The subscription service throws an Invalid
(DataDirect character value error, similar to the following when attempting to insert into
defect: 15013284) the destination table.
2004 Aug 06 13:48:49:620 GMT -7 AS400.AS400 Error [Adapter]
AEADB-700090
Database error updating ADB.P_CUSTOMER38

tracking=#-0Y--C--EFDigE6U-0rOzzwBx-zzw#ADB.AS400.ADB.P_CUSTOMER
38# 2004 Aug 06 13:48:49:651 GMT -7 AS400.AS400 Error [Database]
AEADB-100004
DBError: Database driver code: HY000
Database server code: -7008
Database driver message: [DataDirect][ODBC DB2 Wire
Protocol driver][UDB DB2 for iSeries and AS/400]Unknown error:
SQLCODE -7008

2004 Aug 06 13:48:49:682 GMT -7 AS400.AS400 Error [Database]

AEADB-920015
Subscription error. Subscription service ADBSubscriber listening
on subject AS400.ADBPublisher failed due to database error:

DBError: 5
ErrorCode: HY000
ServerCode: -7008
Message: [DataDirect][ODBC DB2 Wire Protocol driver][UDB DB2 for
iSeries and AS/400]Unknown error: SQLCODE -7008

Workaround On Unix, for the DB2 entry in the ODBCINI file, make sure the
WithHold property is set to zero (WithHold=0).
On Windows, when configuring a DB2 data source, make sure that With Hold
Cursorscheck box is cleared.

1-2G60CX Summary Names are case insensitive. For example, the following error appears
if renaming an adapter instance from UDb81 to UDB81.
Names of many adapter components must be unique within the
adapter. The name you entered conflicts with an existing
component name.

Workaround None.

1-31HRC2 Summary (DB2 for iSeries only) If group messaging is enabled, the publication
service will hang when new rows are added to the source table.
Workaround On Unix, for the DB2 entry in the ODBCINI file, make sure the
WithHold property is set to zero (WithHold=0).
On Windows, when configuring a DB2 data source, make sure that With Hold
Cursorscheck box is cleared.

TIBCO ActiveMatrix Adapter for Database Release Notes

18 Release Notes
|

Defect # Summary/Workaround
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 (Oracle only), a subscription service inserts the wrong value for an
r4 type column.
Workaround Use the r8 type instead of r4.

1-BBRMU Summary (Sybase only) While the adapter is running, if you drop and then
(DataDirect recreate a destination table that is part of a cached child select statement in a
defect: 15006332) 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.
Workaround On Windows, use the Sybase ODBC driver. On Unix, restart the
adapter. Then remove the cached child select statement.

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 The DataDirect driver can experience delays when describing a
(DataDirect procedure on databases that contain many procedures.
defect: 15004808)
Workaround Use custom AE operations to minimize the delay. The adapter
will take longer on the first invocation, but subsequent invocations will be
faster.

1-LU40G Summary (Oracle only) 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.

1-Q9F6P Summary (Microsoft Windows only) Adding instances of certified subscription

services does not improve the message rate, although the messages are
load-balanced across all the instances.
Workaround Use the Oracle ODBC driver.

TIBCO ActiveMatrix Adapter for Database Release Notes

 Known Issues 19
|

Defect # Summary/Workaround
1-9MURML Summary (MS SQL Server 2000 only) The adapter will terminate with an error
"Error registering alerter.." if the adapter contains more than one
publishing service and the polling interval is set to 0
Workaround Set polling interval to a value larger than 0

1-9NTIBX Summary (Sybase 15 only) The alerter library cannot be called by the sybase
server.
Workaround None.

1-9NLCR9 Summary When the adapter is running in fault tolerance mode and the value of
the adb.retryTotal property is set to 0, the secondary instance will stop
responding and does not terminate gracefully when the database connection is
lost.
Workaround Set the value of the adb.retryTotal property to value greater
than 0 when running the adapter in the fault tolerance mode

1-9MYKY7 Summary When value of the adb.unicode property is set, the subscription
service inserts corrupted data into the database if the column type is NUMBER
or NUMERIC, and the AE schema type is string.
Workaround Make sure AE type is r8 for number type if adb.unicode is set.

1-9M5FOV Summary (Oracle Only) When there are overloaded stored procedures in a
package and if the Procedure Returns Results option is selected in the ODBC
(Data Direct
configuration, the adapter will try to invoke the procedure with REF COURSE
defect:
as the return parameter and it will invoke other procedures when the option is
DD00045387)
not selected.
Workaround Configure two adapter instances that connect to different ODBC
configurations that work with procedures with or without the REF CURSOR
return type.

TIBCO ActiveMatrix Adapter for Database Release Notes

20 Release Notes
|

TIBCO ActiveMatrix Adapter for Database Release Notes