TIBCO ActiveMatrix® Adapter for Database Release Notes

TIBCO ActiveMatrix® Adapter for DatabaseRelease NotesVersion 7.3.0November 2021

Copyright © 1999-2021. TIBCO Software Inc. All Rights Reserved.

TIBCO ActiveMatrix® Adapter for Database Release Notes

2 | Contents

Contents

Contents 2

New Features 3

Changes in Platform Support 5

Changes in Functionality 7

Deprecated and Removed Features 8Deprecated Features 8Removed Features 8

Migration and Compatibility 13Migrating from Release 7.2.0 to 7.3.0 13

Closed Issues 14

Known Issues 17

TIBCO Documentation and Support Services 19

Legal and Third-Party Notices 21


3 | New Features

New FeaturesThe following new features have been added in this release of TIBCO ActiveMatrix® Adapter for Database:

Support to new databases

l IBM DB2 for Linux, Unix and Windows 11.1.x

l IBM DB2 for i 7.2.x

o 7.2.x - (via remote connection only)

l Microsoft SQL Server 2016, 2017, 2019

l MySQL 5.7.x

l MySQL Community Server 5.7

l Oracle Database 19c 19.x

l Microsoft Azure SQL Server (Microsoft SQL Server 2016, 2019)

l Amazon Aurora MySQL 5.7

l Teradata RDBMS 16.20

Support for new properties

Support for the following properties has been added. The details are as follows:

Property Description

adb.setExplicitNilForDB2 Set this property to On to control the output element of columns with nil value in the published messages while using DB2 database.

adb.setEmptyStringToDefault For IBM DB2 databases, if you set the value of this property to ON, empty strings in a field are changed to the default value when creating a table.


4 | New Features

Property Description

Note: Earlier, this property was available only for Oracle database.

adb.keepZeroMilliSecond Set the value of this property to Onif you want to keep the value in the datetime field in the published messages as zero milli seconds.

adb.pubTimestampWithNanoSeconds Set the value of this property to On if you want to keep the value in the datetime field in the published messages as nano seconds.

adb.noFloatDoubleScientificNotation Set the value of this property to On if you want to have float and double datatypes without scientific notation as part of the published messages.

adb.engineStopWithDBOperationFailed Set the value of this property to 0 if you want to shut down the ADB agent when the staging table is not accessible.

adb.pollingCommitForTD Set the value of this property to On if you want to issue the database commit after each polling select statement while using Teradata database.

adb.getDbURLbyHawk Set the value of this property to On if you want to get the database URL in Hawk.

Support for XML datatype

For the Teradata database, the XML data type is only supported for the subscription service. It is not available for any other service.


5 | Changes in Platform Support

Changes in Platform SupportThe following changes in platform have been added in this release of TIBCO ActiveMatrix® Adapter for Database. For a complete list of all the currently supported platforms, refer to the readme file.

Platform Status As of Release

Microsoft Windows 10 64-bit on x86-64 Added 7.3.0

Microsoft Windows Server 2016, 2019 64-bit on x86-64 Added 7.3.0

Novell SUSE Linux Enterprise Server 12.x, 15.x 64-bit on x86-64 Added 7.3.0

Oracle Linux 8.x 64-bit on x86-64 Added 7.3.0

Red Hat Enterprise Linux Server 8.x 64-bit on x86-64 Added 7.3.0

l HP HP-UX

o 11i v2 (B.11.23)

o 11i v3 (B.11.31) 64-bit on Itanium

Dropped 7.3.0

l IBM AIX

o 6.1, 7.1 64-bit on pSeries

Dropped 7.3.0

l Microsoft Windows

o 7 32-bit on x86

o 7 64-bit on x86-64

Dropped 7.3.0

l Microsoft Windows Server

o 2008 32-bit on x86

o 2008, 2008 R2, 2012, 2012 R2 64-bit on x86-64

Dropped 7.3.0


6 | Changes in Platform Support

Platform Status As of Release

l Novell SUSE Linux Enterprise Server

o 10.x, 11.x 32-bit on x86

o 10.x, 11.x 64-bit on x86-64

Dropped 7.3.0

l Oracle Linux

o 6.x 32-bit on x86

o 6.x 64-bit on x86-64

Dropped 7.3.0

l Oracle Solaris

o 10, 11 64-bit on SPARC

o 10, 11 64-bit on x86-64

Dropped 7.3.0

l Red Hat Enterprise Linux Server

o 6.x, 7.x 32-bit on x86

o 6.x 64-bit on x86-64

Dropped 7.3.0


7 | Changes in Functionality

Changes in FunctionalityThe following functionality has been changed in this release of ActiveMatrix® Adapter for Database:

Performance Logging Options for an Adapter Instance

When configuring an adapter instance for performance by using Log4J, the configuration of the Log4J properties file is now based on the 2.14.x version or later.

Adapter SDK Properties

The following points apply to any new TRA properties introduced in the version 7.3.0 of ActiveMatrix® Adapter for Database:

l If you are generating a new Enterprise Archive (EAR) file from TIBCO Designer, then any new property introduced must be maintained accordingly by using TIBCO Administrator UI.

l If you are deploying an Enterprise Archive (EAR) created by an earlier version of the adapter then any new property introduced must be maintained accordingly in the adapter template file.


8 | Deprecated and Removed Features

Deprecated and Removed FeaturesThe following tables list any features that have been deprecated or removed in this release of ActiveMatrix® Adapter for Database.

For deprecated features, if relevant, useful alternatives to the deprecated features are listed. Any use of a deprecated feature must be discontinued as it might be removed in a future release. Avoid becoming dependent on deprecated features and become familiar with the suggested alternative features.

Deprecated FeaturesNo features have been deprecated in this release of ActiveMatrix® Adapter for Database.

Removed Features

Affected Component

Description Deprecated in Release

Removed in Release

Design time and Runtime

Connection of ActiveMatrix® Adapter for Database to TIBCO ActiveSpaces has been removed.

7.2.0 7.3.0

Database l IBM DB2 for Linux, Unix and Windows 9.5.x, 9.7.x, 9.8.x, 10.0.x, 10.1.x

l IBM DB2 for i 6.1.x

l IBM DB2 for z/OS 10.1.x, 11.1.x

l Microsoft SQL Server 2005.x, 2008 R2, 2008.x, 2012

l MySQL 5.5, 5.6

None 7.3.0



Affected Component


Removed in Release

l MySQL Community Server 5.5, 5.6

l Oracle Database 11g 11.1.x, 11.2.x

l Oracle Database 11g RAC 11.1.x, 11.2.x

l Oracle Database 18c 18.x

l PostgreSQL 9.0.x, 9.1.x, 9.2.x, 9.3.x

l Amazon RDS for Oracle (Oracle Database 11gR2)

l Amazon RDS for SQL Server (Microsoft SQL Server 2008 R2, 2012)

l Microsoft Azure SQL Server (Microsoft SQL Server 2012 R2)

l Teradata RDBMS V13.x, V14.0, V14.10, V15.0, V15.10, V16.10

l Sybase 15.5.x, 15.7.x

l IntelliCloud (Teradata Database on Cloud) 15.10

l Amazon RedShift

TIBCO ActiveMatrix BusinessWorks™

Versions 5.11.x, 5.12.x, 5.13.x, 5.14, 6.x

None 7.3.0

TIBCO ActiveMatrix®

Versions 1.3.x, 1.4.x, 1.6.0 None 7.3.0



Affected Component


Removed in Release

Adapter Framework

TIBCO ActiveMatrix® Adapter for Database (TIBCO Business Studio™)

Version 1.3.x None 7.3.0

TIBCO Enterprise Message Service™

Versions 6.3.0 - 8.5.x None 7.3.0

TIBCO Rendezvous®

Versions 8.4.x, 8.5.0 None 7.3.0

TIBCO Runtime Agent™

Versions 5.9.x, 5.10.x, 5.11.x None 7.3.0

TIBCO® Adapter for Database Distribution for TIBCO Silver® Fabric

Version 7.2.0 None 7.3.0

Publication Service

Publication Service in stream mode has been removed.

7.2.0 7.2.0

Design time Support for Rendezvous Message as a wire format on the Configuration tab for adapter services has been removed.

7.2.0 7.2.0

Cloud Database Support for Oracle On Demand has been removed.

7.2.0 7.2.0

Database Support for the following databases 7.0.0 7.1.0



Affected Component


Removed in Release

has been removed:

• Oracle database 10g

• IBM DB2 for i 5.4.x

• MySQL 5.0, 5.1.x (also removed 5.1.x from Cloud)

• PostgreSQL 8.4.x

• DB2 9.1.x

• Postgres Plus Advanced Server (EnterpriseDB)

• Sybase Adaptive Server Anywhere 10.1.x

• Sybase 15.0.x

ODBC driver The ODBC driver is no longer used to access the database. All relevant ODBC content has been removed.

N/A 7.0.0

Platform Support for the following platforms has been removed:

HP-UX 11i, 11i v2, 11i v3 (PA-RISC, 32-bit and 64-bit platforms)

N/A 7.0.0

Platform Support for the following platforms has been removed:

• Microsoft Windows Server 2003

• Microsoft Windows XP Professional

• Microsoft Windows Vista

N/A 6.3.0



Affected Component


Removed in Release

• Red Hat Enterprise Linux 4.x

• AIX 5.3

TIBCO ActiveMatrix® Adapter Service Engine

The ActiveMatrix Adapter Service Engine component of ActiveMatrix® Adapter for Database is no longer supported.

N/A 6.3.0


13 | Migration and Compatibility

Migration and CompatibilityThe following information provides migration procedures or compatibility issues for this release of ActiveMatrix® Adapter for Database.

This section provides information about the compatibility of the adapter and its data migration support for other TIBCO applications.

The configuration in an earlier release, which is not supported in this release, is ignored during migration and not used by the adapter.

The following migration process is specific to the projects in TIBCO Designer

Note: Make a backup copy of the project before starting the migration process.

Migrating from Release 7.2.0 to 7.3.0When you migrate projects to this release from version 7.2.0, note the following points:

l You can deploy ActiveMatrix® Adapter for Database 7.3.0 by using TIBCO Administrator version 5.12.x.

l You can deploy EAR files created from version 7.2.0 by using ActiveMatrix® Adapter for Database version 7.3.0.


14 | Closed Issues

Closed IssuesThe following issues have been closed in this release of ActiveMatrix® Adapter for Database:

Key Summary

AADB-7942 The columns that are published as nil=true, are not published at all when DB2 database is used.

AADB-7925 An error occurs when RPC service is configured on Oracle database.

AADB-7883 There is a delay in running a stored procedure that is configured with an adapter service.

AADB-7864 The following error occurs because of slow record processing:

"JMS error: Message not delivered"

AADB-7828 The following error occurs when you try to add a table in a service:

"This driver is locked for use with embedded applications"

AADB-7803 You are not able to fetch data from a table that has null values for integer or DateTime columns.

AADB-7770 The adapter agent does not start after installing the hotfix.

AADB-7769 Even if the user key column is set to null, a duplicate message is being inserted into the database.

AADB-7761 The adb.setEmptyStringToDefault property is not available for using with the IBM DB2 database.

AADB-7735 The following error occurs when you use the RPC mode of the ADB server:

"JMS error: "Message not delivered when reply message to RPC standard invoker"


15 | Closed Issues

Key Summary

AADB-7707 The environment variable tibco.env.CUSTOM_CP_EXT in the adbagent.tra file is overwritten with the default value after installing the hotfix.

AADB-7703 The milliseconds part in the timestamp is not printed as expected in the DateTime data when you receive transactions from the database.

AADB-7687 The timestamp format for Published messages in the parent table is different from the format in the child table.

AADB-7682 An error occurs when you fetch data from the child table.

AADB-7676 When you run a process that has a request-response service two times, a timeout error occurs when running the same process for the third time.

AADB-7672 The SSH handshake fails while connecting the adapter to EMS version 8.4.0 by using TLS version 1.2.0.

AADB-7664 The tibco.env.LD_LIBRARY_PATH tra property for the UNIX platform is missing in the adbagent.tra file.

AADB-7637 When you use Teradata version 16 with the ADB publication service, it locks the publishing table and prevents any insert or update operation on the source table.

AADB-7633 One of the message properties ae_tracking_info_1 is not set when you publish messages from the adapter to EMS.

AADB-7632 For the Teradata database, the XML data type is not supported for the subscription service.

AADB-7597 A null resultset is returned after you call a procedure in a specific scenario that uses the SQL Server connection.

AADB-7589 After the Database Administrator locks the database table for normal routine activities, the adapter loses the connection and you must restart it manually.


16 | Closed Issues

Key Summary

AADB-7574 In the subscription service, a record in which a column has a null value is not updated.

AADB-7570 You are not able to create a publication service for MS SQL Server with designer, if you use the Windows authentication method.

AADB-7567 ADB subscription service throws NullPointerException when the incoming message has user key set as the explicit null value for Oracle and Microsoft SQL databases.

AADB-7555 Incorrect encoding data is inserted into an NVARCHAR2 column of Oracle DB, which has locale character setting.

AADB-7537 The TrackingInfo's appinfo is missing in the ADB reply message from the subscription service.

AADB-7483 An issue occurs at run time when you use a user name instead of the schema name and a complex data type.

AADB-7482 A null pointer error occurs if the user key is set as explicit null.

AADB-7477 The subscription service is not able to handle explicit null in Teradata database.

AADB-7472 The Config Details tab does not show the connection details.

AADB-7424 When the UserName and Password fields are empty, you cannot finish and save the ADBConnection configuration.

AADB-7399 If you specify an explicit null value for an inbound message, the subscription service does not bind it when creating an SQL statement.


17 | Known Issues

Known IssuesThe table lists known issues in this release of ActiveMatrix® Adapter for Database:

Key Summary/Workaround

AADB-8028 Summary: The available context-sensitive help is the same as that for the ActiveMatrix® Adapter for Database version 7.2.0.

Workaround: Use the enhanced search functionality in ActiveMatrix® Adapter for Database 7.3.0 online help to find the latest information.

AADB-7175 Summary: If you use a Sybase database, you cannot call a function for custom RPC Service.

Workaround: None.

AADB-6232 Summary: When both ActiveMatrix® Adapter for Database and TIBCO Enterprise Message Service (EMS) server are configured with fault tolerance, if the EMS server switches from the primary status to the standby status and then switches back to the primary status, the adapter raises the java.lang.NullPointerException exception.

Workaround: None.

AADB-5636 Summary: ActiveMatrix® Adapter for Database does not support the configuration of the VerifyHost setting for the SSL configuration.

Workaround: None.

AADB-4907 Summary: (JMS transport only) After reconnecting to an EMS server, custom RPC Service occasionally cannot receive a request message from the Invoke an Adapter Request-Response Service activity in a BusinessWorks process.

Workaround: None.

AADB-4865 Summary: (Teradata database only) When Subscription Service handles complex parent-child data, the following error occurs and the database is


18 | Known Issues

Key Summary/Workaround

reconnected: Response limit exceeded.

Workaround: Add the JDBC property LOB_SUPPORT=off,url=jdbc:teradata://<servername>/database=<databasename>,LOB_SUPPORT=off when configuring an adapter in the Design-time Connection tab.

AADB-4713 Summary: (Teradata database only) The values of the JDBC properties specified at design time are not valid at run time.

Workaround: Set the values of the JDBC properties in the JDBC URL field.

AADB-4647 Summary: When a JMS message that contains the anyType data type to ActiveMatrix® Adapter for Database, the adapter throws a wrong data format exception.

Workaround: Specify the correct data type in the DATA field manually.

AADB-4527 Summary: (MySQL database only) Publication Service publishes incorrect minimum or maximum values for float data types contained in the table.

Workaround: None.

AADB-3669 Summary: (Teradata database only) The seconds in the TIME data type are displayed incorrectly when you configure Publication Service and Subscription Service.

Workaround: None.


19 | TIBCO Documentation and Support Services

TIBCO Documentation and Support ServicesFor information about this product, you can read the documentation, contact TIBCO Support, and join TIBCO Community.

How to Access TIBCO Documentation

Documentation for TIBCO products is available on the TIBCO Product Documentation website, mainly in HTML and PDF formats.

The TIBCO Product Documentation website is updated frequently and is more current than any other documentation included with the product.

Product-Specific Documentation

The following documentation for this product is available on the TIBCO ActiveMatrix® Adapter for Database Product Documentation page:

l TIBCO ActiveMatrix® Adapter for Database Release Notes

l TIBCO ActiveMatrix® Adapter for Database Installation

l TIBCO ActiveMatrix® Adapter for Database Concepts

l TIBCO ActiveMatrix® Adapter for Database Configuration and Deployment

l TIBCO ActiveMatrix® Adapter for Database Examples

Other TIBCO Product Documentation

When working with TIBCO ActiveMatrix® Adapter for Database, you may find it useful to read the documentation of the following TIBCO products:

l TIBCO TIBCO ActiveMatrix BusinessWorks™: This product provides an integration platform that enables companies to rapidly integrate systems and automate business processes.

l TIBCO® Adapter SDK: This product provides a class library that helps developers implement an adapter with minimal effort.

l TIBCO Administrator™: This product provides capabilities for managing users, monitoring machines, and deploying and managing applications that use TIBCO

https://docs.tibco.com/

https://docs.tibco.com/

https://docs.tibco.com/products/tibco-activematrix-adapter-for-database-7-3-0

https://docs.tibco.com/products/tibco-activematrix-adapter-for-database-7-3-0


20 | TIBCO Documentation and Support Services

products.

l TIBCO Designer™: This product provides a graphical user interface to create TIBCO ActiveMatrix BusinessWorks process definitions, or create or modify TIBCO Adapter configurations.

l TIBCO Enterprise Message Service™: This product sends messages from your applications in a format that conforms to the Java Messaging Service (JMS) specification.

l TIBCO Hawk®: This product is for monitoring and managing distributed applications and systems throughout the enterprise.

l TIBCO Rendezvous®: This product uses messages to enable distributed application programs to communicate across a wide variety of hardware platforms and programming languages.

l TIBCO Runtime Agent™: This product is a bundle of TIBCO software and third-party software that is required to run many TIBCO applications such as TIBCO ActiveMatrix BusinessWorks, TIBCO Adapters, and so on.

How to Contact TIBCO Support

Get an overview of TIBCO Support. You can contact TIBCO Support in the following ways:

l For accessing the Support Knowledge Base and getting personalized content about products you are interested in, visit the TIBCO Support website.

l For creating a Support case, you must have a valid maintenance or support contract with TIBCO. You also need a user name and password to log in to TIBCO Support website. If you do not have a user name, you can request one by clicking Register on the website.

How to Join TIBCO Community

TIBCO Community is the official channel for TIBCO customers, partners, and employee subject matter experts to share and access their collective experience. TIBCO Community offers access to Q&A forums, product wikis, and best practices. It also offers access to extensions, adapters, solution accelerators, and tools that extend and enable customers to gain full value from TIBCO products. In addition, users can submit and vote on feature requests from within the TIBCO Ideas Portal. For a free registration, go to TIBCO Community.

http://www.tibco.com/services/support



https://ideas.tibco.com/

https://community.tibco.com/


21 | Legal and Third-Party Notices

Legal and Third-Party NoticesSOME 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 LICENSE FILE) 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 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.

TIBCO, the TIBCO logo, the TIBCO O logo, Business Studio, Enterprise Message Service, Hawk, and Rendezvous are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries.

Java and all Java based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.

This document includes fonts that are licensed under the SIL Open Font License, Version 1.1, which is available at: https://scripts.sil.org/OFL

Copyright (c) Paul D. Hunt, with Reserved Font Name Source Sans Pro and Source Code Pro.

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 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.

https://scripts.sil.org/OFL


22 | Legal and Third-Party Notices

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.

This and other products of TIBCO Software Inc. may be covered by registered patents. Please refer to TIBCO's Virtual Patent Marking document (https://www.tibco.com/patents) for details.

Copyright © 1999-2021. TIBCO Software Inc. All Rights Reserved.

https://www.tibco.com/patents

Date post:	11-Dec-2021
Category:	Documents
Upload:	others
View:	13 times
Download:	0 times

TIBCO ActiveMatrix® Adapter for Database Release Notes

Documents