============================================================================== ============================================================================== Licensed materials - Property of IBM 5724-D96 (C) Copyright IBM Corp. 2002, 2011 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 Base PTF UK68439 for APAR PM40373 = Date 2011-08-05 = ============================================================================== ============================================================================== ============================================================================== Table of contents ----------------- A About this document B Summary of changes C Planning D Preparation E Activating F APAR details G Other changes H Known issues A. About this document ---------------------- If you install this PTF as part of the migration from version 3.1 to 3.1.1 then do not follow the steps in this readme, but those described in the Migration Guide. 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 home directory of the application server profile. /usr/IBM/WebSphere/AppServer/profiles/AppSrv01 is used in examples. 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 WebSphere BI for FN for Multiplatforms Planning, Installation, and Customization, SH12-6942. If you use different names, use those names instead of the names shown here. B. Summary of changes --------------------- APARs addressed by this PTF: PM40373 BASE Updates for WebSphere BI for FN 3.1.1 PM42534 BASE USE THE @ TO MARK A GROUP WITH ACCESS AUTHORITY IN CDD PM40515 BASE INTERNAL ERROR EVENT DNFL2000E DOES NOT CONTAIN DETAILED INFORMATION FOR THE USER AND WILL BE REPLACED BY DNFL2155E PM40386 BASE ASP IMPORT LASTS MORE THAN AN HOUR PM40580 BASE WBI 311 MIGRATION - UNNECESSARY DELETE AND DEFINE OF QUEUES PM42010 BASE DSNT408I SQLCODE = -206 DURING INSTALLATION OF WBI-FN 3.11 Functional changes: - RMA: - Filters can now combine criteria with logical OR - Filters can be stored and loaded - you can manually mark queries as answered - the context root of RMA is now set via placeholder DNFvRMACONTROOT instead of a property in DnfRmaPy.properties - a personal home screen was introduced that provides links to all enterprise applications that a user is authorized for - support for SWIFTNet 7.0 system messages was added - the command 'queryasp' was added to service DNF_L_ADM - the DNI_SYSOP service was extended with the commands query, retry and cleanup - the WebSphere BI for FN MQRFH2 schemas have been updated to reflect the the latest changes in MSIF Documentation updates: The following manuals have been changed: - Planning, Installation, and Customization - Concepts and Components - Messages and Codes - System Administration - Application Programming - User Guide - Information Center - Migration Information - Release Information The following modules are new: /dniv311/admin/appsrv/res/dni.home.ear /dniv311/admin/appsrv/dniapplicationlibrary.py /dniv311/admin/data/dniczrtf.txt /dniv311/admin/data/dnicdi01.ddl /dniv311/admin/data/dnicdm01.ddl /dniv311/admin/data/dnicdg01.ddl /dniv311/admin/data/dnfclaph.applist /dniv311/admin/data/DnfRma_upd.py /dniv311/admin/data/DniWebHome_upd.py /dniv311/run/classes/com.ibm.dni.msgstds.defset.sys70.xml /dniv311/run/classes/dnicvcks_ssys70.jar /dniv311/run/classes/dnicvrls_ssys70.jar /dniv311/run/lib/libdnibip64.a /dniv311/run/lib/libdnic64.a /dniv311/run/lib/libdnicpcac64.a /dniv311/run/lib/libdnicpcom64.a /dniv311/run/lib/libdnicpshm64.a /dniv311/run/lib/libdnicq64.a /dniv311/run/lib/libdnidata64.a /dniv311/run/lib/libdnig64.a /dniv311/run/lib/libdnigbip64.a /dniv311/run/lib/libdnimes64.a /dniv311/run/lib/libdnipjni64.a /dniv311/run/lib/libdnixml64.a /dniv311/run/lil64/dnfrmexp64.lil /dniv311/run/lil64/dnfrmimi64.lil /dniv311/run/lil64/dniacp64.lil /dniv311/run/lil64/dniavn64.lil /dniv311/run/lil64/dnicin64.lil /dniv311/run/lil64/dnicnp64.lil /dniv311/run/lil64/dnicpn64.lil /dniv311/run/lil64/dnictp64.lil /dniv311/run/lil64/dnidpl64.lil /dniv311/run/lil64/dnievn64.lil /dniv311/run/lil64/dnignde64.lil /dniv311/run/lil64/dnimfp64.lil /dniv311/run/lil64/dniscpn64.lil /dniv311/run/res/dnicosdf.xml The following modules have been changed: /dniv311/admin/data/dnf.properties /dniv311/admin/data/dnf.xml /dniv311/admin/data/DNFCOMMON.xml /dniv311/admin/data/dnfczcar.cli /dniv311/admin/data/dnfczcat.cli /dniv311/admin/data/dnfczcoy.cli /dniv311/admin/data/dnfczlco.ddl /dniv311/admin/data/dnfczmlc.txt /dniv311/admin/data/DnfRma.py /dniv311/admin/data/DnfRmaPy.properties /dniv311/admin/data/DNFRMA.xml /dniv311/admin/data/dnicdcct.ddl /dniv311/admin/data/dnicdcig.ddl /dniv311/admin/data/dnicdcts.ddl /dniv311/admin/data/dnicdict.ddl /dniv311/admin/data/dnicddct.ddl /dniv311/admin/data/dnicddts.ddl /dniv311/admin/data/DNICOMMON.xml /dniv311/admin/data/dniczcpa /dniv311/admin/data/dniczwcf.txt /dniv311/admin/data/DNIWAS.xml /dniv311/admin/data/DniWebHome.py /dniv311/admin/data/DNIWEBHOME.xml /dniv311/admin/data/dni.xml /dniv311/admin/appsrv/dniapplication.py /dniv311/admin/appsrv/dniasset.py /dniv311/admin/appsrv/dnicommon.py /dniv311/admin/appsrv/dnidatasource.py /dniv311/admin/appsrv/dniinstapi.py /dniv311/admin/appsrv/dnimain.py /dniv311/admin/appsrv/dniqueue.py /dniv311/admin/appsrv/dnisetup.py /dniv311/admin/appsrv/dnitracelib.py /dniv311/admin/appsrv/DniWasInst.py /dniv311/admin/appsrv/res/dnf.rma.web.ear /dniv311/admin/bin/dnicdp.jar /dniv311/admin/toolkit/dni.schemas.comibmdni.zip /dniv311/run/bin/dnfczmlc.sh /dniv311/run/classes/com.ibm.dni.msgstds.defset.sys63.xml /dniv311/run/classes/com.ibm.dni.msgstds.ibmapi.CommonMessageDomainService.xml /dniv311/run/classes/dnicvcks.jar /dniv311/run/classes/dnicvcks_seni1.jar /dniv311/run/classes/dnicvcks_sfmtxml09.jar /dniv311/run/classes/dnicvcks_sfmtxml10.jar /dniv311/run/classes/dnicvcks_sfunds40.jar /dniv311/run/classes/dnicvcks_sfunds41.jar /dniv311/run/classes/dnicvcks_sfunds42.jar /dniv311/run/classes/dnicvcks_ssys63.jar /dniv311/run/classes/dnicvrls_seni1.jar /dniv311/run/classes/dnicvrls_sfmtxml09.jar /dniv311/run/classes/dnicvrls_sfmtxml10.jar /dniv311/run/classes/dnicvrls_sfunds40.jar /dniv311/run/classes/dnicvrls_sfunds41.jar /dniv311/run/classes/dnicvrls_sfunds42.jar /dniv311/run/classes/dnicvrls_ssys63.jar /dniv311/run/classes/dniczbap.jar /dniv311/run/classes/dnp.jab.jar /dniv311/run/data/dnfczcar.cli /dniv311/run/data/dnfczcat.cli /dniv311/run/data/dnfczcoy.cli /dniv311/run/flows/DNF_RM.bar /dniv311/run/flows/DNI_SYSOP.bar /dniv311/run/jplugin/dnf.asp.imp.jar /dniv311/run/jplugin/dnfclval.jar /dniv311/run/lil/dnfrmimi.lil /dniv311/run/lil/dnicin.lil /dniv311/run/msg/dnfclmsg.cat /dniv311/run/msg/dniccmsg.cat /dniv311/run/msg/dnpcjmsg.cat /dniv311/run/msg/dnfccmsg.cat /dniv311/run/res/dnfclevt.xml /dniv311/run/res/dnfclmsg.xml /dniv311/run/res/dnfclrsp.xml /dniv311/run/res/dniccidf.xml /dniv311/run/res/dnicomsg.xml /dniv311/run/res/dnicosdf.xml /dniv311/run/res/dnictevt.xml /dniv311/run/res/dnpcjmsg.xml The following modules are removed: /dniv311/admin/appsrv/res/wbifnhome.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 requires the following PTFs: not applicable Roles involved: The activities in this PTF involve the following roles: - Installer (root) - Customizer (ucust1) - DB2 administrator (udb2adm1) - WebSphere MQ administrator (uwmqadm1) - WebSphere MB application developer (uwmbad1) - WebSphere MB administrator (uwmba1) - WebSphere Application Server operator (uwaso1) - WebSphere Application Server administrator (uwasa1) - First WebSphere BI for FN system configuration administrator (sa1) - Second WebSphere BI for FN system configuration administrator (sa2) - First WebSphere BI for FN security configuration administrator (ua1) - Second WebSphere BI for FN security configuration administrator (ua2) 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. - Close MSIF SnF input and output channels. - Release SWIFTNet SnF queues. - Stop the MSIF Message Transfer service. - Stop the Enhanced InterAct service. - Close all dnicli sessions. 2. Stop all WebSphere BI for FN message brokers. 3. Install this PTF using IAW based on the chapter "Installing WebSphere BI for FN" in WebSphere BI for FN for Multiplatforms Planning, Installation, and Customization, SH12-6942. Please be aware of the directory containing the installation data for this PTF has changed compared to the directory documented in this chapter, use the path Disk1/InstData/NoVM instead of Disk1/InstData/VM. 4. Share the files in the /dniv311/admin directory with your customization system. 5. Ensure that the group ownership of the /dniv311/admin directory and all subdirectories and files therein is set to group dniadmin. To do this, enter the following command in AIX shell: chgrp -R dniadmin /dniv311/admin 6. Share the files in the following directories with your runtime systems: /dniv311/run/data /dniv311/run/flows These files are already needed during the preparation phase and do not influence normal operation. 7. Set the group ownership of these directories and files to group dnilpp. To do this, enter the following command in AIX shell: chgrp -R dnilpp /dniv311/run/data chgrp -R dnilpp /dniv311/run/flows D2. Steps on a customization system ----------------------------------- To update your current definition directory and the customized administrative scripts, and to create deployment instructions and vehicles: 1. Log on to AIX on the customization system as a customizer (ucust1). 2. Change to the customization directory: cd 3. Run your customization profile: . ./dnicus_ 4. Start the CDP in migration mode and use the following commands to migrate customization data: dnicdpm -i > export cdd/_UK68439_temp.cdd > supplement cdd/_UK68439_temp.cdd cdd/_UK68439.cdd Open the supplemented CDD and search for each occurrence of the string value="" and specify the appropriate placeholder values. If you have assigned SVB DNFRMA, the new placeholder DNFvRMACONTROOT will appear. You have previously specified this value in the DnfRmaPy.properties file during deployment of resource class CFGPF. Set the placeholder to us this value. > import cdd/_UK68439.cdd > prepare This step updates the customized administrative scripts in the directory '//admin' and generates deployment data for migration of the run-time system for the following resource classes: - DB * new table space DNIUPR, new table DNI_UPREF - DBCNT * new attributes QUERY, RETRY and CLEANUP are added to CT / CO DNI_SYSOP - CFGPF (if SVB DNFRMA OR DNQER are assigned) * instructions and files required to update the WebSphere BI for FN enterprise applications running in the application server Deployment instructions are generated in the file '///instructions.txt'. You will need this later in the 'E. Activating' section. 5. Implement the customization definition data and quit the CDP session: > implement When the message "DNIZ9013I: Current Definition file already exists." is displayed enter 'y' to continue. > quit D3. Generating configuration data migration scripts --------------------------------------------------- To prepare the migration of configuration entities: 1. Restart all WebSphere BI for FN message brokers. 2. On the runtime system on which the message broker runs, log on to AIX as the system configuration administrator, for example, sa1, and run the profile for your runtime environment by entering: . /var/dni_03_01/run/dniprofile 3. Check if you have enabled wildcard escaping for the 'list -ro' command and disable it temporarily. To check if you have configured an escape character enter the following commands: dnicli -s DNI_SYSADM -ou SYSOU > list -ou SYSOU -co DniSecAdm.list -attr DniEscapeCharacter -lo osv If the response is 'No OUs match search criteria.' no escape character is defined. Otherwise note the value displayed and enter the following command in the CLI session to temporarily disable the escape character: > rem -ou SYSOU -ct DniSecAdm.list -co DniSecAdm.list -attr DniEscapeCharacter Commit, approve and deploy the OU SYSOU. Close the CLI session: > .quit 4. Create a temporary directory where dnfczmlc.sh stores the CLI command files which will contain the configuration migration statements. 5. Switch to this directory and enter the following command: dnfczmlc.sh -i [-dual YES|NO] [-to timeout] where: -i The name of the instance. -dual YES|NO Specifies whether files are to be created for a system that uses dual authorization for SYSOU. The default is -dual YES. Specify -dual NO only if dual authorization is to be turned off for both DNI_SYSADM and DNI_SECADM in SYSOU at the time when the created files are executed. Whether dual authorization is switched on or off for other OUs is irrelevant. -to timeout The number of milliseconds that the CLI waits for a response to this command before it issues an error message. The default is 100000 (100 seconds). It must be a whole number between 20000 and 9999999. Note: This command starts a long-running task that might take several minutes to complete. Check the file dnfczmlc.log to ensure that it completed successfully. The program dnfczmlc.sh creates the following CLI command files: If dual authorization is not used (-dual NO): 1. dnfczmlc_2_sa_ent_all.cli 2. dnfczmlc_3_ua_cre_ro_all.cli If dual authorization is used (-dual YES): 1. dnfczmlc_5_sa_cre_ct_com.cli 2. dnfczmlc_5_sa_cre_ct_dep.cli 3. dnfczmlc_6_sa_cre_co_com.cli 4. dnfczmlc_6_sa_cre_co_dep.cli 5. dnfczmlc_8_ua_cre_ro_com.cli 6. dnfczmlc_8_ua_cre_ro_app.cli 6. Enable the escape character for the 'list -ro' command if you have temporarily disabled it in step 2: dnicli -s DNI_SYSADM -ou SYSOU > add -ou SYSOU -co DniSecAdm.list -ct DniSecAdm.list -attr DniEscapeCharacter -val where is the value that was displayed in response to the list command in step 3. This PTF changes the following configuration entities: - adds the pseudo attribute 'QUERYASP' to CT 'DNF_L_ADM' - adds the pseudo attribute 'QUERYASP' to CO 'DNF_L_ADM' in DNFSYSOU - adds the pseudo attribute 'QUERYASP' to role DnfAspAdmin D.4. Manually customize updated BAR files when not using the BAP to deploy them -------------------------------------------------------------------------------- If you use the BAP (dniczbap) to deploy the updated broker archive (BAR) files, the BAR files will be automatically customized during deployment, so you can skip this step. If you do not use the BAP to deploy the updated BAR files, which of the following procedures you must follow depends on whether there is a connection to the configuration manager: - If so, follow the procedure described in D.4.1 - If not,follow the procedure described in D.4.2 Note: Ensure that configuration manager is running and no flows or execution groups are stopped during the deployment of updated BAR files. Otherwise it may happen that old flow levels are not deleted during the BAP update operation (-cmd prepare -update new). To verify that the update was successful you can use the BAP list command. There should be no flows running with the same name but a different version. D.4.1. Customize BAR files without connection to the configuration manager - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Carry out the following steps when there is no connection to the configuration manager, for example, because the configuration manager runs on Windows. The BAP customizes all BAR files that it processed earlier, for example, during installation of WebSphere BI for FN. You then select which files are to be updated for the current PTF. 1. On the runtime system, log on to AIX as the system configuration administrator, for example, sa1, or as the WebSphere MB administrator, for example uwmba1, and run the profile for your runtime environment by entering: . /var/dni_03_01/run/dniprofile 2. Create a temporary directory where dniczbap stores the customized BAR files. You will need up to 35 MB free space in this directory. 3. Issue the following command: dniczbap -cmd prepare -all -dir where represents the directory created in the previous step. Each of the customized BAR files has a name of the form: ...bar where The name of the broker to which the BAR file is to be deployed. The name of the execution group to which the BAR file is to be deployed. The name of the BAR file as provided by WebSphere BI for FN. 4. Identify the BAR files that are listed in section 'B. Summary of changes' and delete all other BAR files in the temporary output directory. 5. Transfer, in binary mode, the customized BAR files to the Toolkit or to the system on which you will issue the mqsideploy command. 6. If you want to deploy using the Toolkit, import the customized BAR files. D.4.2. Customize BAR files with connection to the configuration manager - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Carry out the following steps when there is a connection to the configuration manager. The connection enables the configuration manager to automatically detect updated BAR files. 1. Ensure that the configuration manager is started. 2. On the runtime system on which the configuration manager runs, log on to AIX as the WebSphere MB administrator, for example, uwmba1, and run the profile for your runtime environment by entering: . /var/dni_03_01/run/dniprofile 3. Create a temporary directory where dniczbap stores the customized BAR files. You will need up to 35 MB free space in this directory. 4. Issue the following command: dniczbap -cmd prepare -update new -dir where represents the directory created in the previous step. Each of the customized BAR files has a name of the form: ...bar where The name of the broker to which the BAR file is to be deployed. The name of the execution group to which the BAR file is to be deployed. The name of the BAR file as provided by WebSphere BI for FN. *------------------------------------------------------------------------------* * End of Preparation * *------------------------------------------------------------------------------* E. Activating ------------- E1. Stopping all sessions and services you use ---------------------------------------------- Stop all sessions and services, for example: - Stop all applications that send requests to WebSphere BI for FN. - Log out SIPN FIN LTs. - Close MSIF SnF input and output channels. - Release SWIFTNet SnF queues. - Stop the MSIF Message Transfer service. - Stop the Enhanced InterAct service. - Close all dnicli sessions. For further information, see "Administering and operating components, sessons, and services" in "WebSphere BI for FN for Multiplatforms: System Administration", SH12-6943. E.2. Stopping all application servers ------------------------------------ Stop all application servers. E.3. Stopping all WebSphere BI for FN message brokers ---------------------------------------------------- Stop all WebSphere BI for FN message brokers. E4. Sharing the runtime directory structure ------------------------------------------- 1. Share the files in the /dniv311/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 /dniv311/run E5. Backing up runtime database ------------------------------- Back up the WebSphere BI for FN runtime database: 1. On the system where the DB2 subsystem resides, log on to AIX as a DB2 administrator (udb2adm1). 2. Issue the following command: db2 backup db E6. Following the deployment instructions created in step D2.4 -------------------------------------------------------------- Follow the deployment instructions that were created in step D2.4 with the following exception: - do not execute the instructions provided for resource class CFGPF now; you will use them in step E.11.3. E.7. Additional activities ------------------------- NOT APPLICABLE. E.8. Restarting all WebSphere BI for FN message brokers ------------------------------------------------------ Restart all WebSphere BI for FN message brokers. E9. Redeploy updated BAR files ------------------------------ To customize and deploy the updated WebSphere BI for FN BAR files, you must have the access rights of the WebSphere MB administrator (uwmba1). To redeploy updated BAR files: 1. Ensure that the configuration manager is running. 2. If you already have prepared the customized BAR files as described in step D.5 proceed with step E.9.1; otherwise, proceed with step E.9.2. Note: Ensure that configuration manager is running and no flows or execution groups are stopped during the deployment of updated BAR files. Otherwise it may happen that old flow levels are not deleted during the BAP update operation (-cmd prepare -update new). To verify that the update was successful you can use the BAP list command. There should be no flows running with the same name but a different version. E9.1. Deploying the BAR files customized in step D4 - - - - - - - - - - - - - - - - - - - - - - - - - - Use the Toolkit or the mqsideploy command to deploy the BAR files. Remove the old versions of the flows which have been updated by this PTF as otherwise two different versions of the flows are running. You can list the flows running in the broker to identify the names including their version suffix. You can also refer to the Planning, Installation, and Customization manual for a list of flows contained in each BAR file. E9.2. Updating BAR files when step D4 has not been performed - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Use these steps when your configuration manager runs on AIX and you want to deploy directly using the BAP (dniczbap). To customize and deploy the BAR files: 1. On the runtime system on which the configuration manager runs, log on to AIX as the WebSphere MB administrator, for example, uwmba1, and run the profile for your runtime environment by entering: . /var/dni_03_01/run/dniprofile 2. Ensure that you have sufficient free space in the current directory. To deploy all message flows requires about 35 MB of free space. 3. Issue the following command: dniczbap -cmd prepare -update new -deploy E.9.3. Activating WebSphere BI for FN accounting - - - - - - - - - - - - - - - - - - - - - - - - - NOT APPLICABLE. E.10. Migrating configuration data --------------------------------- 1. On the runtime system, log on to AIX as the indicated user and run the profile for your runtime environment by entering: . /var/dni_03_01/run/dniprofile 2. Switch to the temporary directory you created in step D3.3. Execute the CLI command files generated in step D4 in the following sequence and using the following user authorization: If dual authorization was not used (-dual NO): - dnfczmlc_2_sa_ent_all.cli by any sa - dnfczmlc_3_ua_cre_ro_all.cli by any ua If dual authorization was on (-dual YES): - dnfczmlc_5_sa_cre_ct_com.cli by the first sa (sa1) - dnfczmlc_5_sa_cre_ct_dep.cli by the second sa (sa2) - dnfczmlc_6_sa_cre_co_com.cli by the first sa (sa1) - dnfczmlc_6_sa_cre_co_dep.cli by the second sa (sa2) - dnfczmlc_8_ua_cre_ro_com.cli by the first ua (ua1) - dnfczmlc_8_ua_cre_ro_app.cli by the second ua (ua2) Enter the following command: dnicli -s -ou SYSOU -cft | tee -a UK68439.cli.log where: DNI_SYSADM for files executed by the system configuration administrators, abbreviated as sa DNI_SECADM for files executed by the security administrators, abbreviated as ua The CLI command file name, for example dnfczmlc_5_sa_cre_ct_com.cli. 3. If applicable, execute the cli-commands generated in D3.6. E.11. Updating the WebSphere BI for FN enterprise application ------------------------------------------------------------ E.11.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) 1. Stop WebSphere Application Server 2. Issue the following command for each profile that is to be backed up: /bin/manageprofiles.sh -backupProfile -profileName -backupFile where represents the installation directory of the application server represents the file name under which the backup should be stored, be aware you need to give absolutely path for E.11.2. Update the WebSphere Application Server environment - - - - - - - - - - - - - - - - - - - - - - - - - - - - - NOT APPLICABLE E.11.3. Migrating the enterprise application - - - - - - - - - - - - - - - - - - - - - - If the instructions created in step D2.4 contain the resource class CFGPF, follow this section now to update the enterprise applications. E12. Restarting all sessions and services ----------------------------------------- 1. 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 service. - Acquire SWIFTNet SnF queues. - Start the applications that send requests to WebSphere BI for FN. For further information, see "Administering and operating components, sessions, and services" in "WebSphere BI for FN for Multiplatforms: System Administration", SH12-6943. 2. A subscription to receive FileAct events is needed for each SAG that the MSIF Transfer Service uses to conduct file transfers. Because one of the previous steps erased all subscriptions from the WebSphere BI for FN database, for each SAG that the MSIF Transfer Service is to use to conduct file transfers, resubscribe manually by issuing the "subscribe" command. E13. Updating the Toolkit development environment ------------------------------------------------- NOT APPLICABLE. *------------------------------------------------------------------------------* * End of Activating * *------------------------------------------------------------------------------* F. APAR details --------------- Fixes for the following APARs are contained in this PTF: PM40373 Base This is the summary APAR for the PTF to update WebSphere BI for FN 3.1.1. PM42534 Base USE THE @ TO MARK A GROUP WITH ACCESS AUTHORITY IN CDD Formerly, when customer tried to use the special character @ for RACF group names within the CDD, DNICDP tool did not allow the replacement of place holders with such names. Now, the DNICDP has been enhanced to allow additional special characters @, #, and $. PM40515 Base INTERNAL ERROR EVENT DNFL2000E DOES NOT CONTAIN DETAILED INFORMATION FOR THE USER AND WILL BE REPLACED BY DNFL2155E Formerly, if an RMA query without request reference was received, DNFL2000E was displayed indicating an internal error. Now, if an RMA query without request reference is received, the message DNFL2155E will be displayed indicating an invalid RMA message. PM40386 Base ASP IMPORT LASTS MORE THAN AN HOUR Formerly, importing the ASP package from SWIFT took a long time. Now, the performance has been improved. PM40580 Base WBI 311 MIGRATION - UNNECESSARY DELETE AND DEFINE OF QUEUES Formerly, during in-place migration the MQ deployment data contained for several queues a delete statement followed by a define statement for the same queue. Now, the useless delete/define statements are prevented. The MQ deployment data now contain only statement for new, deleted or modified queues. PM42010 Base DSNT408I SQLCODE = -206 DURING INSTALLATION OF WBI-FN 3.11 Formerly, when the substitution of placeholder DNIvSN with customer's current schema during customisation was done error DSNT408I SQLCODE = -206 occured. The schema name used by customer is 7 chars long, and this made a WHERE clause within the SQL statements exceeded into column 73. SPUFI truncated the line at column 72, thus RL.RMRL_ID was not a defined database column in the following statements. Now, the installation ddl dnfczlco.ddl has been adjusted to make sure, that all SQL statements still fit even if the placeholders are substituted with value of 8 char in length. Fixes for the following WebSphere BI for FN V3.1.0 APARs are now added to WebSphere BI for FN V3.1.1: PM38226 Base RMA IMPORT ENCOUNTERS MAXLENGTH ERROR. Formerly, when checking routine to ensure consistency of a distribution file checked for maxlength of the CertPolicyId, while there is no max length restriction defined by SWIFT, the RM Import issued event DNFL9558E "RM import file is invalid" when the distribution file contains an authorisation signed using a lite certificate. Now, the checking routine has been corrected. G. Other changes ---------------- The following problems have been addressed: - RMA: * Fix that issued time was not identical in query properties view and query history view. * There have been display problems in the permission view when using Microsoft Internet Explorer. * DB2 timeouts could occur when many users did work with queries and answers. * ResponderDNs in RMA messages not following SWIFTs naming convention are now tolerated. Only the BIC8 on the level 2 node of the DN is now extracted, other levels are ignored. - RM Import: * Fixed wrong log entries in trial mode (file mode complete). * When importing authorisations within a BOU in complete and trial mode, the event DNFL9499I was not written. - When installing the resources of SVB DNIWAS in the application server using the wsadmin script DniWasInst.py it was not possible to use the cell scope. ++++ End +++ End +++ End +++ End +++ End +++ End +++ End +++ End +++ End ++++