============================================================================== = IBM WebSphere Business Integration for Financial Networks = = 5724-D9621 for Multiplatforms Extending Features V2.2.0 = = PTF UK48262 for APAR PK86884 = ============================================================================== 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 --------------------------- 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/run/msg/dnfcymsg.cat /dnf_02_02/run/res/dnfcymsg.xml /dnf_02_02/admin/data/dnfczcob.cli /dnf_02_02/admin/data/dnfczc1y.cli /dnf_02_02/admin/data/dnfczcoy.cli The following are new modules: /dnf_02_02/run/classes/Swift2009/dnfcvcks_sf09.jar /dnf_02_02/run/res/Swift2009/dnfcvrls_sf09.jar C. Post-Installation -------------------- After you have installed this PTF by extracting tar files: 1. Share the files with your customization system. 2. Ensure that the group ownership of the /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 /dnf_02_02/admin 3. Ensure that the group ownership of the /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 /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. 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/Swift2009/dnfcvcks_sf09.jar /dnf_02_02/run/res/Swift2009/dnfcvrls_sf09.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. E3. Restart all WebSphere BI for FN message brokers - - - - - - - - - - - - - - - - - - - - - - - - - - E4. Activate the message rule set for S.W.I.F.T. SR2009 - - - - - - - - - - - - - - - - - - - - - - - - - - - - Note: The S.W.I.F.T. SR2009 live date is currently planned for 21 November 2009. Before this date the new message rule set should not be activated on a production environment. To activate the message rule set for SR2009 in a business OU: 1. On the runtime system, log on to z/OS UNIX 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 SR2009 message rule set attribute value and commit the change: add -ou DNIvOU -ct DnfFinMsgVal -co DnfFinMsgVal -attr MsgRuleSet -val swift2009 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 SR2009 message rule set. E5. Activate the changed length check for S.W.I.F.T. SR2009 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Note: The S.W.I.F.T. SR2009 live date is currently planned for 21 November 2009. Before this date the new message length check should not be activated on a production environment. To activate the changed length check for SR2009: 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 *------------------------------------------------------------------------* * End of Migration * *------------------------------------------------------------------------* F. APARs addressed by this PTF ------------------------------ PK86884 SWIFT SR2009: 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 2009. PK86882 SWIFT SR2009: RESTRICTION TO LENGTH < 2000 WILL BE LIFTED FOR SOME MESSAGE TYPES With SWIFT Standard Release 2009 (SR2009) the length restriction of max. 2000 characters is lifted for the following message types: 202, 205 This requires the WebSphere BI for FN configuration value for attribute MaxLength2000 of type/object DnfExceptMsgAttr to change when the SR2009 goes live on 21 November 2009. +++ End +++ End +++ End +++ End +++ End +++ End +++ End +++