Oracle GoldenGate for Java Release Notes 11g Release 1 (11.1.1) E18170-01 August 2010
Oracle GoldenGate for Java Release Notes current to 11g Release 1 (11.1.1) E18170-01 Copyright 2008, 2009, 2010 Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065. This software is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. This software and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services. 2
Table of Contents Release Notes 11g Release 1... 4 New Features in 11.1.1... 4 Oracle GoldenGate Application Adapter for Java... 4 New Parameters... 5 New Property File values... 5 VAM Message Capture Properties... 5 Deprecated/Discontinued Parameters... 5 New Utility... 5 Gendef... 5 Documentation Addendum... 6 General... 6 GoldenGate for Java... 6 Open Issues...6 Installation and Upgrade Procedure... 6 Corrected Problems... 6 Version 11.1.1.0.0 build 7 31 July 2010... 6 Version 11.1.1.0.0 build 6 26 July 2010... 6 Version 11.1.1.0.0 build 5 22 July 2010... 7 Version 11.1.1.0.0 build 4 21 July 2010... 7 Version 11.1.1.0.0 build 3 14 July 2010... 7 Version 11.1.1.0.0 build 2 8 July 2010... 7 Version 11.1.1.0.0 build 1 1 July 2010... 7
Release Notes 11g Release 1 This document contains important release information about Oracle GoldenGate for Java Release Version 11.1.1. If you have downloaded an Oracle GoldenGate product with a release number higher than 11.1.1.0.7, check the Release Notes that accompanied the software on the Software Download or E-Delivery site for additional information pertaining to that specific product release. New Features in 11.1.1 Oracle GoldenGate Application Adapter for Java Oracle GoldenGate for Java now supports capturing published messages from an enterprise message system. The Oracle GoldenGate messaging adapter connects to JMS messaging to parse messages and write the data to a standard GoldenGate trail. The GoldenGate trail can then be delivered to any of the databases supported by Oracle GoldenGate. This allows JMS messages to be delivered to an Oracle GoldenGate system and the data applied to a target relational database. The JMS Capture is composed of three parts which include: Message connectivity: Values in the property file set connection properties such as the Java classpath for the JMS client, the JMS source destination name, JNDI connection properties, and security information. Parsing: Values in the property file set parsing rules for fixed width, comma delimited, or XML messages. This includes settings such as the delimiter to be used, values for the beginning and end of transactions and the date format. VAM interface: Parameters that identify the VAM library and a property file are set for the Oracle GoldenGate core Extract process. The Oracle GoldenGate message capture adapter supports three types of parsers: Fixed: Messages contain data presented as fixed width fields in contiguous text. Delimited: Messages contain data delimited by field and end of record characters. XML: Messages contain XML data accessed through XPath expressions. Source and target data definitions can be specified several ways. Source definitions can be defined using a combination of properties and external files. The Oracle GoldenGate Gendef utility generates a standard source definitions file based on these data definitions and parser properties. The options include: Fixed: COBOL copybook, source definitions or user defined Delimited: source definitions or user defined XML: source definitions or user defined 4
Information about usage, installation, and configuration, can be found in the Oracle GoldenGate for Java Administrator s Guide. New Parameters All new parameters in the 11.1.1 release are included in the Oracle GoldenGate Reference Guide 11gR1. There are no new parameters specific for the Oracle GoldenGate for Java Adapter. New Property File values There are new properties specific for the Oracle GoldenGate for Java adapter. VAM Message Capture Properties New properties have been introduced for the new Message Capture process. Properties can be set for: Logging properties JMS connection properties Parser properties Parser type Fixed parser Delimited parser XML parser All property values and descriptions are included in the Oracle GoldenGate for Java Administrator s Guide. Deprecated/Discontinued Parameters Any parameter that has been deprecated or discontinued will cause Extract or Replicat to abend with an appropriate error message. There are no parameters specific to the Oracle GoldenGate for Java Adapter that were deprecated in this release. New Utility Gendef Gendef is a new utility to the GoldenGate product family that produces a source definitions file for non-database sources. Information on running Gendef can be found in the Oracle GoldenGate for Java Administrator s Guide. 5
Documentation Addendum This section serves as an addendum to the Oracle GoldenGate User Guides. It includes items that have not been covered in the manuals due to changes made to the product or the documentation after the documentation has been published. General None at this time. GoldenGate for Java None at this time. Open Issues Open Issues have been moved to the Oracle GoldenGate README file. Installation and Upgrade Procedure The installation file downloaded from Oracle is not compressed using gzip, instead it is a standard.zip file. To uncompress the download, please use the following methods: Windows Please use winzip or other method that can support files with the.zip extension. UNIX / Linux Please use the unzip command utility to uncompress the downloaded file. Mainframe Please use the unzip command utility to uncompress the downloaded file. If you do not have any of these utilities on the server, you can download them from Oracle s website at http://updates.oracle.com/unzips/unzips.html The rest of this section has been moved to the Oracle GoldenGate README file. Corrected Problems For questions on specific bugs or ticket numbers, please consult Oracle Customer Support. The numbers listed is the Oracle bug identification number that is also known as the PatchID. Version 11.1.1.0.0 build 7 31 July 2010 9952193 Fixed an issue with Xpath queries in the JMS Capture properties file that are not parsed correctly on z/os when they contain match values (for example./value[@isnull=true]) Version 11.1.1.0.0 build 6 26 July 2010 For build purposes only. 6
Version 11.1.1.0.0 build 5 22 July 2010 For build purposes only. Version 11.1.1.0.0 build 4 21 July 2010 9889268 Fixed an issue affecting versions v3.1.0.7 through v3.1.0.10 in the Java API for testing if a column value was a database "NULL". The "isvaluenull()" method now returns 'true' when the column value is SQL NULL. As a side-effect, the bundled demo XML message formatters returned NULL columns as the string NULL" (e.g., "![CDATA[NULL]]"), rather than as before, by setting an XML attribute (e.g., 'isnull="true"'). These demo XML formats now produce the same output as before. Version 11.1.1.0.0 build 3 14 July 2010 9862191 Fixed an issue that was causing Extract to hang when using txind and there is more than one message in a transaction 9862224 Fixed an issue that caused Extract to fail with an error that transaction indicator does not match any valid values. 9869942 Added support to the XML parser for the definition of schemas through userdefs, in addition to source definitions. Support also added to for userdefs override to change data types or omit columns in the output. 9889888 Added validation to the delimited parser checker to properly report when header values are improperly defined in the properties file. Version 11.1.1.0.0 build 2 8 July 2010 9871061 Corrected the method used to convert numbers that are part of the input IBM MQ Message ID that was causing Extract to terminate with error: Unable to receive message. Version 11.1.1.0.0 build 1 1 July 2010 Initial Controlled Availability (CA) release of 11.1.1.0.0. 9753303 Addressed an issue that was causing the JMS capture process to terminate with an out of memory issue. 9753318 JMS Capture was failing to start after executing the Gendef utility. The was resolved by changing Gendef so it will no longer produce the same log file as the JMS Capture. 9753358 Fixed an issue that caused errors to be incorrectly written to the report file when the Extract was stopped normally. Incorrect errors that were showing up in the report file included: [ERROR]: Java exception: Rollback, [ERROR]: could not rollback JMS consumer transaction, [ERROR]: Error rolling back messages. Graceful stops no longer report errors. 9753346 The JMS capture could skip messages when the IBM MQ Message ID was specified as the sequence ID. The IBM MQ JMS Message ID is a hexadecimal value, which is not suitable for a sequence id on EBCDIC systems. This was corrected by converting to a suitable string by decoding the hexadecimal value. 7
9819829 When a JMS capture or data pump was stopped gracefully, the group.pcs file incorrectly was not removed from the /dirpcs directory. The JMS message capture was resolved to correctly clean up the dirpcs file after a graceful stop. 8