============================================================================== = IBM WebSphere Business Integration for Financial Networks = = 5724-D9621 for Multiplatforms Extending Features V2.2.0 = = PTF UK38551 for APAR PK67184 and PK67185 = ============================================================================== Table of contents ----------------- A. How to use this document B. Changes to your current system C. Post-Installation D. Steps on a customization system E. Steps on a run-time system F. APARs addressed by this PTF A. How to use this document --------------------------- This PTF contains an update to the message length check required by the S.W.I.F.T. Standard Release 2008 (SR2008) changes. You have to implement this change in WebSphere BI for FN even if you validate your messages before you send them to WebSphere BI for FN (e.g. in MERVA). Since the S.W.I.F.T. SR2008 live date is currently planned for 15 November 2008, it must not be activated in a production environment prior that date (see E1. Activate the changed length check for S.W.I.F.T. SR2008). However, installing this PTF does not automatically activate the changed length check for SR2008 so that you can apply the PTF before the live date. This document assumes the following: 1. The installation directory of Extension for SWIFTNet is /opt/IBM 2. The names of users, groups, files, directories, etc. are the same as those used in the "Planning, Installation and Customization" manual. If you use different names, use those names instead of the names shown here. B. Changes to your current system --------------------------------- The following modules have been changed: /dnf_02_02/admin/data/dnfczc1y.cli /dnf_02_02/run/msg/dnfcymsg.cat /dnf_02_02/run/res/dnfcymsg.xml The following are new modules: /dnf_02_02/run/classes/Swift2008/dnfcvcks_sf08.jar /dnf_02_02/run/res/Swift2008/dnfcvrls_sf08.jar C. Post-Installation -------------------- After you have installed this PTF using ISMP: 1. Share the files with your customization system. 2. Ensure that the group ownership of the /opt/IBM/dnf_02_02/admin directory and all subdirectories and files therein is set to group dniadmin. To do this, enter the following command in AIX: chgrp -R dniadmin /usr/lpp/dnf_02_02/admin 3. Ensure that the group ownership of the /opt/IBM/dnf_02_02/run directory and all subdirectories and files therein is set to group dnilpp. To do this, enter the following command in AIX: chgrp -R dnilpp /usr/lpp/dnf_02_02/run D. Steps on a customization system ----------------------------------- No steps on the customization system required. E. Steps on a run-time system ------------------------------ E1. Stop all WebSphere BI for FN message brokers - - - - - - - - - - - - - - - - - - - - - - - - - E2. Backup and install the fixes - - - - - - - - - - - - - - - - - 1. Backup following files: /dnf_02_02/admin/data/dnfczc1y.cli /dnf_02_02/run/msg/dnfcymsg.cat /dnf_02_02/run/res/dnfcymsg.xml 2. Make a new directory for SR2008 rule set by following command: mkdir /dnf_02_02/run/classes/Swift2008 mkdir /dnf_02_02/run/res/Swift2008 3. Copy files in the fix to the proper directory 4. Check the permission of directories and files as described in section C E3. Update the WebSphere MB environment - - - - - - - - - - - - - - - - - - - - To make the new message rule set libraries available to WebSphere BI for FN, ensure that the CLASSPATH environment variable includes: /dnf_02_02/run/classes/Swift2008/dnfcvcks_sf08.jar /dnf_02_02/run/res/Swift2008/dnfcvrls_sf08.jar The location of the broker-specific WebSphere MB configuration data and how to activate changed configuration data depends on the WebSphere MB version used. Please see the WebSphere BI for FN 'Planning, Installation and Customization' manual, chapter 'Preparing a message broker' for further details. E4. Restart all WebSphere BI for FN message brokers - - - - - - - - - - - - - - - - - - - - - - - - - - E5. Activate the changed length check for S.W.I.F.T. SR2008 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Note: The S.W.I.F.T. SR2008 live date is currently planned for 15 November 2008. Before this date the new message length check should not be activated on a production environment. To activate the changed length check for SR2008: 1. On the runtime system, log on to AIX with the user ID of a WebSphere BI for FN system configuration administrator (for example, sa1 or sa2). Ensure that you also have read access to /dnf_02_02/admin/data/dnfczc1y.cli, e.g. by being member of the group dniadmin. Alternatively, you can ask the customizer (for example, ucust1) for a copy of the file. 2. Execute your profile for the runtime environment, for example: . /var/dnf_02_02/run/dnfprofile 3. Start the command line interface (CLI) in transactional command file mode and execute the commands in the file dnfczc1y.cli by entering the following command on a single line: dnicli -ou SYSOU -s DNI_SYSADM -cft /dnf_02_02/admin/data/dnfczc1y.cli This command file changes the value of the MaxLength2000 attribute and commits the SYSOU. 4. Log on to AIX with the user ID of another WebSphere BI for FN system configuration administrator. 5. Execute your profile for the runtime environment, for example: . /var/dnf_02_02/run/dnfprofile 6. Start the CLI: dnicli -ou SYSOU -s DNI_SYSADM 7. Enter the following commands in your CLI session to approve and deploy the changes: app -ou SYSOU dep -ou SYSOU E6. Activate the message rule set for S.W.I.F.T. SR2008 - - - - - - - - - - - - - - - - - - - - - - - - - - - - To activate the message rule set for SR2008 in a business OU: 1. On the runtime system, log on to AIX with the user ID of WebSphere BI for FN system configuration administrator (sa1 or sa2). 2. Execute your profile for the runtime environment, e.g.: . /var/dnf_02_02/run/dnfprofile 3. Start the command line interface (CLI): dnicli -ou SYSOU -s DNI_SYSADM 4. Enter the following commands in your CLI session to set the SR2008 message rule set attribute value and commit the change: add -ou DNIvOU -ct DnfFinMsgVal -co DnfFinMsgVal -attr MsgRuleSet -val swift2008 com -ou DNIvOU 5. Log on to AIX with the user ID of another WebSphere BI for FN system configuration administrator. 6. Execute your profile for the runtime environment, e.g.: . /var/dnf_02_02/run/dnfprofile 7. Start the command line interface (CLI): dnicli -ou SYSOU -s DNI_SYSADM 8. Enter the following commands in your CLI session to approve and deploy the changes: app -ou DNIvOU dep -ou DNIvOU Note: In the previous steps, replace DNIvOU with the business OU for which you want to activate the SR2008 message rule set. *------------------------------------------------------------------------* * End of Migration * *------------------------------------------------------------------------* F. APARs addressed by this PTF ------------------------------ PK67184 SWIFT SR2008: RESTRICTION TO LENGTH < 2000 WILL BE LIFTED FOR SOME MESSAGE TYPES With SWIFT Standard Release 2008 (SR2008) the following message types previously restricted to at most 2000 characters may then be longer: 499, 707, 734, 750, 799 In addition, the new message type 620 also does not have this restriction. The WebSphere BI for FN configuration value for attribute MaxLength2000 has to be adapted. This PTF provides a CLI script to implement the update. PK67185 SWIFT SR2008: NEW CHECKS AND RULES FOR WEBSPHERE BI FOR FN MESSAGE VALIDATION. This PTF deliveres support for checking FIN messages according to the S.W.I.F.T. Standard Release 2008. +++ End +++ End +++ End +++ End +++ End +++ End +++ End +++