=====================================================================
IBM® WebSphere® Business Integration (WBI) Monitor ™ 4.2.4 - Readme file
=====================================================================

-----------------------------------------------------------------------------------

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

Before using this information and the products it supports, be sure to read the general information under Copyright Notice and Notices and Trademarks

-----------------------------------------------------------------------------------

Welcome to the IBM WBI Monitor 4.2.4 Readme file. Please read this document before installing WBI Monitor 4.2.4.

You should also read the file named install.html for the required information about installing, and un-installing  WBI Monitor 4.2.4 in addition to the upgrade information from a previous version.

The contents of this Readme file are:

1 Copyright Notice

2 IBM WBI Monitor Machine Requirements

2.1 Monitor Server Requirements

2.1.1 Hardware Requirements

2.1.1.1 Windows Server

2.1.1.2 AIX® Server

2.1.1.3 Solaris Server

2.1.1.4 z/OS™ or s/390® Server

2.1.2 System Requirements

2.1.2.1 Windows Server

2.1.2.2 AIX Server

2.1.2.3 Solaris Server

2.1.2.4 z/OS or s/390 Server

2.1.3 Software Requirements

2.1.3.1 Windows, AIX, and Solaris Platforms

2.1.3.2 z/OS and OS/390 Platforms

2.2 Monitor Clients Requirements

2.2.1 Hardware Requirements

2.2.2 System Requirements

2.2.3 Software Requirements

3 What’s New in IBM WBI Monitor Version 4.2.4

3.1 General, Structure and Deployment New Features

3.1.1 New – All in One – Installation Wizard

3.1.2 New Client's User Interface

3.1.3 Globalization

3.1.4 Accessibility

3.1.5 Business Measures Editor

3.1.6 The WBI Monitor LDAP Bridge

3.1.7 Support for IBM WebSphere Portal

3.1.8 Monitoring IBM WebSphere MQ Integrator (WMQI) and IBM WBI Message Broker Message Flows

3.2 Administration Utility New Features

3.2.1 Exporting User Profile

3.2.2 Export PI Values Page

3.2.3 Event Queue Page Changes

3.3 Workflow Dashboard New Features

3.3.1 Multiple Filters

3.4 Business Dashboard’s New Features:

3.4.1 3D Charts

3.4.2 Breakdown Analysis

4 Notices and Trademarks

Top

#################################################################################

1 - Copyright Notice

IBM WEBSPHERE BUSINESS INTEGRATION MODELER AND MONITOR THIRD PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION

The license agreement for this product refers you to this file for details concerning terms and conditions applicable to third party software code included in this product, and for certain notices and other information IBM must provide to you under its license to certain software code. The relevant terms and conditions, notices and other information are provided or referenced below. Please note that any non-English version of the licenses below is unofficial and is provided to you for your convenience only. The English version of the licenses below, provided as part of the English version of this file, is the official version.

===========================================
JDOM CODE: The Program includes software developed by the JDOM Project (http://www.jdom.org/). IBM obtained the JDOM software under the terms and conditions of the following license from the JDOM project:

/*--

Copyright (C) 2000 Brett McLaughlin & Jason Hunter.
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:

1. Redistributions of source code must retain the above copyright
notice, this list of conditions, and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions, and the disclaimer that follows
these conditions in the documentation and/or other materials
provided with the distribution.

3. The name "JDOM" must not be used to endorse or promote products
derived from this software without prior written permission. For
written permission, please contact license@jdom.org.

4. Products derived from this software may not be called "JDOM", nor
may "JDOM" appear in their name, without prior written permission
from the JDOM Project Management (pm@jdom.org).

In addition, we request (but do not require) that you include in the
end-user documentation provided with the redistribution and/or in the
software itself an acknowledgement equivalent to the following:
"This product includes software developed by the
JDOM Project (http://www.jdom.org/)."
Alternatively, the acknowledgment may be graphical using the logos
available at http://www.jdom.org/images/logos.

THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.

This software consists of voluntary contributions made by many
individuals on behalf of the JDOM Project and was originally
created by Brett McLaughlin <brett@jdom.org> and
Jason Hunter <jhunter@jdom.org>. For more information on the
JDOM Project, please see <http://www.jdom.org/>.

*/

===========================================

DUNDAS SOFTWARE LTD. COMPONENTS: The Program contains material that is © 1997-1999 DUNDAS SOFTWARE LTD., all rights reserved.

===========================================

SANDSTONE TECHNOLOGY INC. COMPONENTS: The Program contains material that is © 1994-1997 SANDSTONE TECHNOLOGY INC., all rights reserved. The files SSVP210.OCX, which are redistributed with the Program, are property of SANDSTONE TECHNOLOGY INC. and cannot be further redistributed.

===========================================

ACTUATE CORP. COMPONENTS: The Program contains material that is © 1992-2002, 2003 ACTUATE CORP., all rights reserved.

===========================================

SITRAKA INC. COMPONENTS: The Program contains material that is © 1997-2002 by SITRAKA, all rights reserved. The Sitraka software may contain materials owned by Sun Microsystems, Inc. If so, all title in and copyright to the Java™ Technology are owned or licensed by Sun Microsystems, Inc., all rights reserved.

===========================================

INTERNATIONAL COMPONENTS FOR UNICODE (ICU) : The Program includes software developed by International Components for Unicode (ICU). IBM obtained the ICU software under the terms and conditions of the following license from ICU:

/*

ICU License - ICU 1.8.1 and later

COPYRIGHT AND PERMISSION NOTICE
 
Copyright (c) 1995-2003 International Business Machines Corporation and others
All rights reserved.
 
Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, and/or sell copies of the Software, and to permit persons
to whom the Software is furnished to do so, provided that the above
copyright notice(s) and this permission notice appear in all copies of
the Software and that both the above copyright notice(s) and this
permission notice appear in supporting documentation.
 
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL
INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING
FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
Except as contained in this notice, the name of a copyright holder
shall not be used in advertising or otherwise to promote the sale, use
or other dealings in this Software without prior written authorization
of the copyright holder.
 
--------------------------------------------------------------------------------
All trademarks and registered trademarks mentioned herein are the property of their respective owners.

*/
 

Top

#################################################################################

2 - IBM WBI Monitor Machine Requirements

Top

2.1 Monitor Server Requirements

Top

2.1.1 Hardware Requirements

Top

2.1.1.1 Windows Server

Top

2.1.1.2 AIX Server

Top

2.1.1.3 Solaris Server

Top

2.1.1.4 z/OS or s/390 Server

Top

2.1.2 System Requirements

Top

3.1.2.1 Windows Server

Top

2.1.2.2 AIX Server

Top

2.1.2.3 Solaris Server

Top

2.1.2.4 z/OS or s/390 Server

Top

2.1.3 Software Requirements

Top

2.1.3.1 Windows, AIX, and Solaris Platforms

To monitor WebSphere Business Integration Message Broker and WebSphere MQ Integrator Broker event flows, the WebSphere Business Integration Message Broker Monitor Emitter node SupportPac is required. This SupportPac can be downloaded free of charge at:

http://www.ibm.com/webspheremq/supportpacs

Top

2.1.3.2 z/OS and OS/390 Platforms

Top

2.2 Monitor Clients Requirements

Top

2.2.1 Hardware Requirements

Top

2.2.2 System Requirements

Top

2.2.3 Software Requirements

Top

#################################################################################

3 - What’s New in IBM WBI Monitor Version 4.2.4

This section describes the changes and enhancements that are featured in IBM WBI Monitor V4.2.4.

WBI Monitor V4.2.4 enhancements are grouped into the following categories:

Top

3.1 General, Structure and Deployment New Features:

The following are the WBI Monitor V4.2.4 new features that are related to the application structure and deployment method:

Top

3.1.1 New – All in One – Installation Wizard

IBM WBI Monitor v 4.2.4and all of its components can be installed and deployed now using the new – All in One – WBI Monitor Installation Wizard. This new wizard replace the both the previous WBI Monitor Installation Wizard that was used to extract the necessary folders and files needed for deployment, and the Automatic Deployment Wizard that was used to deploy the WBI Monitor Server on IBM WebSphere Application Server.

Please refer to the WBI Monitor Deployment Guide for details about the WBI Monitor Installation Wizard.

Top

3.1.2 New Client's User Interface

The IBM WBI Monitor 4.2.4 Client's user interface has been changed to introduce better looking interface as well as more usability and flexibility. The new user interface matches the user interface style used along WebSphere Business Integration (WBI) Suite.

Top

3.1.3 Globalization

WBI Monitor v4.2.4 provides Globalization features in order to support using multiple languages other than English. The supported code pages are:

Note: Switching GUI and text direction to Right-to-Left is not supported in this release.

In addition, the Globalization features in WBI Monitor 4.2.4 enable it to behave based on the cultural norms of the user and according to the used system locale. WBI-Monitor will accept user-specific data input and store it in Unicode-enabled database, and re-display it using user-specified cultural-sensitive formats. The globalization of WBI-Monitor depends mainly on the supported features in the used web browser.

The support for multiple languages rather than the English language requires that the WBI Monitor database must be created with UTF-8 code page.  If the monitor database has been created with a different code page (for example IBM-1252), whether as a new database for the recent version of WBI Monitor or for any previous version of WBI Monitor, and you need to allow the Globalization feature then you must export all tables of the WBI Monitor schema (defaults to WFM unless changed) and import these tables into a newly created database with UTF-8 code page before the database migration. Please consult your Database Administrator for information about converting the code page of an existing database.

The Globalization feature affects the WBI Monitor behavior in the following aspects:

Top

3.1.4 Accessibility

In compliance to Section 508 of the Rehabilitation Act, WBI Monitor 4.2.4 provides accessibility features for people who have physical disability, such as restricted mobility or limited vision.  Accessibility becomes in action for users who are blind or visually impaired by using Web page reader software, such as the IBM Home Page Reader. This software and other similar ones provide quick and efficient audio narration for Web page information.

Please refer to the WBI Monitor User Guide for details about the accessibility features in WBI Monitor.

Top

3.1.5 Business Measures Editor

WBI Monitor 4.2.4 provides a new client component - Business Measures Editor - which gives you the ability to modify the existing business measures or add new ones to the process being monitored. 

Please refer to the WBI Monitor User Guide for details about the Business Measures Editor.

Top

3.1.6 The WBI Monitor LDAP Bridge

The WBI Monitor LDAP Bridge is a new component of WBI Monitor. It  is a separate tool that is implemented and run outside the Monitor. This component is necessary to be installed if you are using IBM WebSphere MQ Workflow v3.4 that depends on an LDAP server for acquiring the users’ information. In this case any changes in the users' information/definition that occurs in the LDAP server and are reflected in the MQ Workflow should be also reflected in WBI Monitor in order to update the processes and organization information in WBI Monitor with the changed information in MQ Workflow. The WBI Monitor LDAP Bridge parses the FDL file resulted from the MQ Workflow 3.4 LDAP Bridge and generates an XML which is sent to the Monitor server to apply any staff updates in the Monitor database.

Please refer to the WBI Monitor Deployment Guide for details about the WBI Monitor LDAP Bridge

Top

3.1.7 Support for IBM WebSphere Portal

IBM WBI Monitor 4.2.4 supports the WebSphere Portal by allowing the display of customized views of its pages as portlets. These portlets can be added to the WebSphere Portal pages. The WBI Monitor Portlets that are currently available for the WebSphere Portal are:

Please refer to the chapter entitled WebSphere Portal Support in the WBI Monitor User Guide for details about this feature.

Top

3.1.8 Monitoring IBM WebSphere MQ Integrator (WMQI) and IBM WBI Message Broker Message Flows

Note: The product name "WMQI" has been recently changed to "WBI Message Broker v5". Thus, it should be noted that for every occurrence of the word "WMQI" in the WBI Modeler and Monitor products and their documentation, this word refers to both the "WMQI v2.1" and the "WBI Message Broker v5".

 

WBI Monitor 4.2.4 provides monitoring capabilities for the running Message Flows in WebSphere MQ Integrator WBI Monitor Message Broker across different applications. This capability allows managers to monitor, control, manage, and improve their business performance.

The monitoring capability requires the existence of a real WMQI message flows sequences that are fully implemented and running on WMQI. WBI Monitor is now capable to monitor these flows and to extract the values of a number of performance measurements to be displayed on the Monitor Client pages.

Please refer to the WBI Workbench Integration Guide for details about modeling the WMQI Processes. Refer also to WBI Monitor User Guide for details about monitoring the WMQI processes.

Top

3.2 Administration Utility New Features

The following are the WBI Monitor V4.2.4 new features that are related to the Administration Utility:

Top

3.2.1 Exporting User Profile

WBI Monitor 4.2.4 allows you now to export and import all users and groups with their security information (permissions) and their views data to/from an XML file format. This can be done through a new page - named Export User Profile – that has been added to the WBI Monitor Administration Utility under the Import/Export section.

Please refer to the WBI Monitor Administration Guide for details about exporting User Profile.

Top

3.2.2 Export PI Values Page

WBI Monitor 4.2.4 allows you now to export the Process Instances details for multiple processes at one time as Comma Separated Values (CSV) files. This can be done through a new page - named Export PI Values - that has been added to the WBI Monitor Administration Utility under the Import/Export section.

Please refer to the WBI Monitor Administration Guide for details about exporting Process Instance values.

Top

3.2.3 Event Queue Page Changes

The Event Queue page of the Administration Utility displays now a list of different and detailed Monitor Services. These services are responsible of performing the different Monitoring functionalities.

Please refer to the WBI Monitor Administration Guide for details about the Event Queue page and the new WBI Monitor Services.

Top

3.3 Workflow Dashboard New Features

The following are the WBI Monitor V4.2.4 new features that are related to the Workflow Dashboard:

Top

3.3.1 Multiple Filters

The Set Filter page in the Workflow Dashboard now allows you to define a process-instance or activity-instance filter by composing an expression that represents the filter query. The filter expression can be a simple or a complex one. A simple expression consists of filter criteria based on only one business measure / column header, while a complex one includes filter criteria based on multiple business measures / column headers combined together by AND or OR operators.

Please refer to the WBI Monitor User Guide for details about filtering the Process Instances Table.

Top

3.4 Business Dashboard’s New Features:

The following are the WBI Monitor V4.2.4 new features that are related to the Business Dashboard:

Top

3.4.1 3D Charts

WBI Monitor 4.2.4 provides two new graph types for representing the Graph reports in Business Dashboard. These types are 3D Pie chart and 3D Bar chart.

Please refer to the WBI Monitor User Guide for details about the Business Dashboard's new chart types.

Top

3.4.2 Breakdown Analysis

The Breakdown Analysis feature allows you to analyze the business measures values displayed in the Business Dashboard's report by breaking down the values of a specific numeric business measure by another non-numeric business measure (string or Boolean business measure).  This feature is enabled only for the Basic Analysis type. You can then select only one numeric business measure from the Business measures list on which you can apply the breakdown attribute feature.

In this case, the values of the selected numeric business measure for each frequency time unit (day, week, month, or year) will be broken down to display a separate value for each group of instances that has the same value of the non-numeric business measure (the Breakdown attribute).  In the table report, additional column will appear with the name of the selected breakdown attribute between the frequency time unit column and the numeric business measure column.

Please refer to the WBI Monitor User Guide for details about the Breakdown Analysis in Business Dashboard.

Top

#####################################################################

4 Notices and Trademarks

US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Notices

IBM may not offer the products, services, or features discussed in this document in all countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user’s responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing

IBM Corporation

North Castle Drive

Armonk, NY 10504-1785

U.S.A.

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION “AS IS”...WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions; therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

WebSphere Business Integration Lab Director

IBM RTP Laboratory

3039 Cornwallis Road

P.O. BOX 12195

Raleigh, NC 27709-2195

U.S.A

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not necessarily tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

This information may contain examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples may include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

All statements regarding IBM’s future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

COPYRIGHT LICENSE:

This information may contain sample application programs in source language, which illustrates programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs.

Programming interface information

Programming interface information, if provided, is intended to help you create application software using this program.

General-use programming interfaces allow you to write application software that obtain the services of this program’s tools.

However, this information may also contain diagnosis, modification, and tuning information. Diagnosis, modification and tuning information is provided to help you debug your application software.

Warning: Do not use this diagnosis, modification, and tuning information as a programming interface because it is subject to change.

Trademarks and service marks

The following terms are trademarks or registered trademarks of International Business Machines Corporation in the United States or other countries, or both:

IBM

MQSeries

the IBM logo

WebSphere

AIX

OS/2

AIX 5L

OS/390

e-Business (Logo)

z/OS

CrossWorlds

Rational

DB2

RS/6000

DB2 Universal Database

XDE

Top