============================================================================== ============================================================================== Licensed materials - Property of IBM 5724-D96 (C) Copyright IBM Corp. 2002, 2010 All Rights Reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. ============================================================================== ============================================================================== README for IBM(R) WebSphere(R) Business Integration for Financial Networks for Multiplatforms V3.1.0 SUPPORT FOR SWIFTNET FIN, SWIFTNET INTERACT, FINANCIAL MESSAGE TRANSFER PTF UK54053 for APAR PM08776 = Date 2010-05-14 = ============================================================================== ============================================================================== ============================================================================== Table of contents ----------------- A About this document B Summary of changes C Planning D Preparation E Activating F APAR details G Other changes A. About this document ---------------------- Only the online version of this readme document is current. Before you install the corresponding PTF, download the latest version from: http://www.ibm.com/software/integration/wbifn/support Download the latest version of the WebSphere BI for FN product documentation from: http://www.ibm.com/software/integration/wbifn/library The structure of WebSphere BI for FN readme documents is identical for all PTFs. Sections that are not applicable are left blank. If you install more than one PTF at a time, combine the readme documents by merging the contents of each section. The installation of this PTF is done in two phases: 1. Preparation - During this phase your system can continue to process messages as usual. 2. Activation - During this phase your system cannot process messages. This readme document uses the following variables: The installation directory of WebSphere BI for FN. The directory /opt/IBM is used in examples. The customization directory. The directory /var/dni_03_01/cus is used in examples. The deployment directory. The directory /var/dni_03_01/cus/depdata is used in examples. The name of the WebSphere BI for FN instance. The name INST1 is used in examples. The name of the organizational unit. Depending on the context, this might be SYSOU, DNFSYSOU, or the name of a business OU. The name of the runtime database. The name DNIDBRUN is used in examples. The names of users, groups, files, and directories are the same as those used in the 'Planning, Installation, and Customization'. If you use different names, use those names instead of the names shown here. B. Summary of changes --------------------- APARs addressed by this PTF: PM08776 FIN SFD PROCESS DNFCFSFD AND DNFCFSFS WOULD NOT END AFTER LOGOUT SUCCESSFULLY PM08016 FIN MWH UDF RETURNED NULL IF NO FIN MESSAGE WAS FOUND IN SELECTED COLUMN Functional changes: NOT APPLICABLE. Documentation updates: NOT APPLICABLE. The following modules have been changed: /dnf_03_01/run/bin/dnfcfsfd /dnf_03_01/run/bin/dnfcfsfs /dnf_03_01/run/classes/dnfcdrtn.jar /dnf_03_01/run/lib/libdnfcf.a C. Planning ----------- Before installing a new PTF, ensure that: - All previously prepared deployment instructions have been carried out. - All previous CDD changes have been implemented using the CDP. - All configuration administration changes have been deployed. To check this, enter the following commands: dnicli -s DNI_SYSADM -ou SYSOU > list -ou % -qo amorz > list -cos % -qo amorz > list -ct % -qo amorz Each list command should result in 'No [OU/COS/CT] match search criteria'. - All security administration changes have been approved. To check this, enter the following commands for each OU: dnicli -s DNI_SECADM -ou > list -ro % -qo mor [only for SYSOU] > list -user % -qo mor Each list command should result in 'No roles found that match specified criteria'. Customization changes other than those described in a PTF readme document are not allowed during PTF installation. Prerequisite and supersede information: This PTF requires XL C/C++ Enterprise Edition for AIX, V9.0.0.5 to be installed with. This PTF requires the following PTFs: - UK51823 for APAR PK97167 (UPDATES FOR WEBSPHERE BI FOR FN SUPPORT FOR SWIFTNET FIN, SWIFTNET INTERACT, AND FMT). - UK54898 for APAR PM08215 (UPDATES ON MESSAGE STANDARDS COMPONENT). This PTF supersedes the following PTFs: not applicable Roles involved: The activities in this PTF involve the following roles: - Installer (root) - DB2 administrator (udb2adm1) - WebSphere MB administrator (uwbimba1) D. Preparation -------------- D1. Installation ---------------- 1. Stop all sessions and services, for example: - Stop all applications that send requests to WebSphere BI for FN. - Log out SIPN FIN LTs. - Release SWIFTNet SnF queues. - Stop the MSIF Transfer service. - Stop the Enhanced InterAct services. - Close all dnicli sessions. For further information, refer to the section of 'System Administration' that describes how to operate components, sessions, and services. 2. Stop all WebSphere BI for FN message brokers. 3. Install this PTF using as described in the 'Installing WebSphere BI for FN' in 'Planning, Installation and Customization' manual. 4. Set the group ownership of these directories and files to group dnilpp. To do this, enter the following command in AIX: chgrp -R dnilpp /dnf_03_01/run 5. Restart all WebSphere BI for FN message brokers. 6. Restart all of the sessions and services that you use. How to do this depends on which WebSphere BI for FN features you use. For example: - Log in SIPN FIN LTs. - Start the MSIF Transfer service. - Start the Enhanced InterAct services. - Acquire SWIFTNet SnF queues. - Start the applications that send requests to WebSphere BI for FN. For further information, refer to the section of 'System Administration' that describes how to operate components, sessions, and services. D2. Steps on a customization system ----------------------------------- NOT APPLICABLE. D3. Generating configuration data migration scripts --------------------------------------------------- NOT APPLICABLE. D4. Customize updated BAR files when not using the BAP (dniczbap) to deploy them -------------------------------------------------------------------------------- NOT APPLICABLE. *------------------------------------------------------------------------------* * End of Preparation * *------------------------------------------------------------------------------* E. Activating ------------- E1. Stopping all sessions and services you use ---------------------------------------------- NOT APPLICABLE. E2. Stopping all application servers ------------------------------------ NOT APPLICABLE. E3. Stopping all WebSphere BI for FN message brokers ---------------------------------------------------- NOT APPLICABLE. E4. Sharing the runtime directory structure ------------------------------------------- NOT APPLICABLE. E5. Backing up configuration and security data in image copies -------------------------------------------------------------- NOT APPLICABLE. E6. Following the deployment instructions created in step D2.4 -------------------------------------------------------------- NOT APPLICABLE. E7. Additional activities ------------------------- E7.1. DB2 related activities - - - - - - - - - - - - - - To install a new version of the DB2 User Defined Function (UDF) DNFMWHFINMSG: 1. On the runtime system, log on to AIX as a DB2 administrator (udb2adm1). 2. Run your customization profile by entering the following command: . /var/dni_03_01/cus/dnicus_ 3. Enter the following command: export PATH=$DNF_PATH/run/bin:$PATH 4. Enter the following command on a single line: dnfxdrtn [-jar ] -t /var/dni_03_01/run/routines where: The directory containing the file dnfcdrtn.jar. The default is $DNF_PATH/run/classes. This command extracts the class file from the jar file and stores it into following directory: /var/dni_03_01/run/routines/com/ibm/dnf/dbm/rtn You can check log file dnfrundb.log and trace file dnfrundb.trc in the current directory when return code is not equal to 0. Make sure the routine classes have been updated. For refresh routine classes that have been created or updated, you have to issue the following DB2 command in DB2 command mode to force DB2 to load the new classes: db2 => CONNECT TO db2 => CALL SQLJ.REFRESH_CLASSES() db2 => CONNECT RESET E7.2. WebSphere MB related activities - - - - - - - - - - - - - - - - - - - NOT APPLICABLE. E8. Restarting all WebSphere BI for FN message brokers ------------------------------------------------------ NOT APPLICABLE. E9. Redeploy updated BAR files ------------------------------ NOT APPLICABLE. E10. Migrating configuration data --------------------------------- NOT APPLICABLE. E11. Updating the WebSphere BI for FN enterprise application ------------------------------------------------------------ NOT APPLICABLE. E12. Restarting all sessions and services ----------------------------------------- NOT APPLICABLE. E13. Updating the Toolkit development environment ------------------------------------------------- NOT APPLICABLE. *------------------------------------------------------------------------------* * End of Activating * *------------------------------------------------------------------------------* F. APAR details --------------- Fixes for the following APARs are contained in this PTF: PM08776 FIN SFD PROCESS DNFCFSFD AND DNFCFSFS WOULD NOT END AFTER LOGOUT SUCCESSFULLY After migrating from WBIFN 2.2 to 3.1 on AIX 5.3, with a normal Login/Select command request, there have a pair of dnfcfsfd and dnfcfsfs processes on system. And the pair of processes should be ended after a successful Logout command. However, the processes cannot be ended normally after upgrading to WBIFN 3.1. PM08016 FIN MWH UDF RETURNED NULL IF NO FIN MESSAGE WAS FOUND IN SELECTED COLUMN Formerly, when the selected MWH column did not contain a element or an empty element, the User Defined Function (UDF) returned with an SQLSTATE 01HW0 and stopped the table selection. Now, if the specified column does not contain a element, the result is the NULL value. If the element is empty, the result is an empty string. In both cases the selection is continued. For more information see 'System Administration', chapter 'User defined functions'. H. Other changes ---------------- NOT APPLICABLE. ++++ End +++ End +++ End +++ End +++ End +++ End +++ End +++ End +++ End ++++