=====================================================================================
IBM® WebSphere® Business Integration (BI) Monitor™ v4.2.4 Fix Pack3 - Patch3 Readme File
=====================================================================================

© Copyright International Business Machines Corporation. 2002, 2004. All rights reserved. 

This file contains the new updates and fixed bugs in the IBM WebSphere BI Monitor v4.2.4 Fix Pack3 - Patch3. Refer to the file named install_fix_pack3_patch3.html for the information and steps required for installing IBM WebSphere BI Monitor v4.2.4 Fix Pack3 - Patch3.

New Updates in Fix Pack3 - Patch3

The BI Monitor v4.2.4 Fix Pack3 - Patch3 provides the following new updates:

BI Monitor v4.2.4 Fix Pack3 Patch3 Supports now using Automatic installation on an already federated WAS servers in Network Deployment environment. The automatic installation wizard has been updated to contain the following changes:

• A new installation step has been added to ask the user to select the WebSphere Application Server type on which the Monitor will be deployed. The user can select either the IBM WebSphere Application Server or the IBM WebSphere Deployment Manager for Network Deployment. Based on the user selection the wizard will continue as the following:

  • If the user selects IBM WebSphere Application Server, then a wizard screen will appear to ask him/her to select the WebSphere Application Server version (WAS 4 or WAS 5), and to specify the installation directory on which the WebSphere Application Server is installed.
  • If the user selects IBM WebSphere Deployment Manager for Network Deployment then a new wizard screen will appear to ask him/her to enter the following required information about the WebSphere Deployment Manager:
    • SOAP Connector Port: The SOAP connector port number of the Deployment Manager server. You can get this port number from the WebSphere Deployment Manager administrative console by selecting System Administration>>Deployment Manager>>End Points >> SOAP_CONNECTOR_ADDRESS. The default value is 8889.
    • Node Name: The node name on which the Application Server that will be used for deploying the Monitor exists.
    • Application Server Name: The Application Server name on which the Monitor will be deployed. If this application server does not exist on the specified node then it will be created.
    • Installation Directory Name: The installation directory of the WebSphere Deployment Manager for Network Deployment.

  When you are deploying the Monitor using the Deployment Manager to a node that exist in a remote machine other that the Deployment Manager machine, then the following fields must be entered with the values of the remote node environment:

  • Database JDBC driver

  • Monitor database name/Alias

  • Monitor database User Name and Password

  • IBM MQSeries Workflow library path and file name

  • MQ Workflow database name/Alias

  • MQ Workflow database User Name and Password

  In this case you must disable the wizard to check/validate the existence of the above items. This is done by editing the runwizard.sh or the runwizard.bat by which you run the installation wizard and adding the following switch -Dmonitor.wizard.validators=false to the Run command as follows:

  In the runwizard.bat:

  %WAS_HOME%\java\bin\java "%CLIENTSAS%" -Dmonitor.wizard.validators=false "-Dwas.install.root=%WAS_HOME%" "-Dwas.repository.root=%CONFIG_ROOT%" -Dcom.ibm.CORBA.BootstrapHost=%COMPUTERNAME% -cp %WAS_HOME%\classes;%WAS_HOME%\lib\xerces.jar;%WAS_HOME%\lib\j2ee.jar;%WAS_HOME%\lib\admin.jar;%WAS_HOME%\lib\wsexception.jar;%WAS_HOME%\lib\wasjmx.jar;WBIMonitor424-FixPack3.jar run

  In the runwizard.sh:

  ${WAS_HOME}/java/bin/java "${CLIENTSAS}" -Dmonitor.wizard.validators=false "-Dwas.install.root=${WAS_HOME}" "-Dwas.repository.root=${CONFIG_ROOT}" -Dcom.ibm.CORBA.BootstrapHost=${COMPUTERNAME} -cp ${WAS_HOME}/classes:${WAS_HOME}/lib/xerces.jar:${WAS_HOME}/lib/j2ee.jar:${WAS_HOME}/lib/admin.jar:${WAS_HOME}/lib/wsexception.jar:${WAS_HOME}/lib/wasjmx.jar:WBIMonitor424-FixPack3.jar run

  Important Note: In case you choose to install and deploy the BI Monitor on a Network deployment environment then the Deployment Manager must be started and running at installation time.

New Updates in Previous Patches

The BI Monitor v4.2.4 Fix Pack3 - Patch2.3 provides the following new updates:

• Support for Oracle 9.2.0.1 Database Server.

• Support for WebSphere MQ Workflow v3.5.

• Support for WebSphere Portal Server (WPS) v5.0.2.1, with the following specifications:

  • The support of WPS v5.0.2.1 is similar to the current support of WPS v4; with flexibility to deploy BI Monitor on any WAS server and to connect the Monitor Portlets to that server by defining the Monitor Host URL in the Portlets configuration page.
  • A deployed BI Monitor may utilize any security mode from the supported modes; i.e., MQWF, LDAP, etc.
  • The user has to login on a configured Monitor Portlet only once (i.e. At the first use of this portlet). The supplied login information will be kept securely for the next time the user accesses the same portlet. That is, there is no need to supply the login information again for the same configured Host URL. 
• Support for WebSphere Application Server v5.1.
  • The support is only for the following fix packs level: WAS 5.1.0 and WAS 5.1.1. 
  • You have to upgrade the JDK level of WAS 5.1.0 to JDK 1.4.2. Refer to the WebSphere Application Server support for details.
  • WBI Monitor 424 base code must be installed with manual deployment option as a pre-requisite for installing this patch. You need it only installed, but not deployed.
  • You have to select WAS 5 option while performing automatic deployment of BI Monitor. This option works with both WAS 5.0 and WAS 5.1.
• Enhancements to views handling are implemented in the following dashboards:
  • Business Dashboard:
    • Invalid Business Measures are dropped, and the saved view will continue loading.
    • If all Business Measures are invalid, the view will be invalid as well.
    • Invalid Org Unit is replaced by the current root Organization.
    • If the view is holding a reference to an invalid User, the view will be invalid.
    • If the Process is invalid, the view will be invalid.
  • Workflow Dashboard:
    • Invalid Business Measures are dropped, and the saved view will continue loading.
    • If all Business Measures are invalid, the view will be invalid as well.
    • For affected filter criteria containing one or more invalid Business Measures, the filter is completely dropped.
    • If the Sort column is associated with an invalid Business Measure, the sorting will be dropped.
    • If the Process is invalid, the view will be invalid.

• Two new JVM system properties have been added to allow segmenting the deletion operation over multiple transactions, in order to avoid overloading the database transaction log buffer (rollback segment in Oracle). You can use the default values of these properties in normal configuration parameters, otherwise you should change their values to those that suite your setup configuration. The two JVM properties are:
  • monitor.cleanup.processInstanceActivationCount: (Default value is 1000) This property represents the number of instances to be deleted every time the service is activated (default is every 5 minutes).
  • monitor.cleanup.processInstanceCount: (Default value is 100) This property represents the number of instances to be deleted every transaction, in order to segment the number of instances defined in the first property across the transactions.

Fixed Bugs:

1. APAR JR21631: Improve the display size of both Chart and Legend in Monitor Business Dashboard.
2. APAR JR21732: Fixed the bug that caused BI Monitor Business Dashboard weekly reports to display the start day as Tuesday.
3. APAR JR21713: Fixed the bug that caused Business Dashboard export CSV file to not include break down attribute values.
4. APAR JR21835: Fixed the bug that caused BI Monitor not to update Notification Duration value when re-importing a model XML file with the same Valid From date.
5. APAR JR21909: Fixed the bug that caused Business Dashboard outstanding reports negative values.
6. APAR JR21945: Fixed the bug that caused Monitor not to update subprocess assigned user when a workitem is transferd.
7. APAR JR21961: Event processor performance improvement by cashing the WFM.Process_model data to avoid unnecessary db reads over same transaction.
8. APAR JR21243: Fixed the bug that caused Monitor collector to fail when it encounters an invalid event type or event code.
9. APAR JR21330: Fixed the bug that caused Monitor to fail to process restart of NOOP Activity and restart of terminated process instance which caused these events to be directed to the Error Queue.
10. APAR JR21385: Fixed the bug that caused Monitor Activity Instances page to display a list of assigned users when activity is completed.
11. APAR JR21440: Fixed the bug that caused Monitor Business Measure Editor not to display the location of the database metric, if the location is used before.
12. APAR JR21148: Fixed the bug that caused Monitor to fail to process notification events which caused these events to be directed to the Error Queue.
13. APAR JR20417: Fixed the bug that caused wrong activities to be marked with red border in the Process Instance diagram.
14. APAR JR20637: In Korean locale environment BI Monitor displays Gregorian calendar (year 2004), rather than Korean ancient calendar called Tangun era (year 4337).

15. APAR JR20646: Fixed the bug that caused the Workflow Dashboard to give empty Business Measure Value when the used Location is at the first activity inside a Block.

16. APAR JR20810: Fixed the bug that caused the Workflow dashboard filter to give SQL error -206 when the filter includes two Business Measures if the value of one of them is a sub-string of the other's value.
17. APAR JR20821: Fixed the bug that caused the Workflow Dashboard to not calculate the Business Measure Values in case of complex container nested/Array structures.
18. APAR JR20936: Fixed the bug that handles the view name as case sensitive.
19. APAR JR20937: Fixed the bug that causes erratic ascending or descending sort of Business Measure by properly populate nonexisting Business Measures with correct default of empty string.
20. APAR JR20938: Fixed the Bug that causes two events to be directed to delayed event queue, in case of Terminate Process, that has a subprocess .
21. APAR JR20302: Fixed the bug that caused the constraint builder to not accept spaces in Process names.
22. APAR JR20310: Fixed the bug that caused Monitor to throw ORA-01000 exception (maximum number of open cursors exceeded).
23. PMR 36669,379,000: Fixed the bug that occurred while importing an XML file that causes the V-Table creation to fail if tablespace property specified does not exist. The fix is done by rolling back.
24. PMR 06012,826,826: The "Show Details" button in the Event Queue page is now enabled by default.
25. PMR 41754,689,864: Timezone"GMT+2 Johannesburg" is incorrect in monitor (returns GMT+3),ICU Bug #4265