IBM(R) Financial Transaction Manager for Multiplatform Version 3.0.0.7 Readme Readme file for IBM(R) Financial Transaction Manager for Multiplatform Version 3.0.0.7 Product/Component Release: 3.0.0 Update Name:Fix Pack 7 Fix ID: 3.0.0-FTM-MP-fp0007 Publication Date: 12 May 2017 Last modified date: ====================================================================== Contents: Download location Prerequisites and co-requisites What's new in FTM 3.0.0.7 Known Issues Installation information Prior to installation Installing Performing the necessary tasks after installation Uninstalling if necessary List of fixes Copyright and trademark information Document change history ====================================================================== Download location ====================================================================== Download IBM(R) Financial Transaction Manager for Multiplatform Version 3.0.0.7 from Fix Central at the following location: http://www.ibm.com/eserver/support/fixes/ Search for the Fix ID: 3.0.0-FTM-MP-fp0007 ====================================================================== Prerequisites and co-requisites ====================================================================== Before downloading FTM v3.0.0.7, perform the following steps: - Ensure that your system meets all of the system requirements: http://www.ibm.com/software/industry/financial-transaction-manager/requirements This action prevents technical problems that might occur after the installation and configuration of the fix pack. - Review the Flashes and open Authorized Problem Analysis Reports (APARs) on the Financial Transaction Manager product support Web site: http://www.ibm.com/software/industry/financial-transaction-manager/support Open APARs describe defects that are not yet addressed in a fix pack, and they might contain workarounds that will impact your use of FTM v3.0.0.7. - Read the "Known issues" section of this readme. - You need to have a file system with 200MB of free space to contain the uncompressed installation image. Ensure that you have the free space required to install the fix pack. - If you already have an FTM product installed and have obtained special fixes, contact IBM(R) support to determine whether you need an updated version of the fixes before you install this fix pack. This helps to ensure that your system is in a consistent state and that no special fixes are lost. ====================================================================== What's new in FTM 3.0.0.7 ====================================================================== - Extended Resend Support Enhancements have been made to the resend capabilities of transactions / transmissions, especially in the context of optimization settings where the logging of some objects may be avoided. - Support for Devolved Timeout Alerts Enhancements have been made to the Outbound Transactions FSM to reduce the number of objects in a timed-out alert state. - Refactoring of the Outbound Transaction FSM The Outbound Transaction FSM diagram has been split into 3 smaller diagrams in the interest of legibility. These diagrams include the Outbound Transaction, Outbound Transaction(Timeout) & Outbound Transaction(Devolved). - Generation of Subflow and ESQL templates. Support has been added to the Model Tooling component to enable the generation of ESQL and Subflow files from an FTM model. - Finer support for control of rollback on an Inbound Mapper abort. Support has been added at the interface(Channel) level to control rollback in the event of an Inbound Mapper abort. - The Purge Utility has been enhanced. See the following section in the FTM Knowledge Center for additional information: Financial Transaction Manager overview->What's new in FTM->What's new in FTM version 3.0.0.7 ====================================================================== Known issues ====================================================================== Issue 1 : Summary : Customers using IBM WebSphere Transformation Extender(WTX) version 8.4.1.2 who use native schema and choice sequence iterations are unable to access iterations of a particular sequence group. Resolution : The fix for this issue(APAR PI31636) is available in WTX v8.4.1.3. Issue 2 : User Affected: Customers using IBM Integration Bus(IIB) version 9.0.0.x may experience the following BIP2930E error when deploying or restarting the broker. Summary of issue : RecoverableException BIP2930E: A function or procedure was called but the value supplied for the ''cAppVer'' parameter was of type ''BOOLEAN'' but the function/procedure expects value of type ''CHARACTER'' Functions and procedures require an exact matching between the data type of values supplied as parameters and the data type in its definition. Resolution : The fix for this issue(IIB APAR IT06286) is available in IIB Maintenance Level 9.0.0.4. Issue 3 : Summary : Customers using IBM Integration Bus(IIB) version 9.0.0.3 may experience the following BIP2503E when executing customer flows if propagating from a node after exiting a FOR loop acting on a shared variable. RecoverableException BIP2503E: Propagate with a SHARED variable lock held by FOR statement. Resolution : The fix for this issue(IIB APAR IT07974) is available in IIB Maintenance Level 9.0.0.4. Issue 4 Summary : Customers using IBM Integration Bus(IIB) version 9.0.0.5 may experience the following issue: If a user has a REFERENCE variable declared at the module or schema level which points at either OutputRoot, OutputLocalEnvironment or OutputExceptionList and performs a PROPAGATE without specifying DELETE NONE in a compute node then it is not defined what the REFERENCE variable will be left pointing at. After the PROPAGATE the Output trees are deleted and the REFERENCE variables should be reset to point at the root of the newly created trees. The module and schema level reference variables are not being reset and are thus left to point at the original syntax element which they were pointing at which will now have been reset leading to unexpected results. Resolution : The fix for this issue(IIB APAR IT14426) is available in IIB Maintenance Level 9.0.0.6. Issue 5 Summary : Customers using any Broker level from v7.x may experience inconsistent validation results when using FTM Channel based validation and/or IIB in ESQL parser validation. Resolution : IIB APAR IT14075 has been raised for this issue. Issue 6 Summary : FTM SWIFT SR2016 WTX maps will not work with FTM SWIFT SR2015 WTX maps at a single broker instance together at the same time. The reason is that IBM Transformation Extender has changed the JVCWrapper code with the new Financial Payments Pack for SWIFT 9.0.1 release and it is not compatible with the earlier Pack for SWIFT releases. Therefore using multiple Pack for SWIFT versions at the same time in a specific instance of a program is not supported. Issue 7 Summary : Debulking and Bulking Sample application : If the FTM database timezone is set to UTC and the runtime(IIB/Broker) timezone it set to a different timezone then bulking will not occur(ref:55056). ====================================================================== Installation information ====================================================================== Before proceeding with the installation process, view the online version of this readme file to check if information has changed since the readme file was downloaded. ==================================================================== Prior to installation ==================================================================== Before installing FTM v3.0.0.7, perform the following steps: - Download the fix pack tar file to an appropriate location. - Uncompress the tar file. ====================================================================== Installing ====================================================================== ==================================================================== Installing FTM v3.0.0.7 to create a new installation ==================================================================== - Start IBM Installation Manager. Add the location of the repository containing the FTM installation package: - Select File->Preferences. - Click Add Repository. - Browse to the directory containing the repository and select the file repository.config (if you are using a directory) or diskTag.inf (if you are using the installation CD) - Click Test Connections and click OK. - Click OK. - Transfer the FTM installation files to your installation directory: - On the main pane, click Install. - Select IBM Financial Transaction Manager for Multiplatforms and click Next. - Review the license agreements and click Next if appropriate. - On the first Install Packages pane, specify the shared resources directory of the Installation Manager and click Next. - On the second Install Packages pane, specify the installation directory (you must have write access to the directory) and click Next. - On the third Install Packages pane, do not change the selected features and click Next. - On the Install package summary information pane, click Install. - After installation is complete, click Finish. Follow the instructions in the "Financial Transaction Manager -> Installing" section of the "IBM FTM for Multiplatforms v3.0.0 documentation" available at https://www.ibm.com/support/knowledgecenter/SSRH46_3.0.0/SSRH46_3.0.0welcome.html ==================================================================== Installing FTM v3.0.0.7 to update an existing installation ==================================================================== - Start IBM Installation Manager. Add the location of the repository containing the FTM installation package: - Select File->Preferences. - Click Add Repository. - Browse to the directory containing the repository and select the file repository.config (if you are using a directory) or diskTag.inf (if you are using the installation CD) - Click Test Connections and click OK. - Click OK. - Transfer the FTM installation files to your installation directory: - On the main pane, click Update. - Select IBM Financial Transaction Manager for Multiplatforms and click Next. - Review the license agreements and click Next if appropriate. - On the first Install Packages pane, specify the shared resources directory of the Installation Manager and click Next. - On the second Install Packages pane, specify the installation directory (you must have write access to the directory) and click Next. - On the third Install Packages pane, do not change the selected features and click Next. - On the Install package summary information pane, click Install. - After installation is complete, click Finish. Follow the instructions in the "Financial Transaction Manager -> Planning -> Migration" section of the "IBM FTM for Multiplatforms v3.0.0 documentation" available at https://www.ibm.com/support/knowledgecenter/SSRH46_3.0.0/SSRH46_3.0.0welcome.html ====================================================================== Uninstalling if necessary ====================================================================== To rollback to the previous version of FTM: - Start Installation manager - Click Roll Back. - Select the Package Group name where FTM is installed. Database: Restore the backup taken during the Database migration step. Application Migration: Revert to the WebSphere Message Broker Toolkit workspace taken during the installation steps. Re-deploy the application bar files. OAC Migration: Re-deploy the OAC ear from the previous version. ====================================================================== List of fixes ====================================================================== Fixes included in FTM for Multiplatform v3.0.0.7 http://www-01.ibm.com/support/docview.wss?uid=swg21700249 ====================================================================== Copyright and trademark information ====================================================================== http://www.ibm.com/legal/copytrade.shtml Notices INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Microsoft, Windows, and Windows Server are trademarks of Microsoft Corporation in the United States, other countries, or both. Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Other company, product, or service names may be trademarks or service marks of others. THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION The license agreement for this product refers you to this file for details concerning terms and conditions applicable to third party software code included in this product, and for certain notices and other information IBM must provide to you under its license to certain software code. The relevant terms and conditions, notices and other information are provided or referenced below. Please note that any non-English version of the licenses below is unofficial and is provided to you for your convenience only. The English version of the licenses below, provided as part of the English version of this file, is the official version. Notwithstanding the terms and conditions of any other agreement you may have with IBM or any of its related or affiliated entities (collectively "IBM"), the third party software code identified below are "Excluded Components" and are subject to the following terms and conditions: - the Excluded Components are provided on an "AS IS" basis - IBM DISCLAIMS ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND CONDITIONS WITH RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING, BUT NOT LIMITED TO, THE WARRANTY OF NON-INFRINGEMENT OR INTERFERENCE AND THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE - IBM will not be liable to you or indemnify you for any claims related to the Excluded Components - IBM will not be liable for any direct, indirect, incidental, special, exemplary, punitive or consequential damages with respect to the Excluded Components. ====================================================================== Document change history ====================================================================== +--------------------+------------------------------------------------+ | Date | Description of change | +--------------------+------------------------------------------------+ | 12th May 2017 | Original publication date | +--------------------+------------------------------------------------+