============================================================================== ============================================================================== 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 Message Management PTF UK61129 for APAR PM22475 = Date 2010-10-15 = ============================================================================== ============================================================================== ============================================================================== 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 name of the organizational unit. Depending on the context, this might be SYSOU, DNFSYSOU, or the name of a business OU. The home directory of the application server profile. /usr/IBM/WebSphere/AppServer/profiles/AppSrv01 is used in examples. The names of users, groups, files, and directories are the same as those used in "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: PM22475 MM NAK CODES FOR SR2010 CHANGES (see functional changes below for details) Functional changes: - NAK codes changed for SR2010: B01, C01, C02, C03, C05, C28, C29, C32, C34, C35, C38, C39, C41, C42, C50, C58, C59, C62, C65, C71, C80, C87, C89, D07, D19, D25, D29, D36, D56, D57, D92, E03, E24, E37, E41, E57, E58, E59, E76, E77, E78, E80, E82, E84, E87, E99, G05, G08, G17, G24, H55, Knn, M75, S72, T03, T04, T14, T27, T39, T45, T47, T61, T85, T86, U00, V21, V62 - NAK codes new for SR2010: S76, V69, V70, V71, V72, V73, V74 - New functionality has been added to allow to use IBM Cognos report from within the WebSphere BI for FN Message Management V3.1.0 environment. For further information, please refer to documentation on the WebSphere BI for FN support web-site. Documentation updates: The following manuals have been changed: - none The following modules have been changed: /dnq_03_01/run/appsrv/dnq.app.main.ear 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 contains the MER enterprise application for use on a WebSphere Application Server running on AIX. If the MER enterprise application ran in conjunction with WebSphere BI for FN for z/OS, following PTFs must be applied: - UK58117 for APAR PM07598 (SWIFT SR2010: NEW CHECKS AND RULES FOR WEBSPHERE BI FOR FN MESSAGE VALIDATION) - UK59697 for APAR PM13490 (MESSAGE MANAGEMENT UPDATES FOR SWIFT SR2010 CHANGES) If the MER enterprise application ran in conjunction with WebSphere BI for FN for AIX, following PTFs must be applied: - UK58142 for APAR PM07599 (3.1.0.4, SWIFT SR2010: NEW CHECKS AND RULES FOR WEBSPHERE BI FOR FN MESSAGE VALIDATION) - UK58149 for APAR PM13495 (3.1.0.4, MESSAGE MANAGEMENT UPDATES FOR SWIFT SR2010 CHANGES) Roles involved: The activities in this PTF involve the following roles: - Installer (root) - WebSphere MB administrator (uwmba1) - WebSphere Application Server operator (uwaso1) - WebSphere Application Server administrator (uwasa1) D. Preparation -------------- D1. Installation ---------------- 1. Backup the changed file. 2. Save the fix to a temporary folder . 3. Change the working directory to 4. Enter following command in AIX to untar the fix: tar xvf / 5. Share the files in the following directories with your runtime systems: /dnq_03_01/run/appsrv 6. Set the group ownership of these directories and files to group dnilpp. To do this, enter the following command in AIX: chgrp -R dnilpp /dnq_03_01/run/appsrv D2. Steps on a customization system ----------------------------------- NOT APPLICABLE. D3. Copy DB2 modules to data sets --------------------------------- NOT APPLICABLE. D4. Generating configuration data migration scripts --------------------------------------------------- NOT APPLICABLE. D5. 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 ------------------------------------ Stop all application servers. E3. Stopping all WebSphere BI for FN message brokers ---------------------------------------------------- NOT APPLICABLE. E4. Sharing the runtime directory structure ------------------------------------------- 1. Share the files in the /dnq_03_01/run directory with the runtime systems. 2. Set the group ownership of these directories and files to group dnilpp. To do this, enter the following command in AIX: chgrp -R dnilpp /dnq_03_01/run 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 ------------------------- 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 ------------------------------------------------------------ E11.1. Backing up the WebSphere Application Server configuration - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Which resources you need to back up depends on whether you use a clustered application server environment or a single server: - If you have a clustered application server environment, back up your deployment manager profile and all other profiles on all nodes that belong to the cluster. - If you have a single application server environment, back up the application server profile. As the WebSphere Application Server operator (uwaso1), issue the following command for each profile that is to be backed up: /bin/backupConfig.sh where represents the file name under which the backup should be stored. E11.2. Update the WebSphere Application Server environment - - - - - - - - - - - - - - - - - - - - - - - - - - - - - NOT APPLICABLE. E11.3. Migrating the enterprise application - - - - - - - - - - - - - - - - - - - - - - Start the application server on which the enterprise application runs. If you use a clustered application server environment, start the deployment manager, node agents, and all members of the application server cluster. Issue the following command with the user ID of the WebSphere Application Server operator (uwaso1): /bin/wsadmin.sh -user -password -lang jython -f /dnqccupd.py where: The user ID of the WebSphere Application Server administrator (uwasa1). The password of the user. The path to the migration script: /dnq_03_01/run/appsrv. The path to the MER ear file: /dnq_03_01/run/appsrv. 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: PM22475 MM NAK CODES FOR SR2010 CHANGES THE SWIFT NAK CODES HAVE BEEN CHANGED TO REFLECT THE CHANGES WITH SWIFT NOVEMBER 2010 CHANGES (SR2010). NAK codes changed for SR2010: B01, C01, C02, C03, C05, C28, C29, C32, C34, C35, C38, C39, C41, C42, C50, C58, C59, C62, C65, C71, C80, C87, C89, D07, D19, D25, D29, D36, D56, D57, D92, E03, E24, E37, E41, E57, E58, E59, E76, E77, E78, E80, E82, E84, E87, E99, G05, G08, G17, G24, H55, Knn, M75, S72, T03, T04, T14, T27, T39, T45, T47, T61, T85, T86, U00, V21, V62 NAK codes new for SR2010: S76, V69, V70, V71, V72, V73, V74 G. Other changes ---------------- NOT APPLICABLE. ++++ End +++ End +++ End +++ End +++ End +++ End +++ End +++ End +++ End ++++