============================================================================== ============================================================================== Licensed materials - Property of IBM 5724-D96 (C) Copyright IBM Corp. 2002, 2015 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.1 Message Management PTF UI31657 for APAR PI49512 Driver level: 5401 Date 2015-10-16 ============================================================================== ============================================================================== Table of contents ----------------- A About this document B Summary of changes C Planning D Installation E APAR details F Other changes G Known issues 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-01.ibm.com/support/docview.wss?uid=swg27041133 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. 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 temporary directory which contains the fix for later on installation. The file name of this PTF driver. The names of users, groups, files, and directories are the same as those used in WebSphere BI for FN for Multiplatforms 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: PI49512 MM VALID MESSAGES MARKED WRONGLY AS UNPARSABLE IN MIGTPL Additional functional changes: - none Documentation updates: - none The following modules have been changed: /dnqv311/run/classes/dnqcaadm.jar C. Planning ----------- C1. Checks to be done >>BEFORE<< installing a new PTF ----------------------------------------------------- 1. Check if you have any efixes (emergency fixes) applied in your WebSphere BI for FN installation. In case you have efixes installed after your previous WebSphere BI for FN PTF installation and migration contact your IBM support before installing and migrating this PTF. 2. Ensure that all previously prepared deployment instructions were carried out. 3. Ensure that all previous CDD changes were implemented using the CDP. To check this, log on to AIX on the customization system as a customizer (ucust1) and enter the following command on your customization system: /dniv311/admin/bin/dnicdpst -i -cdefs where The name of the WebSphere BI for FN instance The name of the customization definitions directory as specified in the CDP ini file, for example: /var/dni_03_01/cus/defs If the response to this command indicates that a customization operation is still pending and it was carried out in: - Customization mode (dnicdp), implement the pending operation before continuing. - Migration mode (dnicdpm): - Ensure that you have not yet shared the files contained in this or any other PTF as described in section D5 step 2. - Implement the pending operation before continuing. 4. Until the migration for this PTF has been completely finished, ensure that no changes are made to the currently implemented CDD. 5. Ensure that 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'. 6. Ensure that 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 -rg % -qo mor [only for SYSOU] > list -user % -qo mor The list command should result in 'No roles/role groups/users found that match specified criteria'. C2. Prerequisite and supersede information ------------------------------------------ This PTF requires the following PTFs: - UI29379 for APAR PI42896 (MM 3.1.1.18, SWIFT SR2015: MESSAGE MANAGEMENT UPDATES FOR SWIFT SR2015 CHANGES). C3. Roles involved ------------------ The activities in this PTF involve the following roles: - Installer (root) - Customizer (ucust1) D. Installation --------------- D1. Stopping all sessions and services you use ---------------------------------------------- NOT APPLICABLE D2. Stopping all application servers ------------------------------------ NOT APPLICABLE D3. Stopping all WebSphere BI for FN message brokers ---------------------------------------------------- NOT APPLICABLE D4. Backing up your system -------------------------- Backup the module which will be updated by this PTF. Please refer to the deliverable list in section "B. Summary of changes". D5. Installing PTF ------------------ 1. Upload the PTF driver in binary mode to a temporary directory in AIX named . 2. Log on to AIX as root. 3. Change the working directory to : cd 4. Enter following command in AIX to unpackage the PTF driver: tar -xvf / 5. Ensure that the ownership of the changed module is set to user root and group dnilpp. To do this, enter the following command in AIX: chown root:dnilpp /dnqv311/run/classes/dnqcaadm.jar D6. Steps on a customization system ----------------------------------- NOT APPLICABLE D7. Following the deployment instructions created in step D6 -------------------------------------------------------------- NOT APPLICABLE D8. Additional activities ------------------------- NOT APPLICABLE D9. Restarting all WebSphere BI for FN message brokers ------------------------------------------------------ NOT APPLICABLE D10. Prepare BAR file deployment -------------------------------- NOT APPLICABLE D11. Deploy updated BAR files ----------------------------- NOT APPLICABLE D4. Generating configuration data migration scripts --------------------------------------------------- NOT APPLICABLE D12. Migrating configuration data --------------------------------- NOT APPLICABLE D13. Updating the WebSphere BI for FN enterprise application ------------------------------------------------------------ NOT APPLICABLE D14. Restarting all sessions and services ----------------------------------------- NOT APPLICABLE D15. Updating the Toolkit development environment ------------------------------------------------- NOT APPLICABLE D16. Verifying your Installation --------------------------------- NOT APPLICABLE *------------------------------------------------------------------------------* * End of Installation * *------------------------------------------------------------------------------* E. APAR details --------------- Fixes for the following APARs are contained in this PTF: PI49512 MM VALID MESSAGES MARKED WRONGLY AS UNPARSABLE IN MIGTPL Formerly, the migtpl command which was introduced with PTF UI30439 to facilitate the migration of expired message templates to a recent message definition set, erroneously identified templates as unparsable. As a result the templates could not be used any longer. Now, this has been fixed. F. Other changes ---------------- NOT APPLICABLE G. Known issues --------------- NOT APPLICABLE ++++ End +++ End +++ End +++ End +++ End +++ End +++ End +++ End +++ End ++++