TIBCO ActiveMatrix BusinessWorks Plug-in for Data Conversion Release Notes Software Release 4.2.0 November 2014 Two-Second Advantage
2 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 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 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. TIBCO, Two-Second Advantage, TIBCO Rendezvous, TIBCO Enterprise Message Service, TIBCO Administrator, and TIBCO ActiveMatrix BusinessWorks are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries. Enterprise Java Beans (EJB), Java Platform Enterprise Edition (Java EE), Java 2 Platform Enterprise Edition (J2EE), and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle Corporation 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 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 2004-2014 TIBCO Software Inc. ALL RIGHTS RESERVED. TIBCO Software Inc. Confidential Information
3 Contents TIBCO Documentation and Support Services...4 New Features...5 Changes in Functionality... 6 Deprecated and Removed Features...7 Migration and Compatibility...8 Closed Issues...9 Known Issues...11
4 TIBCO Documentation and Support Services All TIBCO documentation is available on the TIBCO Documentation site, which can be found here: https://docs.tibco.com Product-Specific Documentation Documentation for TIBCO products is not bundled with the software. Instead, it is available on the TIBCO Documentation site. To directly access documentation for this product, double-click the following file: TIBCO_HOME/release_notes/TIB_<productID>_version_docinfo.html The following documents for this product can be found on the TIBCO Documentation site: TIBCO ActiveMatrix BusinessWorks Plug-in for Data Conversion User s Guide Read this manual to gain an understanding of the product and its capabilities. TIBCO ActiveMatrix BusinessWorks Plug-in for Data Conversion Installation Read this manual for instructions on site preparation and installation. TIBCO ActiveMatrix BusinessWorks Plug-in for Data Conversion Release Notes Read the release notes for a list of new and changed features. This document also contains lists of known issues and closed issues for this release. How to Contact TIBCO Support For comments or problems with this manual or the software it addresses, contact TIBCO Support as follows: For an overview of TIBCO Support, and information about getting started with TIBCO Support, visit this site: http://www.tibco.com/services/support If you already have a valid maintenance or support contract, visit this site: https://support.tibco.com Entry to this site requires a user name and password. If you do not have a user name, you can request one. How to Join TIBCOmmunity TIBCOmmunity is an online destination for TIBCO customers, partners, and resident experts. It is a place to share and access the collective experience of the TIBCO community. TIBCOmmunity offers forums, blogs, and access to a variety of resources. To register, go to: http://www.tibcommunity.com
5 New Features The following new features have been added to version 4.2.0 of TIBCO ActiveMatrix BusinessWorks Plug-in for Data Conversion. Character Sets The ISO8859_15 character set was added under the Character Set drop down list. Ability to Generate a COBOL Copybook from a Schema A COBOL copybook now can be generated from a user-supplied XSD schema. To access this feature use Generate from a schema... menu item under More menu located on the Copybook page of a Copybook resource. Namespaces for Generated Schemas The Copybook resource allows you to specify a namespace that will be used in the corresponding copybook schema file. You can use this feature to reconcile namespace conflicts or to provide a friendlier namespace value. XSD Type base64binary in PL/I and RPG Copybooks XSD Type base64binary now can be selected in PL/I and RPG copybook items. This selection is available on Field Configuration page. XML Character Validation in Activities Both activities now have the Fail in Invalid XML Characters setting. This setting causes activities to fail when an invalid XML character is detected. This setting is on by default. TIBCO Eclipse Plug-in This release adds support for the TIBCO Eclipse Plug-in, an installation package for the Eclipse provisioning platform. The TIBCO Eclipse Plug-in permits the installation of the TIBCO ActiveMatrix BusinessWorks Plug-in within the Eclipse environment. For more information about how to install the plug-in using the Eclipse provisioning platform, see the TIBCO ActiveMatrix BusinessWorks Plug-in for Data Conversion Installation guide.
6 Changes in Functionality The following are changes in functionality in software release 4.2.0 of TIBCO ActiveMatrix BusinessWorks Plug-in for Data Conversion. Scaling Factor The scaling factor (P in picture), which determines how a value is scaled during parsing and rendering, is now processed properly. The scaling factor does not contribute to the size of an item. This change may result in layout differences in comparison to the previous releases. Alignment of SYNC and Top-Level Items SYNC and top-level items are now aligned consistently with the COBOL compiler. This may cause an incompatibility with layouts produced with previous releases of the plug-in. To retain the compatibility use Alignment processing, use v4.1 and earlier setting of the Copybook Resource. Note that, for schema resources created by the previous releases this setting is automatically activated and therefore there is no change in behavior. For more information, see the section on Alignment Compatibility with Previous Releases in the Plugin User s Guide.
7 Deprecated and Removed Features No features are deprecated or removed in software release 4.2.0 of TIBCO ActiveMatrix BusinessWorks Plug-in for Data Conversion.
8 Migration and Compatibility There are no migration procedures or compatibility issues in software release 4.2.0 of TIBCO ActiveMatrix BusinessWorks Plug-in for Data Conversion.
9 Closed Issues The table lists closed issues in software release 4.2.0 of TIBCO ActiveMatrix BusinessWorks Plug-in for Data Conversion. Key BWDC-437 BWDC-422 BWDC-397 BWDC-384 BWDC-366 BWDC-365 BWDC-362 BWDC-262 BWDC-360 BWDC-359 BWDC-358 BWDC-357 BWDC-356 BWDC-355 Summary Fixed a problem that caused a NullPointerException during copybook namespace validation when a project contained a file with no extension. Fixed a problem that caused incorrect parsing on VAR and VARZ items in PL/I. In these cases, length prefix or terminating zero was parsed as data, leading to errors. Fixed an error that caused OCCURS to propagate down from a parent level during COBOL copybook generation from a user-supplied schema. Previously, the Parse Copybook Data activity with Empty Nodes checked did not remove empty group level items. This has been fixed. Previously, PL/I arrays were not always rendered completely. Fixed an error that sometimes caused the Parse Copybook Data activity to fail when Ignore Invalid Items was selected. Previously, in COBOL copybooks some level 01 items were not be aligned at a correct byte boundary. Additionally, the SYNC keyword was not in effect at a group level. The feature has been provided. Previously, Scaling factor P in PICTURE clause was not processed properly. Scaling factor should determine how the value is scaled during parsing and rendering, but not contribute to the size of an item. This feature has been added to the product. Previously, PL/I FIXED DECIMAL items with unspecified digits after a decimal point and INIT attribute failed to parse at design time. For example FixDecVar FIXED DECIMAL(5) INIT(2) caused an error "Copybook contains no data definitions." This has been fixed. Fixed an error that caused parsing errors at design time in a RPG copybook that had data structure definitions in LIKEDS. Previously, Parse Copybook Data with Allow Incomplete Records selected caused java.lang.outofmemoryerror when there was one incomplete bytes for the element and Multiple Records were checked. This has been fixed. Fixed an error that caused the Typical Uninstall option (removes all products in this TIBCO_HOME) to fail. The Convert from XML Schema functionality was not available in the previous release. This feature has been added to the product.
10 Key BWDC-344 Summary Previously, Parse Copybook Data could receive data that translated to non-xml characters in string elements. Such strings cause runtime and debugging errors. XML character validation was added to activities.
11 Known Issues The table lists known issues in in software release 4.2.0 of TIBCO ActiveMatrix BusinessWorks Plug-in for Data Conversion. Key BWDC-432 BWDC-303 BWDC-301 BWDC-295 BWDC-291 BWDC-261 BWDC-150 Summary Summary: An incorrect schema constraint or type is generated for COBOL numeric items with scaling factor P at the beginning of the picture. Workaround: Remove P from the PICTURE clause and use XPath to scale or descale values. Summary: COBOL and RPG item names that start with numbers and include certain special characters result in runtime and design-time errors. This is due to the fact that such names are invalid in XML. Workaround: Modify the names in the copybook to comply to the XML rules. Summary: Render Copybook Data runs successfully with Multiple Records checked, when no value is mapped to a FIXED BIN and FLOAT fields and no INIT attribute is specified. Workaround: Implement a check prior to the activity. Summary: During syntax checking, a COBOL copybook's VALUE clause may not be processed correctly for items with DATE. Workaround: Remove the VALUE clause and supply values via input mapping of Render activity. Summary: In COBOL items where TO equals FROM in OCCURS DEPENDING, the value of the DEPENDING object is not checked against this constraint. Workaround: When using Render activity, use BusinessWorks conditional transitions to implement a check prior to the activity. In Parse scenarios, there is no workaround and the check can only be implemented in the COBOL program that generates the data. Summary: COBOL BLANK WHEN ZERO clause has no effect. Workaround: When using Render activity, add a redefining PIC X item. Use conditional mapping and render blanks into this item. During Parsing, you can utilize "Ignore Invalid Items" to skip blanks and use conditional mapping to add an item with value 0 to the resulting XML. Summary: If a PL/I array contains an INIT attribute with hexadecimal literals followed by a text literal with the repetition factor (*), the Plug-in renders the repeated text literal and ignores the hexadecimal literals. Workaround: Specify the values with mapping.
12 Key BWDC-143 Summary Summary: Using a PL/I FIXED DECIMAL(...) item as a REFER object or a COBOL packed decimal item with PICTURE 9(19) as a DEPENDING ON object causes a rendering failure. Workaround: Edit the copybook content to use BINARY FIXED in PL/I or PICTURE 9(18) or less in COBOL.