============================================================================== ============================================================================== Licensed materials - Property of IBM 5724-D96 (C) Copyright IBM Corp. 2002, 2014 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 UI15322 for APAR PI07294 Driver level: 4124 Date 2014-03-31 ============================================================================== ============================================================================== 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. During the installation phase of this PTF 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 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: PI07294 BASE CHANGE AO FACILITY TO USE RES-AUTH CONTAINER AND SPECIFY ALL REQUIRED RESOURCES IN THE WEB.XML PI09481 BASE DOUBLE BYTE WORDS IN COMMENT WILL FAIL WHEN MWH AND MSG AUDIT ARE ENABLED PI10478 BASE RM IMPORT IS FAILED WITH RM EXPORT 0 RECORD OUTPUT PI10441 BASE DNICDP REFERENCES A DEPLOYMENT DATASET THOUGH NO DEPLOYMENT DATA IS CREATED PI10694 BASE WBIFN SAG ADDON UPDATEMESSAGEPARTNER COMMAND 'UMP' RESULTED IN ERROR EVENT DNFG2017E SPECIFIED NAME 'MQHA' IS INCORRECT PM87628 BASE USE PTHREAD_TESTINTR() AFTER MQGET CALLS TO AVOID SECOND DUMP WHEN EG IS DUMPING Additional functional changes: - SWIFTNet System Messages adapted to SWIFT VL/222013 - Support of Microsoft Internet Explorer 10 added in RMA and AO Facility Documentation updates: The following manuals have been changed: - Planning, Installation, and Customization - Concepts and Components - Messages and Codes - System Administration - Application Programming The following modules have been changed: /dniv311/admin/appsrv/dnidatasource.py /dniv311/admin/appsrv/res/dnf.rma.web.ear /dniv311/admin/appsrv/res/dni.home.ear /dniv311/admin/appsrv/res/dnp.ado.web.ear /dniv311/admin/bin/dniccclt.jar /dniv311/admin/bin/dnicdp.jar /dniv311/admin/data/DNFCOMMON.xml /dniv311/admin/data/DNFRMA.xml /dniv311/admin/data/DNFRMR.xml /dniv311/admin/data/DNFVERIF.xml /dniv311/admin/data/DNICOMMON.xml /dniv311/admin/data/DNIOU.xml /dniv311/admin/data/DNIWAS.xml /dniv311/admin/data/DNIWEBHOME.xml /dniv311/admin/data/DNPAO.xml /dniv311/admin/data/DnfRma.py /dniv311/admin/data/DnfRma_upd.py /dniv311/admin/data/DniWebHome.py /dniv311/admin/data/DniWebHomePy.properties /dniv311/admin/data/DniWebHome_upd.py /dniv311/admin/data/DnpAo.py /dniv311/admin/data/DnpAoPy.properties /dniv311/admin/data/DnpAo_upd.py /dniv311/admin/data/dni.properties /dniv311/admin/data/dni.xml /dniv311/admin/data/dnicdcig.ddl /dniv311/admin/data/dniczdlq.mq /dniv311/admin/data/dniczpu1.txt /dniv311/admin/data/dniczrlq.mq /dniv311/admin/data/dnfxzlco.def /dniv311/admin/data/dnfxzlro.def /dniv311/admin/data/dnfxzlcs.def /dniv311/admin/data/dnfxzvco.def /dniv311/admin/data/dnfxzvro.def /dniv311/admin/data/dnfxzlrs.def /dniv311/admin/data/dnfxzscs.def /dniv311/admin/data/dnfxzsrs.def /dniv311/admin/data/dnixzr01.def /dniv311/admin/data/dnixzr02.def /dniv311/admin/data/dnixzs01.def /dniv311/admin/data/dnixzs02.def /dniv311/admin/data/dnixzwcs.def /dniv311/admin/data/dnixzwrs.def /dniv311/admin/data/dnpczocg.ddl /dniv311/admin/samples/dniczcus.prf /dniv311/admin/toolkit/com.ibm.dni.api.jar /dniv311/run/classes/dnfcddbm.jar /dniv311/run/classes/dnicbmig.jar /dniv311/run/classes/dnicddbm.jar /dniv311/run/classes/dnicvcks.jar /dniv311/run/classes/dnicvcks_ssys70.jar /dniv311/run/classes/dnicvrls_ssys70.jar /dniv311/run/classes/dniczbap.jar /dniv311/run/classes/dnp.jab.jar /dniv311/run/classes/dnp.util.model.jar /dniv311/run/classes/dnprdu.jar /dniv311/run/flows/DNF_BACKOUT.bar /dniv311/run/flows/DNF_RM.bar /dniv311/run/flows/DNF_SAGCFG.bar /dniv311/run/flows/DNI_R_AUDIT.bar /dniv311/run/flows/DNI_R_MWH.bar /dniv311/run/lib/libdnic.a /dniv311/run/lib/libdnic64.a /dniv311/run/lib/libdnicq.a /dniv311/run/lib/libdnicq64.a /dniv311/run/lil/dnfrmimi.lil /dniv311/run/lil/dnicin.lil /dniv311/run/lil/dnignde.lil /dniv311/run/lil64/dnfrmimi64.lil /dniv311/run/lil64/dnicin64.lil /dniv311/run/lil64/dnignde64.lil /dniv311/run/msg/DNIY_Msg.properties /dniv311/run/msg/dnicymsg.cat /dniv311/run/res/dnfclsdf.xml /dniv311/run/res/dnicymsg.xml /dniv311/run/samples/DniEventReader.jar /dniv311/run/samples/dniccdpt.jar /dniv311/run/samples/dniczpro.prf /dniv311/run/samples/dnixzbrk.sh The following modules are new: /dniv311/admin/data/dnfxzl0o.def /dniv311/admin/data/dnfxzl0s.def /dniv311/admin/data/dnfxzs0s.def /dniv311/admin/data/dnfxzv0o.def /dniv311/admin/data/dnicdiic.ddl /dniv311/admin/data/dnicdm8g.ddl /dniv311/admin/data/dniczm11.mq /dniv311/admin/data/dniczpe0.txt /dniv311/admin/data/dnixzm10.def /dniv311/admin/data/dnixzm11.def /dniv311/admin/data/dnixzw0s.def /dniv311/admin/data/dnpczo1g.ddl /dniv311/run/flows/DNP_CMDDSP.bar /dniv311/run/msg/DNPD_Msg.properties /dniv311/run/msg/dnpcdmsg.cat /dniv311/run/res/dnpcdmsg.xml C. Planning ----------- C1. Checks to be done >>BEFORE<< installing a new PTF ----------------------------------------------------- 1. Ensure that all previously prepared deployment instructions were carried out. 2. 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. 3. Until the migration for this PTF has been completely finished, ensure that no changes are made to the currently implemented CDD. 4. 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'. 5. 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 commands should result in 'No roles/role groups/users found that match specified criteria'. C2. Prerequisite and supersede information ------------------------------------------ This PTF requires the following PTFs: - UI12328 for APAR PM98191 (Base 3.1.1.16, AO FACILITY: ADD MESSAGE PRINTING SUPPORT) If you are using the Message Management feature of WebSphere BI for FN this PTF must be installed together with: - UI15324 for APAR PI07560 (MM 3.1.1.13, PERFORM OU DETERMINATION WHEN A DNIUNPARSABLE MESSAGE IS INSERTED INTO MER) Please verify that you have installed one of the following products: - IBM Runtime Environment, Java Technology Edition 6.0 - IBM Runtime Environment, Java Technology Edition 6.0.1 C3. 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) D. Installation --------------- D1. 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. - Close all dnicli sessions. For further information, see "Administering and operating components, sessions, and services" in WebSphere BI for FN for Multiplatforms: System Administration. D2. Stopping all application servers ------------------------------------ Stop all application servers. D3. Stopping all WebSphere BI for FN message brokers ---------------------------------------------------- Stop all WebSphere BI for FN message brokers. D4. Backing up your system -------------------------- We recommend to backup your AIX LPAR so that in case of migration issues you can revert to your previous system setup and continue to process workload. D5. Installing PTF by InstallAnywhere ------------------------------------- 1. 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. Please be aware of the following: 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. 2. Ensure that the group ownership of the /dniv311/admin directory and all of its subdirectories and files, is set to group dniadmin. To do this, enter the following command in AIX: chgrp -R dniadmin /dniv311/admin 3. Set the group ownership of the runtime directories and its files to group dnilpp. To do this, enter the following command in AIX: chgrp -R dnilpp /dniv311/run D6. 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. Verify your customization profile: Ensure that the setting of the DNI_JAVA environment variable is set to the Java 6 64-bit home directory, for example: DNI_JAVA=/usr/java6_64 4. Run your customization profile: . ./dnicus_ 5. Start the CDP in migration mode and use the following commands to migrate customization data: dnicdpm -i > export cdd/_UI15322_temp.cdd > supplement cdd/_UI15322_temp.cdd cdd/_UI15322.cdd Edit the supplemented CDD. Search for each occurrence of the new placeholder DNIvLOGINCASE. Make sure that the value of the placeholder is empty. After you have successfully completed the installation and migration process for this PTF you can do customization for the new placeholder. > import cdd/_UI15322.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: - DBGNT * Added: GRANT SELECT ON DNIvSN.DNP_AOLS TO DNIvUGRP * Added: GRANT SELECT ON DNIvSN.DNI_ROLE_RESOLVED TO DNIvUGRP * Added: GRANT CONNECT ON DATABASE TO GROUP DNIvUGRP - MQ * create new local queue DNIvQPFX.DNP_CMDDSP * create new alias queue DNIvINST.SYSOU.DNP_CMDDSP - MQAUT * update permission on queues DNIvQPFX.DNP_* for group DNIvSGRP * update permission on new queue DNIvINST.SYSOU.DNP_CMDDSP for group DNIvYGRP * update permission on queue DNIvINST.DNIvOU.DNI_SECADM for group DNIvSGRP * update permission on queue DNIvINST.DNIvOU.DNI_SYSADM for group DNIvSGRP * update permission on queue DNIvINST.DNIvOU.DNI_A_EVENT for group DNIvSGRP * update permission on queue DNIvINST.SYSOU.DNI_MONITOR for group DNIvSGRP * update permission on queue DNIvINST.SYSOU.DNI_ACCADM for group DNIvSGRP * update permission on queue DNIvINST.SYSOU.DNI_SYSOP for group DNIvSGRP * update permission on queue DNIvINST.SYSOU.DNP_F_FH for group DNIvSGRP * update permission on queue DNIvINST.DNFSYSOU.DNFSAGOP for group DNIvSGRP * update permission on queue DNIvINST.DNFSYSOU.DNFSAGCFG for group DNIvSGRP * update permission on queue DNIvINST.DNFSYSOU.DNF_L_ADM for group DNIvSGRP * update permission on queue DNIvINST.DNIvOU.DNF_L_ADM for group DNIvSGRP * update permission on queue DNIvINST.DNIvOU.DNF_V_ADM for group DNIvSGRP * update permission on queue DNIvQPFX.DNI_WEB_RESP for group DNIvSGRP - MBRK * create new message flow DNP_CMDDSP - CFGPF (if SVB DNPAO or DNFRMA is assigned) * create 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 D7. 6. 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 D7. Following the deployment instructions created in step D6 ------------------------------------------------------------ Follow the deployment instructions that were created in step D6 with the following exceptions: - do not execute the instructions provided for resource class CFGPF now; you will use them in step D13.4. - do not execute the instructions provided for resource class MBRK now; you will use them in step D11.1. D8. Additional activities ------------------------- D8.1. DB2 related activities - - - - - - - - - - - - - - - NOT APPLICABLE. D8.2. WebSphere MB related activities - - - - - - - - - - - - - - - - - - - NOT APPLICABLE. D8.3. WebSphere MQ related activities - - - - - - - - - - - - - - - - - - - NOT APPLICABLE. D8.4. Update your current dniprofile - - - - - - - - - - - - - - - - - - - If you have already migrated to WebSphere MB V7 or V8, you can skip this section. The following changes were made in the delivered sample profile dniczpro.prf: a. Java environment variable DNI_JAVA_PATH adapted to Java 6 64-bit, for example: export DNI_JAVA_PATH=/usr/java6_64 To make the changes effective, you must upgrade your current dniprofile: 1. Backup your dniprofile. 2. Obtain a copy of the revised dniprofile according to section "Preparing a user profile for a runtime system on which a broker runs" in the Planning, Installation, and Customization Guide and set the environment variables as described. You can download the latest version of the WebSphere BI for FN product documentation from: http://www.ibm.com/software/integration/wbifn/library D9. Restarting all WebSphere BI for FN message brokers ------------------------------------------------------ Restart all WebSphere BI for FN message brokers. D10. Customize BAR files when using mqsideploy or the Toolkit to deploy them ---------------------------------------------------------------------------- D10.1. Backup the BTD repository - - - - - - - - - - - - - - - - 1. On the runtime system on which you use the BAP, 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. Create a backup of your BTD repository. The location of this directory depends on the version of WebSphere Message Broker you are using: - for V6.1: $DNI_BAP_PATH/bap/$DNI_QMGR_CFG - for V7 or V8: $DNI_BAP_PATH/bap/$DNI_I where the values of the environment variables DNI_BAP_PATH, DNI_QMGR_CFG and DNI_I correspond to the settings made in your dniprofile. For example, to create a backup of a Broker V7 or Broker V8 BTD repository by copying the corresponding directory, enter the following commands: mkdir -p $DNI_BAP_PATH/bap/UI15322/$DNI_I cp -R $DNI_BAP_PATH/bap/$DNI_I/ $DNI_BAP_PATH/bap/UI15322/$DNI_I D10.2. Customize BAR files - - - - - - - - - - - - - - Perform this step only if you use mqsideploy or the Toolkit to deploy broker archive (BAR) files manually. If you use the BAP (dniczbap) to automatically deploy the BAR files, skip this step and later deploy the BAR files directly as described in step D11.2.2. If you are unsure which method to use, use the same method that you used when you initially created your instance as described in WebSphere BI for FN: Planning, Installation, and Customization. To customize the BAR files for manual deployment: 1. On the runtime system on which you use the BAP, 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. Create a temporary directory to which you have read and write access and that has at least 35MB of free space. This is the directory in which dniczbap will store the customized BAR files. 3. The component to which the BAP deploys message flows depends on which version of WebSphere Message Broker is used: - For V6.1, the BAP deploys message flows to the configuration manager. - For V7 or V8, the BAP deploys message flows to the broker. Sometimes, the BAP cannot connect directly to this component, for example, when you use Broker V6.1 and the configuration manager is located on Windows. How you customize the BAR files depends on whether the BAP can connect to this component: a. If a connection is not possible, issue the following command to customize all BAR files: dniczbap -cmd prepare -all -dir where represents the output directory created in step 2. b. If a connection is possible, ensure that the configuration manager (if using Broker V6.1) and the brokers are running, and that no flows or execution groups are stopped. Issue the following command to cause the BAP to identify the BAR files that are to be updated: dniczbap -cmd prepare -update new -dir where represents the output directory created in step 2. Regardless of which method (a or b) you use, each of the customized BAR files in the output directory has a name of the form: ....bar where The name of your instance. 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. If you performed step 3.a, identify the BAR files that are listed in section "B. Summary of changes" and delete all other BAR files from the output directory. 5. Transfer, in binary mode, the customized BAR files in the output directory to the Toolkit or to the system on which you will later issue the mqsideploy command. 6. If you will use the Toolkit to deploy the message flows, import the customized BAR files. D11. Redeploy updated BAR files ------------------------------- Deploying the WebSphere BI for FN BAR files that are delivered in this PTF updates the message flows that run in the broker. For a list of flows contained in each BAR file, refer to "Planning execution groups" section in WebSphere BI for FN Planning, Installation, and Customization. Each WebSphere BI for FN message flow has a suffix that represents its version. For example, the flow DNI_SYSADM_1141 has the version 1141. The version of a flow corresponds to the number of the PTF that most recently updated it. Refer to the header of this readme to determine the PTF number of this PTF. To deploy BAR files, you must have the access rights of the WebSphere MB administrator (uwmba1). D11.1 Deploy new message flows - - - - - - - - - - - - - - - Follow the deployment instructions for resource class MBRK that were created in step D6. D11.2. Update existing message flows - - - - - - - - - - - - - - - - - - If you already prepared the customized BAR files as described in step D10, proceed with step D11.2.1; otherwise, proceed with step D11.2.2. D11.2.1 Deploying the BAR files customized in step D10 - - - - - - - - - - - - - - - - - - - - - - - - - - - - Note: If you have configured multiple broker servers you must deploy the BAR files to each broker server. Use the Toolkit or the mqsideploy command to manually deploy the BAR files. Remove the old versions of the message flows that have been updated by the BAR files you deployed. If you neglect to do this, two different versions of the flows will run simultaneously with unpredictable results. D11.2.2 Deploying BAR files when step D10 was not performed - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Note: If you are using Broker V7 or V8 and you have configured multiple broker servers you must perform the following steps on each broker server. Use the BAP (dniczbap) to customize and automatically deploy the BAR files: 1. Ensure that: - The configuration manager is running (applies only for Broker V6.1) - The brokers are running - No flows or execution groups are stopped. Otherwise, old flow levels might not be deleted during the BAP update operation. 2. On the runtime system where you use the BAP, 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. Ensure that you have at least 35 MB of free space in the current directory. 4. Issue the following command: dniczbap -cmd prepare -update new -deploy -broker The parameter -broker is only required if you use multiple broker servers. 5. Issue the following command to verify that all previous versions of the updated message flows were removed successfully: dniczbap -cmd check The result should be: DNIZ1314I: No problems detected. If you receive the message DNIZ1313E, follow the instructions provided in the user response to correct the problem. D11.3. Activating WebSphere BI for FN accounting - - - - - - - - - - - - - - - - - - - - - - - - NOT APPLICABLE. D12. Migrating configuration data --------------------------------- NOT APPLICABLE. D13. Updating the WebSphere BI for FN enterprise application ------------------------------------------------------------ D13.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: On Windows: \bin\manageprofiles.bat -backupProfile -profileName -backupFile On other platforms: /bin/manageprofiles.sh -backupProfile -profileName -backupFile where represents the installation directory of the application server and represents the file name under which the backup should be stored. D13.2. Update the WebSphere Application Server environment - - - - - - - - - - - - - - - - - - - - - - - - - - - - - NOT APPLICABLE. D13.3. Restarting all application servers - - - - - - - - - - - - - - - - - - - - - Before starting to update the enterprise applications, start the application server on which the enterprise application runs. If you use a clustered application server environment, start the deployment manager, node agent, and all members of the application server cluster. D13.4. Migrating the enterprise application - - - - - - - - - - - - - - - - - - - - - - If the instructions created in step D6 contain the resource class CFGPF, follow this section now to update the enterprise applications. Note: A new web application may contain changed JavaScript and HTML files. To assure that the user works with the most current web application content it is recommended to clear the browser cache on each client workstation before the user logs in the next time. It is not sufficient to just reload the page. Please find the following sample description for the different browser types as reference for the user communication: Firefox 10.0.6 ESR and later From the menu bar select Tools -> Options. In the options dialog select the Advanced section. In the Advanced section select the Network notebook tab. Click on the "Clear Now" button to clear the browser cache. Internet Explorer 8 or later From the menu bar select Tools -> "Internet Options". On the General notebook page click the "Delete..." button in section "Browsing History". In the "Delete Browsing History" dialog check at least "Temporary Internet files" and click the Delete button to clear the browser cache. D14. Restarting all sessions and services ----------------------------------------- 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. - Subscribe MSIF to SAGs to enable file transfer and session monitoring. - Start the MSIF Message Transfer service. - Acquire SWIFTNet SnF queues. - Open MSIF SnF input and output channels. - 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. D15. Updating the Toolkit development environment ------------------------------------------------- You must update your Toolkit environment if you use at least one of the following components: - WebSphere BI for FN sample message flows as foundation for your own flow development - WebSphere BI for FN nodes in your own message flows - WebSphere BI for FN message set projects containing XML schema definitions, that, for example, are utilized by the XPath wizard Furthermore, you have to rebuild and redeploy your message flows if they are based on the WebSphere BI for FN API. The following resources are changed by this PTF: - WebSphere BI for FN nodes: DniMwhUpdate DniMwhInsert DniMessageAudit - WebSphere BI for FN message sets: none - WebSphere BI for FN message set projects: none To install the new versions of the Toolkit resources, follow the instructions of the listed sections provided in "Preparing the WebSphere Message Broker Toolkit workstation" in WebSphere BI for FN for Multiplatforms: Application Programming: - Transferring the WebSphere BI for FN resources - Installing the WebSphere BI for FN Eclipse plug-ins If you use WebSphere BI for FN sample message flows as foundation for your own flow development follow the instructions provided in "Using the sample routing flows" in WebSphere BI for FN for Multiplatforms: Application Programming. Otherwise, continue with the instructions provided in "Preparing the WebSphere Message Broker Toolkit workstation" in WebSphere BI for FN for Multiplatforms: Application Programming: - Importing WebSphere BI for FN Base sample projects - Importing the message sets and sample routing flows Additionally, if you use WebSphere BI for FN message set projects containing XML schema definitions for your own flow development follow the instructions provided in section "Preparing the WebSphere Message Broker Toolkit workstation" in WebSphere BI for FN for Multiplatforms: Application Programming: - Importing the message sets and sample routing flows - Importing XSD files for SWIFT message payloads D16. Verifying your Installation -------------------------------- This PTF contains updated versions of the RMA or AO Facility enterprise applications. To verify that an enterprise application is the most current version: 1. Log-on to the enterprise application. 2. Click the 'About' link in the upper right corner. A dialog box opens. 3. In the dialog box, locate the build number. Compare it to the driver level specified in the header of this readme file. Both numbers should be identical. *------------------------------------------------------------------------------* * End of Installation * *------------------------------------------------------------------------------* E. APAR details --------------- Fixes for the following APARs are contained in this PTF: PI07294 BASE CHANGE AO FACILITY TO USE RES-AUTH CONTAINER AND SPECIFY ALL REQUIRED RESOURCES IN THE WEB.XML Formerly, WAS security in WebSphere BI for FN web applications was set to res-auth application for all data sources. In addition, not all required MQ resources had been specified in the web.xml file. This resulted in the server UserID being used for to access the WebSphere BI for FN runtime database and all MQ queues, which are not specified in the web.xml. Now, res-auth container is used for all data sources and all required MQ resources are specified in the web.xml file. PI09481 BASE DOUBLE BYTE WORDS IN COMMENT WILL FAIL WHEN MWH AND MSG AUDIT ARE ENABLED Formerly, a message containing nonconvertible characters (for example, Chinese characters), could not be stored in the message warehouse or the message audit log. Now, a message containing nonconvertible characters can be stored in the message warehouse or the message audit log. Nonconvertible characters are replaced with a question mark (?). PI10478 Base RM IMPORT FAILED WITH RM EXPORT 0 RECORD OUTPUT Formerly, when an RM distribution file with zero records was imported with RM administration service DNF_L_ADM (e.g. to remove the RM authorisations of a specific own BIC), error response DNFL9554E "Error during RM import processing; the data in the specified import file is incorrect." was returned and the import was unsuccessful. Now, RM distribution files with zero records can be successfully imported. PI10441 BASE DNICDP REFERENCES A DEPLOYMENT DATASET THOUGH NO DEPLOYMENT DATA IS CREATED Formerly, when a recustomization was done that changed only category 2 placeholders in the cdd, no deployment data was generated. However, the response of dnicdp referenced a (non-existing) deployment dataset. Now, the response of dnicdp no longer references a (non-existing) deployment dataset. In addition, the instructions for changes of category 2 placeholders have been improved. PM87628 BASE USE PTHREAD_TESTINTR() AFTER MQGET CALLS TO AVOID SECOND DUMP WHEN EG IS DUMPING Formerly, when a broker execution group is dumping due to any reason, a second dump may be initiated due to the fact, that WebSphere BI for FN did not react on the abend signal and keeps the thread running. Now, WebSphere BI for FN reacts on the abend signal and allows threads to be canceled, when a broker execution group is dumping. PI10694 BASE WBIFN SAG ADDON UPDATEMESSAGEPARTNER COMMAND 'UMP' RESULTED IN ERROR EVENT DNFG2017E SPECIFIED NAME 'MQHA' IS INCORRECT Formerly, when issuing an updateMessagePartner (ump) command to the SAG configuration service DNF_SAGCFG, depending on the order of configuration data received from the database tables, it was possible to get an error response DNFG2027E indicating that the MQHA name is incorrect, even if it was configured correctly. The ump command was not performed successfully. Now, the configuration data check has been changed to prevent false error responses. The ump command is performed successfully. F. Other changes ---------------- - Message updates: * Event messages changed: * Event messages new: DNIY0121E * Response messages changed: * Response messages new: DNPD1001E, DNPD1002E, DNPD1003E - Support of Microsoft Internet Explorer 10 added in RMA and AO Facility - SWIFTNet System Messages adapted to SWIFT VL/222013 - The customization program (dnicdp) and the BAP (dniczbap) require IBM 64-Bit SDK for AIX Java 2 Technology Edition Version 6.0 or 6.0.1. - RM import Formerly under Broker V8 FP3, RM import command sometimes abended if -lfd parameter was used. This has been corrected. - Algorithms for the generation of pseudo random numbers upgraded to improve performance on high performance or virtualized systems. - When using the AO Facility Logical Terminals component you might have observed database permission errors depending on the user ID you have used in the datasource authentication alias. Now the corresponding group for the placeholder DNIvUGRP has been granted the required permission. - Queryasp command modified See queryasp command in WebSphere BI for FN for Multiplatforms System Administration, Chapter 46. RM commands. - New module /dniv311/admin/data/dnicdiic.ddl This module is provided for IBM Support purposes only. Only use it when requested by IBM Support to check the initially loaded Configuration Data. - Changes in WebSphere BI for FN Base required to adapt Message Management APAR UI15324 "Avoid invalid XML due to unsupported hex values in input message" G. Known issues --------------- - WebSphere BI for FN customers using MSIF and AO Facility will get an access error after installation of this PTF for APAR PI07294 on below noted queue. To circumvent this error, set the following queue authority manually: setmqaut -m DNIvMQMN -n DNIvINST.DNIvOU.DNF_O_CMD -t queue -g DNIvSGRP +put +inq setmqaut -m DNIvMQMN -n DNIvINST.DNFSYSOU.DNF_O_CMD -t queue -g DNIvSGRP +put +inq ++++ End +++ End +++ End +++ End +++ End +++ End +++ End +++ End +++ End ++++