IBM(R) Financial Transaction Manager for Multiplatform Version 3.0.0.4 Readme Readme file for IBM(R) Financial Transaction Manager for Multiplatform Version 3.0.0.4 Product/Component Release: 3.0.0 Update Name:Fix Pack 4 Fix ID: 3.0.0-FTM-MP-fp0004 Publication Date: 09 December 2015 Last modified date: ====================================================================== Contents: Download location Prerequisites and co-requisites What's new in FTM 3.0.0.4 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.4 from Fix Central at the following location: http://www.ibm.com/eserver/support/fixes/ Search for the Fix ID: 3.0.0-FTM-MP-fp0004 ====================================================================== Prerequisites and co-requisites ====================================================================== Before downloading FTM v3.0.0.4, 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.4. - 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.4 ====================================================================== - Non Persisted transitions. - Command Line Model Extractor - Model validation function added. - Support the use of literal values in object queries. - Additional support for Actions written in Java. - Support for the generation of batched Swift messages in the FTM SWIFT MT FLOWS project. - New Model validation Rules. - New support in the OAC for Service Participant to Calendar Group relationships. - Enable Configuration Value entries to be set to NULL in the Model Tooling and the OAC. 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.4 ====================================================================== 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 : IBM Integration Bus(IIB) version 9.0.0.x 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 : This issue is with the FTM Fragmentation Sample on z/OS only. The Sanctions Filter Request channel is configured with NULL CCSID value resulting in failure processing response on Sanctions Filter Response channel. Symptom is a Map Aborted event that contains the DNIY3305E error code. Workaround : Change the CCSID for the Sanctions Filter Request channel via the OAC or RSA or by updating the Fragmentation CONFIG script as follows : CALL UPSERT_CHANNEL ( 1004, 'FTM Fragmentation Sample', '1.0.0', 1007, 1009, 1002, NULL, 'Sanctions Filter Request', NULL, 'Outbound Sanctions Filter Request to AML Party via MQ', 'N', 'Y', NULL, 'Y', 'Y', '', '++FXHQPREFIX++.++FXHFRAGSAMPQPREFIX++.AMLPARTY.FILTER_REQUEST', 50, '2010-06-30 12:14:28.987', NULL, 1208, -- <<<<<< changed this line from NULL to 1208 NULL, 0, NULL, 'N', NULL, NULL, NULL, 'CONFIG=MT_MAP_CFG_SANCTION_REQUEST,MSG_DEF_SET=finsample,PT_TYPE=' ||'SANCTIONS_REQUEST', 'N', 'SCRIPT:config.sql' ); Issue 5 Summary : This issue is with the Fragmentation Sample on all platforms in FTM v3.0.0.3 and v3.0.0.4. The Manual Intervention Service Participant is configured with NULL Rank value resulting in failure to update the Java cache. Symptom is an Unexpected Error event containing a java.lang.NullPointerException at the frequency of the Usage Count flow poll interval. Workaround : Change the Rank for the Manual Intervention Service Participant via the OAC or the RSA Model Tooling or by updating the Fragmentation CONFIG script as follows : CALL UPSERT_SVC_PARTICIPANT ( 'FTM Fragmentation Sample', '1.0.0', 1000, 1010, NULL, 'Manual Intervention', 'OP_COMMAND', 'PRIMARY', -- <<<<<< changed this line from NULL to 'PRIMARY' NULL, '00:00', '23:59', NULL, 'N', 'SCRIPT:config.sql', 1, 'SERVICE_PARTICIPANT', 'S_Available', 'N', NULL, '', '' ); ====================================================================== 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.4, perform the following steps: - Download the fix pack tar file to an appropriate location. - Uncompress the tar file. ====================================================================== Installing ====================================================================== ==================================================================== Installing FTM v3.0.0.4 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 "Installing" section of the "FTM for Multiplatforms Knowledge Center" available on the FTM Product website at http://www.ibm.com/software/industry/financial-transaction-manager/ ==================================================================== Installing FTM v3.0.0.4 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. - Database Migration: The following database changes will be made using the Migration Procedure below: 3.0.0.0 to 3.0.0.1 changes: - New INDEX CC_AP_IDX created for the APPLICATION table. - New INDEX CC_AV_IDX created for the APP_VERSION table. - Table EVENT_CONTEXT_OBJ has been dropped (deprecated). - Changed the data type of the COMPONENT_NAME column on the ERROR table to VARCHAR(100). - For DB2 only: Changed GENERATED attribute of the ID column on the OUT_REQ_CORREL table to BY DEFAULT. - For DB2 only: TXN_SEC_V_INS view updated to change ISF_DATA supported data length from 30k to 20k on inserts. - For Oracle only: Changed SWT_OUT_REQ_CORREL_ID trigger to allow the ID column on the OUT_REQ_CORREL table to be set or generated. - Added CACHE_LEARN column to the H_APP_VERSION table. - Added RENDER_MSG_OVERRIDE column to the H_APP_VERSION table. - Added LOG_EVENT_OVERRIDE column to the H_APP_VERSION table. 3.0.0.1 to 3.0.0.2 changes: - Dropped the CC_OE_FK constraint on the OBJ_BASE table - Changed the data type of the FSM_ACTION column on the FSM_TRANSITION table to VARCHAR(500). - Changed the data type of the OVERRIDE_SELECTION column on the FSM_TRANSITION table to VARCHAR(1000). - Added CURRENT_SCHEDULE_ENTRY column to the SVC_PARTICIPANT_BASE table. - Added CURRENT_SCHEDULE_ENTRY column to the H_SVC_PARTICIPANT_BASE table. - Added TRIGGER T_ERR_INS to set CREATED column in ERROR table. - Added SVP_TYPE parameter to UPSERT_OBJ_VALUE to facilitate Scheduler Task object values. - For Oracle only: T_CALENDAR_ENTRY_U trigger updated to resolve CAL_DATE issue. - For Oracle only: TRANSMISSION_V_INS trigger changed to update additional columns. - For Oracle only: CONVERT_UTC_TO_DB_TZ function refreshed to resolve timezone issue. 3.0.0.2 to 3.0.0.3 changes: - Created a number of new triggers(T_*_BI) on the configuration tables. 3.0.0.3 to 3.0.0.4 changes: - Added a new "PERSIST CHAR(1)" column to the "FSM_TRANSITION" table. Migration procedure: - Backup the database so that it may be rolled back should there be a problem during or after the migration process - On AIX/Linux for DB2 run the /admin/scripts/db2/migration/3.0.0.x_to_latest/Migrate-Unix.sh script. - On AIX/Linux for Oracle run the /admin/scripts/oracle/migration/3.0.0.x_to_latest/Migrate-Unix.sh script. - Application Migration: The following steps must be followed to migrate FTM applications and their runtime environment. - Ensure that the broker is correctly configured to use the JPLUGIN and CLASSES resources in \run - Make a backup of your current WebSphere Message Broker Toolkit workspace. - FTM applications in WebSphere Message Broker Toolkit workspaces must be migrated as follows: - Re-import the following resources, then rebuild and redeploy the applications bar file(s). - Re-import the FTM Core Flows (found in the /multiplatform/FXH_Core_Projects_WMB.zip file) into the workspace. - Re-import the FTM Generic Model Actions(found in /multiplatform/FXH_GenericModel.zip) into the workspace. - Re-import the FTM SWIFT MT Flows(found in /multiplatform/FXH_Core_Projects_WMB.zip) into the workspace. - OAC Migration: The OAC ear file must be re-deployed to the Websphere Application Server from \multiplatform\FXH_Console.zip - RSA Model Tooling Migration: The following steps must be followed to migrate the FTM Model Tooling and existing FTM Models: - Follow the Installing > Installing the FTM Model Tools package > Installation instructions section in the FTM Knowledge Center to install the new Model Tooling from /multiplatform/FXH_FSM_Model_Tools.zip - To migrate an existing FTM FSM Model, open the model in RSA. If any migration issues are encountered, a report file in HTML format will be created in the RSA workspace. - Tools Migration: The Usage Reporting Tool and the Purge Utility, which can be found at /tools/, have been updated. ====================================================================== 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.4 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 | +--------------------+------------------------------------------------+ | 09 December 2015 | Original publication date | +--------------------+------------------------------------------------+