IBM Tivoli Monitoring for Business Integration: WebSphere ...publib.boulder.ibm.com/tividd/td/ITMBI/SC32-1406... · IBM Tivoli Monitoring for Business Integration: WebSphere InterChange

IBM Tivoli Monitoring for Business Integration: WebSphere InterChange Server, Version 5.1.1 Warehouse Enablement Pack, Version 1.1.0 Implementation Guide for Tivoli Enterprise Data Warehouse, Version 1.1

SC32-1406-00

Note:

Before using this information and the product it supports, read the information in Notices.

First Edition (October 2003)

This edition applies to version 1, release 1, of Tivoli® Enterprise Data Warehouse and to all subsequent releases and modifications until otherwise indicated in new editions.

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

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

IBM Tivoli Monitoring for Business Integration: WebSphere InterChange Server Warehouse Pack Implementation Guide

i

Contents

1 ABOUT THIS DOCUMENT.................................................................................................................... 1

1.1 Who should read this guide..............................................................................................................................1

1.2 Publications .......................................................................................................................................................1 1.2.1 IBM Tivoli Monitoring for Business Integration library ............................................................................1 1.2.2 IBM Tivoli Monitoring for Business Integration: WebSphere InterChange Server library........................2 1.2.3 Tivoli Enterprise Data Warehouse library...................................................................................................2 1.2.4 Related publications....................................................................................................................................2

1.2.4.1 IBM Redbooks ........................................................................................................................................2 1.2.4.2 IBM DB2, DB2 Data Warehouse Center, and DB2 Warehouse Manager library ..................................3

1.2.5 Accessing publications online.....................................................................................................................4 1.2.6 Ordering publications..................................................................................................................................4

1.3 Accessibility .......................................................................................................................................................4

1.4 Contacting software support............................................................................................................................4

1.5 Participating in newsgroups.............................................................................................................................4

1.6 Typeface conventions........................................................................................................................................5

2 OVERVIEW ............................................................................................................................................ 6

2.1 Overview of Tivoli Enterprise Data Warehouse ............................................................................................6

2.2 Overview of WebSphere InterChange Server Warehouse Enablement Pack .............................................7

3 INSTALLING AND CONFIGURING THE WAREHOUSE PACK .......................................................... 8

3.1 Prerequisites ......................................................................................................................................................8

3.2 Supported hardware and software ..................................................................................................................8

3.3 Product notes and limitations ..........................................................................................................................8

3.4 Database sizing considerations.........................................................................................................................9

3.5 Data sources and targets.................................................................................................................................10

3.6 Pre-installation procedures ............................................................................................................................11

3.7 Installation of the warehouse pack ................................................................................................................11

3.8 Post-installation procedures...........................................................................................................................11

4 MAINTENANCE ................................................................................................................................... 12

4.1 Backing up and restoring ...............................................................................................................................12


ii

4.2 Pruning ............................................................................................................................................................12

5 ETL PROCESSES................................................................................................................................ 13

5.1 BIX_m05_Dimension_Process .......................................................................................................................13

5.2 BIX_m10_Fact_Process..................................................................................................................................13

6 CENTRAL DATA WAREHOUSE INFORMATION .............................................................................. 14

6.1 Component configuration...............................................................................................................................14 6.1.1 Component type (table CompTyp)............................................................................................................14 6.1.2 Component (table Comp)..........................................................................................................................14 6.1.3 Component relationship type (table RelnTyp) ..........................................................................................14 6.1.4 Component relationship rule (table RelnRul) ...........................................................................................15 6.1.5 Component relationship (table CompReln)...............................................................................................15 6.1.6 Attribute type (table AttrTyp) ...................................................................................................................15 6.1.7 Attribute rule (table AttrRul) ....................................................................................................................15 6.1.8 Attribute domain (table AttrDom).............................................................................................................16 6.1.9 Component attribute (table CompAttr) .....................................................................................................16

6.2 Component measurement...............................................................................................................................16 6.2.1 Measurement group type (table MGrpTyp) ..............................................................................................16 6.2.2 Measurement group (table MGrp) ............................................................................................................16 6.2.3 Measurement group member (table MGrpMbr)........................................................................................16 6.2.4 Measurement unit category (table MUnitCat)...........................................................................................17 6.2.5 Measurement unit (table MUnit)...............................................................................................................17 6.2.6 Time summary (table TmSum) .................................................................................................................17 6.2.7 Measurement source (table MSrc) ............................................................................................................17 6.2.8 Measurement type (table MsmtTyp) .........................................................................................................17 6.2.9 Component measurement rule (table MsmtRul) .......................................................................................19 6.2.10 Measurement (table Msmt) .......................................................................................................................19

6.3 Helper tables....................................................................................................................................................19

6.4 Exception tables ..............................................................................................................................................19

6.5 Incremental extraction ...................................................................................................................................19

7 IBM TIVOLI MONITORING INTEGRATION ........................................................................................ 20

7.1 Metadata tables for applications that use the resource model ETL ...........................................................20 7.1.1 Resource translation (table Resource_Transl)...........................................................................................20 7.1.2 Category translation (table Category_Transl) ...........................................................................................20 7.1.3 Component type translation (table CompTyp_Transl)..............................................................................20 7.1.4 Attribute translation (table AttrTyp_Transl) .............................................................................................20

7.2 IBM Tivoli Monitoring resource models.......................................................................................................20 7.2.1 Resource model for WebSphere InterChange Server................................................................................20

8 DATA MART SCHEMA INFORMATION ............................................................................................. 22

8.1 Star schemas....................................................................................................................................................22


iii

8.1.1 BIX Hourly WebSphere InterChange Server Schema ..............................................................................22 8.1.1.1 Fact table BIX.F_ICS_HOUR ..............................................................................................................22

8.1.2 BIX Daily WebSphere InterChange Server Schema.................................................................................22 8.1.2.1 Fact table BIX.F_ICS_DAY .................................................................................................................23

8.1.3 BIX Weekly WebSphere InterChange Server Schema .............................................................................23 8.1.3.1 Fact table BIX.F_ICS_WEEK ..............................................................................................................23

8.1.4 BIX Monthly WebSphere InterChange Server Schema............................................................................23 8.1.4.1 Fact table BIX.F_ICS_MONTH ...........................................................................................................24

8.1.5 BIX Hourly WICS Adapter and Collaboration Schema............................................................................24 8.1.5.1 Fact table BIX.F_ICSCA_HOUR.........................................................................................................24

8.1.6 BIX Daily WICS Adapter and Collaboration Schema ..............................................................................24 8.1.6.1 Fact table BIX.F_ICSCA_DAY............................................................................................................25

8.1.7 BIX Weekly WICS Adapter and Collaboration Schema ..........................................................................25 8.1.7.1 Fact table BIX.F_ICSCA_WEEK.........................................................................................................25

8.1.8 BIX Monthly WICS Adapter and Collaboration Schema .........................................................................26 8.1.8.1 Fact table BIX.F_ICSCA_MONTH......................................................................................................26

8.2 Metric dimension tables..................................................................................................................................26 8.2.1 BIX.D_ICS_METRIC...............................................................................................................................26 8.2.2 BIX.D_ICSCA_METRIC .........................................................................................................................26

8.3 Dimension tables .............................................................................................................................................27 8.3.1 Dimension table BIX.D_ICS ....................................................................................................................27 8.3.2 Dimension table BIX.D_ICSCA...............................................................................................................27

8.4 Data marts and reports...................................................................................................................................27 8.4.1 WebSphere InterChange Server data mart ................................................................................................27 8.4.2 WICS Adapter and Collaboration data mart .............................................................................................27 8.4.3 Reports ......................................................................................................................................................27

8.4.3.1 BIX Availability Status for InterChange Servers..................................................................................28 8.4.3.2 BIX Event Throughput for InterChange Servers ..................................................................................28 8.4.3.3 BIX Access Throughput for InterChange Servers.................................................................................28 8.4.3.4 BIX Memory Usage for InterChange Servers .......................................................................................28 8.4.3.5 BIX Collaboration Status for InterChange Servers ...............................................................................28 8.4.3.6 BIX Adapter Status for InterChange Servers ........................................................................................29


iv

1 About this document This document describes the Tivoli Enterprise Data Warehouse enablement pack, Version 1.1.0 for IBM® Tivoli Monitoring for Business Integration: WebSphere InterChange Server 5.1.1. This pack is created for Enterprise Data Warehouse, Version 1.1. This document covers the following topics:

• Installing and configuring the warehouse pack

• The data flow and data structures used by the warehouse pack

With this warehouse pack and the prerequisite IBM Tivoli Monitoring warehouse pack, you can extract data from the IBM Tivoli Monitoring middle layer database into the central data warehouse. The data is then used to populate data marts created for reporting on WebSphere InterChange Servers.

1.1 Who should read this guide This guide is for people who do any of the following activities:

• Plan for and install the warehouse pack • Use and maintain the warehouse pack and its reports • Create new reports • Create additional warehouse packs that use data from this warehouse pack

Administrators and installers should have the following knowledge or experience:

• Basic system administration and file management of the operating systems on which the components of Tivoli Enterprise Data Warehouse are installed

• An understanding of the basic concepts of relational database management • Experience administering IBM DB2 Universal Database

Additionally, report designers and warehouse pack creators should have the following knowledge or experience:

• An understanding of the source data and application Data warehouse information and design, extract, transform, and load (ETL) processes, and online analytical processing (OLAP)

1.2 Publications This section lists publications in the Tivoli Enterprise Data Warehouse library and other related documents. It also describes how to access Tivoli publications online and how to order Tivoli publications.

The following sets of documentation are available to help you understand, install, and manage this warehouse pack:

• IBM Tivoli Monitoring for Business Integration

• IBM Tivoli Monitoring for Business Integration: WebSphere InterChange Server

• Tivoli Enterprise Data Warehouse

• IBM DB2, DB2 Data Warehouse Center, and DB2 Warehouse Manager

• IBM Redbooks

1.2.1 IBM Tivoli Monitoring for Business Integration library The following IBM Tivoli Monitoring for Business Integration documents are available online using the Tivoli Software Information Center:

• IBM Tivoli Monitoring for Business Integration: Readme First, SC32-1439


1

Provides information on where to find all of the IBM Tivoli Monitoring for Business Integration documentation, including the titles and locations of all documentation.

• IBM Tivoli Monitoring for Business Integration Installation and Setup Guide, SC32-1402 Provides information about installing each of the IBM Tivoli Monitoring for Business Integration components.

• IBM Tivoli Monitoring for Business Integration User’s Guide, SC32-1403 Provides information about how to use each IBM Tivoli Monitoring for Business Integration component to manage resources.

• IBM Tivoli Monitoring for Business Integration Problem Determination Guide, SC32-1404 Provides information and messages to assist users with troubleshooting problems with the software.

1.2.2 IBM Tivoli Monitoring for Business Integration: WebSphere InterChange Server library

The following documents are available on the Tivoli Software Information Center:

• IBM Tivoli Monitoring for Business Integration: WebSphere Interchange Server Reference Guide, SC23-1408

Provides information about the tasks and resource models that IBM Tivoli Monitoring for Business Integration: WebSphere InterChange Server provides.

1.2.3 Tivoli Enterprise Data Warehouse library The following documents are available in the Tivoli Enterprise Data Warehouse library. The library is available on the Tivoli Enterprise Data Warehouse Documentation CD as well as online, as described in “Accessing publications online” on page 4.

• Tivoli Enterprise Data Warehouse Release Notes, SC32-1399 Provides late-breaking information about Tivoli Enterprise Data Warehouse and lists hardware requirements and software prerequisites.

• Installing and Configuring Tivoli Enterprise Data Warehouse, GC32-0744 Describes how Tivoli Enterprise Data Warehouse fits into your enterprise, explains how to plan for its deployment, and gives installation and configuration instructions. It contains maintenance procedures and troubleshooting information.

• Enabling an Application for Tivoli Enterprise Data Warehouse, GC32-0745 Provides information about connecting an application to Tivoli Enterprise Data Warehouse. This book is for application programmers who use Tivoli Enterprise Data Warehouse to store and report on their application data, data warehousing experts who import Tivoli Enterprise Data Warehouse data into business intelligence applications, and customers who put their local data in Tivoli Enterprise Data Warehouse.

1.2.4 Related publications The following sections describe additional publications to help you understand and use Tivoli Enterprise Data Warehouse.

1.2.4.1 IBM Redbooks IBM Redbooks are developed and published by the IBM International Technical Support Organization, the ITSO. They explore integration, implementation, and operation of realistic customer scenarios. The following Redbooks contain information about Tivoli Enterprise Data Warehouse:


2

• Introduction to Tivoli Enterprise Data Warehouse, SG24-6607-00 Provides a broad understanding of Tivoli Enterprise Data Warehouse. Some of the topics that are covered are concepts, architecture, writing your own extract, transform, and load processes (ETLs), and best practices in creating data marts.

• Planning a Tivoli Enterprise Data Warehouse Project, SG24-6608-00 Describes the necessary planning you must complete before you can deploy Tivoli Enterprise Data Warehouse. The guide shows how to apply these planning steps in a real-life deployment of a warehouse pack using IBM Tivoli Monitoring. It also contains frequently used Tivoli and DB2 commands and lists troubleshooting tips for Tivoli Enterprise Data Warehouse.

1.2.4.2 IBM DB2, DB2 Data Warehouse Center, and DB2 Warehouse Manager library

The DB2 library contains important information about the database and data warehousing technology provided by IBM DB2, DB2 Data Warehouse Center, and DB2 Warehouse Manager. Refer to the DB2 library for help in installing, configuring, administering, and troubleshooting DB2, which is available on the IBM Web site:

http://www-3.ibm.com/software/data/db2/library/

After you install DB2, its library is also available on your system.

The following DB2 documents are particularly relevant for people working with Tivoli Enterprise Data Warehouse:

• IBM DB2 Universal Database for Windows Quick Beginnings, GC09-2971 Guides you through the planning, installation, migration (if necessary), and setup of a partitioned database system using the IBM DB2 product on Microsoft Windows.

• IBM DB2 Universal Database for UNIX Quick Beginnings, GC09-2970 Guides you through the planning, installation, migration (if necessary), and setup of a partitioned database system using the IBM DB2 product on UNIX.

• IBM DB2 Universal Database Administration Guide: Implementation, SC09-2944 Covers the details of implementing your database design. Topics include creating and altering a database, database security, database recovery, and administration using the Control Center, which is a DB2 graphical user interface.

• IBM DB2 Universal Database Data Warehouse Center Administration Guide, SC26-9993 Provides information on how to build and maintain a data warehouse using the DB2 Data Warehouse Center.

• IBM DB2 Warehouse Manager Installation Guide, GC26-9998 Provides information on how to install the following Warehouse Manager components: Information Catalog Manager, warehouse agents, and warehouse transformers.

• IBM DB2 Universal Database and DB2 Connect Installation and Configuration Supplement, GC09-2957 Provides advanced installation considerations, and guides you through the planning, installation, migration (if necessary), and set up of a platform-specific DB2 client. This supplement also contains information on binding, setting up communications on the server, the DB2 GUI tools, DRDA® AS, distributed installation, the configuration of distributed requests, and accessing heterogeneous data sources.

• IBM DB2 Universal Database Message Reference Volume 1, GC09-2978 and IBM DB2 Universal Database Message Reference Volume 2, GC09-2979 Lists the messages and codes issued by DB2, the Information Catalog Manager, and the DB2 Data Warehouse Center, and describes the actions you should take.


3

http://www-3.ibm.com/software/data/db2/library/

1.2.5 Accessing publications online The publications CD or product CD contains the publications that are in the product library. The format of the publications is PDF, HTML, or both.

IBM posts publications for this and all other Tivoli products, as they become available and whenever they are updated, to the Tivoli Software Information Center Web site. The Tivoli Software Information Center is located at the following Web address:

http://publib.boulder.ibm.com/tividd/td/tdprodlist.html

Note: If you print PDF documents on other than letter-sized paper, select the Fit to page check box in the Adobe Acrobat Print dialog. This option is available when you click File Print. Fit to page ensures that the full dimensions of a letter-sized page print on the paper that you are using.

1.2.6 Ordering publications You can order many Tivoli publications online at the following Web site:

http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi

You can also order by telephone by calling one of these numbers:

• In the United States: 800-879-2755 • In Canada: 800-426-4968 • In other countries, for a list of telephone numbers, see the following Web site:

http://www.ibm.com/software/tivoli/order-lit/

1.3 Accessibility Accessibility features help users with a physical disability, such as restricted mobility or limited vision, to use software products successfully. For the warehouse pack, you use the interfaces of IBM DB2 and the reporting tool. See those documentation sets for accessibility information.

1.4 Contacting software support If you have a problem with a Tivoli product, refer to the following IBM Software Support Web site:

http://www.ibm.com/software/sysmgmt/products/support/

If you want to contact customer support, see the IBM Software Support Guide at the following Web site:

http://techsupport.services.ibm.com/guides/handbook.html

The guide provides information about how to contact IBM Software Support, depending on the severity of your problem, and the following information:

• Registration and eligibility • Telephone numbers and e-mail addresses, depending on the country in which you are located • Information you must have before contacting IBM Software Support

1.5 Participating in newsgroups User groups provide software professionals with a forum for communicating ideas, technical expertise, and experiences related to the product. They are located on the Internet, and are available using standard news reader programs. These groups are primarily intended for user-to-user communication, and are not a replacement for formal support. You can use Web browsers like Netscape Navigator or Microsoft Internet Explorer to view these newsgroups:

Tivoli Enterprise Data Warehouse

news://news.software.ibm.com/ibm.software.tivoli.enterprise-data-warehouse


4

http://publib.boulder.ibm.com/tividd/td/tdprodlist.html

http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi

http://www.ibm.com/software/tivoli/order-lit/

http://www.ibm.com/software/sysmgmt/products/support/

http://techsupport.services.ibm.com/guides/handbook.html

news://news.software.ibm.com/ibm.software.tivoli.enterprise-data-warehouse

1.6 Typeface conventions This guide uses the following typeface conventions:

Bold

• Lowercase commands and mixed case commands that are otherwise difficult to distinguish from surrounding text

• Interface controls (check boxes, push buttons, radio buttons, spin buttons, fields, folders, icons, list boxes, items inside list boxes, multicolumn lists, containers, menu choices, menu names, tabs, property sheets), labels (such as Tip and Operating system considerations)

• Column headings in a table • Keywords and parameters in text

Italic

• Citations (titles of books, diskettes, and CDs) • Words defined in text • Emphasis of words (words as words) • Letters as letters • New terms in text (except in a definition list) • Variables and values you must provide

Monospace

• Examples and code examples • File names, programming keywords, and other elements that are difficult to distinguish from

surrounding text • Message text and prompts addressed to the user • Text that the user must type • Values for arguments or command options


5

2 Overview The following sections provide an overview of Tivoli Enterprise Data Warehouse and the IBM Tivoli Monitoring for Business Integration: WebSphere InterChange Server warehouse pack.

2.1 Overview of Tivoli Enterprise Data Warehouse Tivoli Enterprise Data Warehouse provides the infrastructure for the following:

• Extract, transform, and load (ETL) processes through the IBM DB2 Data Warehouse Center tool

• Schema generation of the central data warehouse

• Historical reporting

As shown in Figure 1, Tivoli Enterprise Data Warehouse consists of a centralized data store where historical data from many management applications can be stored, aggregated, and correlated.

Figure 1. Tivoli Enterprise Data Warehouse overview

The central data warehouse uses a generic schema that is the same for all applications. As new components or new applications are added, more data is added to the database; however, no new tables or columns are added in the schema.

A data mart is a subset of a data warehouse that contains data tailored and optimized for the specific reporting needs of a department or team.

The central data warehouse ETL reads the data from the operational data stores of the application that collects it, verifies the data, makes the data conform to the schema, and places the data into the central data warehouse.


6

The data mart ETL extracts a subset of data from the central data warehouse, transforms it, and loads it into one or more star schemas, which can be included in data marts to answer specific business questions.

A program that provides these ETLs is called a warehouse enablement pack, referred to as a warehouse pack in the rest of this document.

The ETLs are typically scheduled to run periodically, usually during non-peak hours. If an ETL encounters data that it cannot correctly transform, it creates an entry in an exception table. Exception tables are described in Exception tables on page 19.

2.2 Overview of WebSphere InterChange Server Warehouse Enablement Pack

The warehouse pack for IBM Tivoli Monitoring for Business Integration: WebSphere InterChange Server provides metadata to enable the IBM Tivoli Monitoring 5.1.1 central data warehouse ETL to load data into the central data warehouse for WebSphere InterChange Server servers, adapters and collaborations. The IBM Tivoli Monitoring for Business Integration: WebSphere InterChange Server resource models running on Tivoli endpoints collect and log this operational data. The IBM Tivoli Monitoring Tivoli Data Warehouse Support 5.1.1 component then uploads and inserts the operational data into a middle layer RIM database.

This warehouse pack also provides a data mart ETL that extracts historical WebSphere InterChange Server data from the central data warehouse and inserts the data into the related star schemas. The star schema is included in the Monitoring for WebSphere InterChange Server data mart from which prepackaged reports are provided for WebSphere InterChange Server status and analysis. You can also use the Monitoring for WebSphere InterChange Server data mart to create customized reports to meet your specific analytical needs.


7

3 Installing and configuring the warehouse pack This section describes the information about installing and configuring the warehouse pack.

3.1 Prerequisites Before installing the WebSphere InterChange Server warehouse pack, the following software must be installed:

• IBM Tivoli Monitoring for Business Integration, Version 5.1.1: WebSphere MQ Workflow • IBM DB2 Universal Database Enterprise Edition Version 7.2 • IBM DB2 Universal Database Enterprise Edition Version 7.2 Fix Pack 8 • Tivoli Enterprise Data Warehouse, Version 1.1 • Tivoli Enterprise Data Warehouse, Version 1.1 fix pack 2 (1.1-TDW-FP02) • IBM Tivoli Monitoring, Version 5.1.1, warehouse pack

You can obtain the Tivoli Enterprise Data Warehouse fix pack from the following Web site:

http://www.ibm.com/software/sysmgmt/products/support/TivoliDataWarehouse.html

Click the Downloads link in the Self help section.

3.2 Supported hardware and software WebSphere InterChange Server warehouse pack, Version 1.1.0, supports IBM Tivoli Monitoring for Business Integration: WebSphere InterChange Server, Version 5.1.1. It supports all versions of DB2, Informix, Microsoft SQL Server, Oracle, and Sybase database products as documented in the IBM Tivoli Monitoring 5.1.1 Release Notes GI10-5797-01 in the “Documentation Notes” sections.

For information about the hardware and software requirements of Tivoli Enterprise Data Warehouse, see the Tivoli Enterprise Data Warehouse Release Notes.

3.3 Product notes and limitations This warehouse pack must be installed using the user "db2". If that is not the user name used when installing the Tivoli Enterprise Data Warehouse core application, you must create a user temporary tablespace for use by the installation program. The user temporary tablespace that is created in each central data warehouse database and data mart database during the installation of Tivoli Enterprise Data Warehouse is accessible only to the user that performed the installation.

If you are installing the warehouse pack using the same database user that installed Tivoli Enterprise Data Warehouse, or if your database user has access to another user temporary tablespace in the target databases, no additional action is required.

If you do not know the user name that was used to install Tivoli Enterprise Data Warehouse, you can determine whether the tablespace is accessible by attempting to declare a temporary tablespace while connected to each database as the user that will install the warehouse pack. The following commands are one way to do this: db2 "connect to TWH_CDW user installing_user using password" db2 "declare global temporary table t1 (c1 char(1))with replace on commit preserve rows not logged"

db2 "disconnect TWH_CDW"

db2 "connect to TWH_MART user installing_user using password" db2 "declare global temporary table t1 (c1 char(1))with replace on commit preserve rows not logged"

db2 "disconnect TWH_MART"

The variables in these commands are the following:

installing_user Identifies the database user that will install the warehouse pack.


8

http://www.ibm.com/software/sysmgmt/products/support/TivoliDataWarehouse.html

password Specifies the password for the installing user.

If the declare command is successful, the specified database user can install the warehouse pack. No additional action is required.

If the declare command fails, run the following DB2 commands to create a new tablespace for the installation in both the central data warehouse database and data mart databases: db2 "connect to TWH_CDW user installing_user using password" db2 "create user temporary tablespace usertmp2 managed by system using (' usertmp2')"

db2 "disconnect TWH_CDW"

db2 "connect to TWH_MART user installing_user using password" db2 "create user temporary tablespace usertmp3 managed by system using (' usertmp3')"

db2 "disconnect TWH_MART"

The variables in these commands are the following:

installing_user Identifies the database user that will install the warehouse pack.

password Specifies the password for the installing user.

3.4 Database sizing considerations Ensure that you have sufficient space in the central data warehouse database for the historical data collected by this warehouse pack. To estimate how much space is required for the warehouse pack, create a worksheet, like the following example:

Component Number of components

Space per component (in bytes)

Number of measurements

Host 2 981 0

InterChange Server 2 667 12

Adapter or Collaboration

100 491 13

To calculate the approximate database size needed for components:

(number of hosts % space per component) + (number of servers % space per component )+(number of adapters and collaborations % space per component)

So for 2 hosts, 2 servers and 100 adapters and collaborations, the resulting equation is the following:

(2 % 981) + (2 % 667) + (100 % 491) = 1962 + 1334 + = 2240 bytes

To calculate the approximate database size used in one day for measurements, use the following formula:

One row in the measurement table is approximately 70 bytes.

number of servers % measurements per server + number of adapters and collaborations % number of measurements % 24 hours % 70 bytes per row

So for 2 servers collecting all 12 measurements and 100 adapters and collaborations, the resulting equation is the following:

((2 % 12) + (100 % 13)) % 24 % 70 = 2,224,320 bytes per day

Measurements are stored for 3 months, 90 days as a default. To calculate 3 months of storage for measurements (in MB), use the following formula:

Daily size % 90/1024000


9

So for our example the resulting equation is the following:

2224320 % 90/1024000 = 195.497 MB

Add an additional 10% for temporary and staging tables used.

Use the following table and examples to estimate the space you will need for the TWH_MART database.

Component SPACE PER COMPONENT (IN BYTES)

Host 263

InterChange Server 276

Adapter or Collaboration

135

To calculate the approximate database size needed for components:

(number of hosts % space per component) + ( number of servers % space per component ) +

(number or adapters and collaborations % space per component)

So for 2 hosts, 2 servers and 100 adapters and collaborations we would have:

(2 % 263) + (2 % 276) + (100 % 135) = 526 + 552 + 13500= 14578 bytes

To calculate the approximate database size used in one day for measurements use the following formula:

One row in the measurement table is approximately 63 bytes.

number of servers % measurements per server % 24 hours % 63 bytes per row

So for 2 servers collecting 12 and 100 adapters and collaborations collecting 13 measurements, the result is as follows:

((2 % 12) + (100 % 13)) % 24 % 63 = 2001888 bytes per day

Measurements are stored for 3 months, or 90 days, as a default. To calculate 3 months of storage for measurements in megabytes use the following formula:

Daily size % 90/1024000

So in the example, the result is as follows:

75600 % 90/1024000 = 175.947 MB

Add an additional 10 percent for temporary and staging tables used.

3.5 Data sources and targets Because the warehouse pack for IBM Tivoli Monitoring for Business Integration: WebSphere InterChange Server uses the IBM Tivoli Monitoring 5.1.1 warehouse pack, no additional data sources nor target sources are required for operational data. However, you may need to update the user ID and password for the AMX_TWH_CDW_Source and AMX_ITM_RIM_Source data sources and the AMX_TWH_CDW_Target data target.

You may need to use the data warehouse center sources to configure the AMX_ITM_RIM_Source for the RIM database. Use the following steps to configure the AMX_ITM_RIM_Source:

1. Right click on the AMX_ITM_RIM source and select properties. 2. Select the data source tab. 3. Enter the database, host, userid, and password for the RIM database.


10

Data sources and targets specific to the IBM Tivoli Monitoring for Business Integration: WebSphere InterChange Server warehouse enablement pack, version 1.1.0 are BIX_TWH_CDW_Source, BIX_TWH_MART_Target, and BIX_TWH_MD_Target.

3.6 Pre-installation procedures Before installing the warehouse pack for IBM Tivoli Monitoring for Business Integration: WebSphere InterChange Server, you must install the prerequisites listed in Section 4.1, Prerequisites on page 8.

Before installing the warehouse pack for IBM Tivoli Monitoring for Business Integration: WebSphere InterChange Server, you must also install the IBM Tivoli Monitoring 5.1.1 warehouse enablement pack and configure the data source name for the AMX_TWH_ITM_RIM_Source to the ODBC system data source name created for the IBM Tivoli Monitoring middle layer database.

3.7 Installation of the warehouse pack Install the warehouse pack as described in Installing and Configuring Tivoli Enterprise Data Warehouse. The installation media for the warehouse pack is located on the IBM Tivoli Monitoring for Business Integration: WebSphere InterChange Server 5.1.1 Component Software CD in directory /TEDW/tedw_apps_etl/bix.

3.8 Post-installation procedures After you install the warehouse enablement pack, use the procedures in Installing and Configuring Tivoli Enterprise Data Warehouse to use the Data Warehouse Center to perform the following configuration tasks for data sources and targets:

1. Make sure the control database is set to TWH_MD.

2. Specify the properties for the warehouse source BIX_TWH_CDW_Source. These properties are in the Database page.

• In the User ID field type the user ID used to access the central data warehouse database. The default value is db2admin.

• In the Password field, type the password used to access the central data warehouse database.

• Do not change the value of the Data Source field. It must be TWH_CDW.

3. Specify the following properties for the warehouse target BIX_TWH_MART_Target. These properties are in the Database page.

• In the User ID field type the user ID used to access the data mart database. The default value is db2admin.

• In the Password field, type the password used to access the data mart database.

• Do not change the value of the Data Source field. It must be TWH_MART.

4. Specify dependencies between processes and schedule processes that are to run automatically. The processes for this warehouse pack are located in the BIX_Monitoring_for_WebSphere_ICS_v1.1.0 subject area. The processes should be run in the following order:

1. BIX_m05_Dimension_Process

2. BIX_m10_Fact_Process


11

4 Maintenance This section describes maintenance tasks for the warehouse pack.

4.1 Backing up and restoring Because this warehouse pack does not create any tables in the IBM Tivoli Monitoring middle layer repository, no additional backup of this database nor any special precautions are required before running the Tivoli Enterprise Data Warehouse processes.

4.2 Pruning Entries in the hourly and daily fact tables are deleted after 3 months. Entries in the weekly and monthly fact tables are deleted after a year. This can be changed in the BIX.Prune_Mart_Control table in the TWH_MART database. The format for the pmartc_duration field is yyyymmdd, where yyyy represents the number of years, mm represents the number of months, and dd represents number of days. The default setting for the hourly and daily fact tables is 300, which represents 3 months. The default value for the weekly and monthly fact tables is 10000, which represents 1 year.


12

5 ETL processes This warehouse pack has the following processes:

• BIX_m05_Dimension_Process • BIX_m10_Fact_Process

The best time to schedule IBM Tivoli Monitoring central data warehouse ETL processes is during times of minimal system activity. The time required for an IBM Tivoli Monitoring central data warehouse ETL process to complete is dependent upon the amount of data generated by the application. It is recommended that you do not schedule the IBM Tivoli Monitoring central data warehouse ETL processes during regular business hours.

The dimension process script will need to successfully complete before the fact process scripts can run. There is a log file created in the sqllib/logging directory each time the scripts are run. This can be used for debugging a script that fails to run.

5.1 BIX_m05_Dimension_Process This process populates the InterChange Server dimension tables from the central data warehouse database.

Run this process after running the IBM Tivoli Monitoring central data warehouse ETL. This process has the following step:

• BIX_m05_s010_Dimension

This step populates the InterChange Server dimension tables in the data mart database.

5.2 BIX_m10_Fact_Process This process populates the fact tables with the new data from the warehouse measurement table.

Run this process after successfully running the BIX_m05_ Dimension_Process. You can create shortcuts for IBM Tivoli Monitoring central data warehouse ETL application processes, to run them in order and ensure that they do not run if the previous IBM Tivoli Monitoring central data warehouse ETL process did not complete successfully. Refer to the “Configuring and scheduling warehouse pack ETL processes” in the Installing and Configuring Tivoli Enterprise Data Warehouse, GC32-0744-00.

This process has the following steps:

• BIX_m10_s010_Fact_Process

This step populates the bix.f_ics_hour and bix.f_icsca_hour tables with the new data from the warehouse measurement table.

• BIX_m10_s020_ICS_Status

This step rolls the data from the server fact hour tables into the fact day, week, and month tables for reports using the daily, weekly, or monthly star schemas. The BIX_m10_s010_Fact_Process should successfully complete before this step is run.

• BIX_m10_s030_ICSCA

This step rolls the data from the fact hour tables into the fact day, week, and month tables for reports using the daily, weekly, or monthly star schemas. The BIX_m10_s010_Fact_Process should successfully complete before this step is run.


13

6 Central data warehouse information Before reading this section, read about the generic schema for the Tivoli Enterprise Data Warehouse central data warehouse, which is described in Enabling an Application for Tivoli Enterprise Data Warehouse. That document defines the content of each table and explains the relationships between the tables in this document.

Shaded columns in the following tables are translated. These columns are also marked with an asterisk (*) after the column name.

6.1 Component configuration The following sections describe the component configuration.

6.1.1 Component type (table CompTyp) CompTyp_Cd CHAR(17)

CompTyp_Parent_Cd CHAR(17)

CompTyp_Nm* VARCHAR(120)

CompTyp_Strt_DtTm TIMESTAMP

CompTyp_End_DtTm TIMESTAMP

IP_HOST NULL IP Host 2002-01-19-11.36.54.000000 9999-01-01-00.00.00.000000 BIX_HOST NULL WebSphere

InterChange Server Host

2002-01-19-11.36.54.000000 9999-01-01-00.00.00.000000

BIX_ICS NULL WebSphere InterChange Server

2002-01-19-11.36.54.000000 9999-01-01-00.00.00.000000

BIX_COLLAB BIX_ICS WebSphere InterChange Server Collaboration

2002-01-19-11.36.54.000000 9999-01-01-00.00.00.000000

BIX_ADAPTER BIX_ICS WebSphere InterChange Server Adapter

2002-01-19-11.36.54.000000 9999-01-01-00.00.00.000000

IP_INTERFACE NULL IP Interface 2002-01-19-11.36.54.000000 9999-01-01-00.00.00.000000

6.1.2 Component (table Comp)

Com

p_ID

INT

EG

ER

Com

pTyp

_Cd

CH

AR

(1

7)

Cen

tr_C

d C

HA

R(6

)

Cus

t_ID

IN

TE

GE

R

Com

p_C

orr_

ID

INT

EG

ER

Com

p_N

m*

VA

RC

HA

R (2

54)

Com

p_C

orr_

Val

V

AR

CH

AR

(254

)

Com

p_St

rt_D

tTm

T

IME

STA

MP

Com

p_E

nd_D

tTm

T

IME

STA

MP

Com

p_D

s VA

RC

HA

R

(254

)

1 IP_HOST CDW 1 0 WICSdev.ibm.com

2002-01-19-11.36.54.000000

9999-01-01-00.00.00.000000

IP_HOST

2 BIX_ICS CDW 1 1 myICS 2002-01-19-11.36.54.000000

9999-01-01-00.00.00.000000

3 BIX_COLLAB CDW 1 2 myCollab 2002-01-19-11.36.54.000000

9999-01-01-00.00.00.000000

4 BIX_ADAPTER CDW 1 2 myAdapter 2002-01-19-11.36.54.000000

9999-01-01-00.00.00.000000

6.1.3 Component relationship type (table RelnTyp) RelnTyp_Cd RelnTyp_Nm*


14

CHAR(6) VARCHAR(120)

PCHILD Parent child relation

6.1.4 Component relationship rule (table RelnRul) CompTyp_Source_Cd CHAR(17)

CompTyp_Target_Cd CHAR(17)

RelnTyp_Cd CHAR(6)

RelnRul_Strt_DtTm TIMESTAMP

RelnRul_End_DtTm TIMESTAMP

IP_HOST BIX_ICS PCHILD 2002-01-19-11.36.54.000000

9999-01-01-00.00.00.000000

IP_INTERFACE BIX_ICS PCHILD 2002-01-19-11.36.54.000000

9999-01-01-00.00.00.000000

BIX_HOST BIX_ICS PCHILD 2002-01-19-11.36.54.000000

9999-01-01-00.00.00.000000

BIX_ICS BIX_COLLAB PCHILD 2002-01-19-11.36.54.000000

9999-01-01-00.00.00.000000

BIX_ICS BIX_ADAPTER PCHILD 2002-01-19-11.36.54.000000

9999-01-01-00.00.00.000000

6.1.5 Component relationship (table CompReln) CompReln_ID INTEGER

Comp_Source_ID INTEGER

Comp_Target_ID INTEGER

RelnTyp_Cd CHAR(6)

CompReln_Strt_DtTm TIMESTAMP

CompReln_End_DtTm TIMESTAMP

1 1 2 PCHILD 2002-01-19-11.36.54.000000

9999-01-01-00.00.00.000000

2 2 3 PCHILD 2002-01-19-11.36.54.000000

9999-01-01-00.00.00.000000

3 2 4 PCHILD 2002-01-19-11.36.54.000000

9999-01-01-00.00.00.000000

6.1.6 Attribute type (table AttrTyp) AttrTyp_Cd CHAR(17)

AttrTyp_Nm* VARCHAR(120)

LAST_IP_ADDRESS Last IP Address

AMX_EID IBM Tivoli Monitoring Endpoint Identifier

AMX_GMT_OFFSET IBM Tivoli Monitoring Endpoint GMT Offset

BIX_ICS_MEMORY Total InterChange Server Memory

6.1.7 Attribute rule (table AttrRul) CompTyp_Cd CHAR(17)

AttrTyp_Cd CHAR(17) AttrRul_Strt_DtTm TIMESTAMP

AttrRul_End_DtTm TIMESTAMP

AttrRul_Dom_Ind CHAR

IP_HOST LAST_IP_ADDRESS 2002-01-19-11.36.54.000000

9999-01-01-00.00.00.000000

N

BIX_HOST AMX_EID 2002-01-19-11.36.54.000000

9999-01-01-00.00.00.000000

N

BIX_HOST AMX_GMT_OFFSET 2002-01-19-11.36.54.000000

9999-01-01-00.00.00.000000

N

BIX_ICS BIX_ICS_MEMORY 2002-01-19-11.36.54.000000

9999-01-01-00.00.00.000000

N


15

6.1.8 Attribute domain (table AttrDom) This warehouse pack does not use the attribute domain table.

6.1.9 Component attribute (table CompAttr) CompAttr_ID INTEGER

Comp_ID INTEGER

AttrTyp_Cd CHAR(17)

CompAttr_Strt_DtTm TIMESTAMP

CompAttr_End_DtTm TIMESTAMP

CompAttr_Val VARCHAR(254)

1 1 AMX_EID 2002-01-19-11.36.54.000000 9999-01-01-00.00.00.000000

1

2 1 AMX_GMT_OFFSET 2002-01-19-11.36.54.000000 9999-01-01-00.00.00.000000

-300

3 2 BIX_ICS_MEMORY 2002-01-19-11.36.54.000000 9999-01-01-00.00.00.000000

5000

4 1 LAST_IP_ADDRESS 2002-01-19-11.36.54.000000 9999-01-01-00.00.00.000000

1.22.33.44

6.2 Component measurement The following sections describe the component measurement.

6.2.1 Measurement group type (table MGrpTyp) MGrpTyp_Cd CHAR(6)

MGrpTyp_Nm* VARCHAR(120)

CATEG Category

GROUP Aggregate Types or Group Functions

STATE State

6.2.2 Measurement group (table MGrp) MGrp_Cd CHAR(6)

MGrpTyp_Cd CHAR(6)

MGrp_Parent_Cd CHAR(6)

MGrp_Nm* VARCHAR(120)

PERF CATEG NULL Performance

UTIL CATEG NULL Utilization

AVL CATEG NULL Availability

AVG_E GROUP NULL Average Value Exists

MIN_E GROUP NULL Minimum Value Exists

MAX_E GROUP NULL Maximum Value Exists

TOT_E GROUP NULL Total Value Exists

BIX_ST STATE NULL WebSphere InterChange Server Status

6.2.3 Measurement group member (table MGrpMbr) MGrp_Cd CHAR(6)

MGrpTyp_Cd CHAR(6)

MsmtTyp_ID INTEGER

AVG_E GROUP 1-3, 7-9, 13-23

BIX_ST STATE 1-3

TOT_E GROUP 4-6, 10-12, 24, 25

MIN_E GROUP 7, 15, 16, 19-23


16

MGrp_Cd MGrpTyp_Cd MsmtTyp_ID CHAR(6) CHAR(6) INTEGER

MAX_E GROUP 7, 15, 16, 19-23

6.2.4 Measurement unit category (table MUnitCat) MunitCat_Cd CHAR(6)

MunitCat_Nm* VARCHAR(120)

QTY Quantity

PRC Percentage

6.2.5 Measurement unit (table MUnit) MUnit_Cd CHAR(6)

MUnitCat_Cd CHAR(6)

Munit_Nm* VARCHAR(120)

PRC PRC Percentage

QTY QTY Quantity

MB QTY Megabytes

6.2.6 Time summary (table TmSum) The period over which a measurement may be summarized. TmSum_Cd CHAR

TmSum_Nm* VARCHAR(120)

H Hourly

6.2.7 Measurement source (table MSrc) MSrc_Cd CHAR(6)

MSrc_Parent_Cd CHAR(6)

MSrc_Nm* VARCHAR(120)

Tivoli NULL Tivoli Application

AMX Tivoli IBM Tivoli Monitoring

BIX AMX IBM Tivoli Monitoring for Business Integration: WebSphere InterChange Server 5.1.1

6.2.8 Measurement type (table MsmtTyp) MsmtTyp_ID INTEGER

MUnit_Cd CHAR(6)

MSrc_Cd CHAR (6)

MsmtTyp_Nm* VARCHAR(120)

MsmtTyp_Ds* VARCHAR(254)

1 PRC BIX InterChange_Server_Status_Up InterChange Server status up

2 PRC BIX InterChange_Server_Status_Down InterChange Server status down

3 PRC BIX InterChange_Server_Status_Unknown InterChange Server status unknown

4 QTY BIX Collaboration_Events_Processed Number of events processed by collaborators

5 QTY BIX Collaboration_Events_Successful Number of successful events by collaborators


17

MsmtTyp_ID MUnit_Cd MSrc_Cd MsmtTyp_Nm* MsmtTyp_Ds* INTEGER CHAR(6) CHAR (6) VARCHAR(120) VARCHAR(254)

6 QTY BIX Collaboration_Events_Failed Number of failed events by collaborators

7 QTY BIX Collaboration_Events_Queued Number of queued events by collaborators

8 PRC BIX Percent_of_Successful_Collaboration_Events Percent of successful collaboration events

9 PRC BIX Percent_of_Failed_Collaboration_Events Percent of failed collaboration events

10 QTY BIX Access_Events_Processed Number of access events processed

11 QTY BIX Access_Events_Successful Number of successful access events

12 QTY BIX Access_Events_Failed Number of failed access events

13 PRC BIX Percent_of_Successful_Access_Events Percent of successful access events

14 PRC BIX Percent_of_Failed_Access_Events Percent of failed access events

15 MB BIX InterChange_Server_Memory_Free Amount of free memory in this InterChange Server

16 MB BIX InterChange_Server_Memory_Used Amount of memory used in this InterChange Server

17 PRC BIX Percent_of_InterChange_Server_Memory_Used Percent of memory used by the InterChange Server

18 PRC BIX Percent_of_InterChange_Server_Memory_Free Percent of memory free for the InterChange Server

19 QTY BIX Paused_Collaborations Number of collaborations paused

20 QTY BIX Stopped_Collaborations Number of collaborations stopped

21 QTY BIX Paused_Adapters Number of adapters paused

22 QTY BIX Stopped_Adapters Number of adapters stopped

23 QTY BIX Congested_Collaborations Number of collaborations congested

24 QTY BIX Consume_Operations Number of consume operations

25 QTY BIX Events_Retrieved Number of events retrieved


18

6.2.9 Component measurement rule (table MsmtRul) CompTyp_Cd CHAR(17)

MsmtTyp_ID INTEGER

BIX_ICS 1-3, 15-23

BIX_COLLAB 4-14

BIX_ADAPTER 24, 25

6.2.10 Measurement (table Msmt)

Msm

t_ID

BIG

INT

Com

p_ID

INT

EG

ER

Msm

tTyp

_ID

IN

TE

GE

R

Tm

Sum

_Cd

CH

AR

Msm

t_St

rt_D

t DA

TE

Msm

t_St

rt_T

m T

IME

Msm

t_M

in_V

al

DO

UB

LE

Msm

t_M

ax_V

al

DO

UB

LE

Msm

t_A

vg_V

al

DO

UB

LE

Msm

t_T

ot_V

al

DO

UB

LE

Msm

t_Sm

pl_C

nt

INT

EG

ER

Msm

t_E

rr_C

nt

INT

EG

ER

1 2 1 H 2003-03-01

01:00:00 100

2 2 2 H 2003-03-01

01:00:00 0

3 2 3 H 2003-03-01

01:00:00 0

4 2 4 H 2003-03-01

01:00:00 0

6.3 Helper tables This warehouse pack does not generate helper tables.

6.4 Exception tables This warehouse pack does not generate exception tables.

6.5 Incremental extraction This warehouse pack does not include incremental extraction.


19

7 IBM Tivoli Monitoring integration

7.1 Metadata tables for applications that use the resource model ETL This section defines the data in the Tivoli Enterprise Data Warehouse central data warehouse.

7.1.1 Resource translation (table Resource_Transl) Resource VARCHAR(128)

CompTyp_cd VARCHAR(17)

InterChange_Server BIX_ICS

InterChange_Server_Collaboration BIX_COLLAB

InterChange_Server_Adapter BIX_ADAPTER

7.1.2 Category translation (table Category_Transl) Category VARCHAR(128)

MSrc_cd CHAR(3)

WebSphere_InterChange_Server BIX

7.1.3 Component type translation (table CompTyp_Transl) MSrc_Cd CHAR(3)

ITM_Key_Property1 VARCHAR(1096)

CompTyp_Cd VARCHAR(17)

Comp_Format_Nm1 VARCHAR(254)

BIX InterChange_Server.ics_name BIX_ICS InterChange_Server.ics_name

BIX InterChange_Server_Collaboration.collaboration_name BIX_COLLAB InterChange_Server_Collaboration.collaboration_name

BIX InterChange_Server_Adapter.adapter_name BIX_ADAPTER InterChange_Server_Adapter.adapter_name 1 Use a semicolon (;) to separate values in ITM_Key_Property and Comp_Format_Nm. Do not use a semicolon after the final value.

7.1.4 Attribute translation (table AttrTyp_Transl) MSrc_cd CHAR(3)

ITM_Attr_Property VARCHAR(254)

AttrTyp_Cd VARCHAR(17)

BIX InterChange_Server.Memory BIX_ICS_MEMORY

7.2 IBM Tivoli Monitoring resource models The following sections contain information in the IBM Tivoli Monitoring database that is used as the operational data source for Tivoli Enterprise Data Warehouse. For more information about resource models, see the IBM Tivoli Monitoring Workbench User's Guide.

7.2.1 Resource model for WebSphere InterChange Server ITM table name Column name Value

Instances1 Instance_Key VARCHAR(2096) ics_name=name

InterChange_Server.ics_name=name;InterChange_Server_Collaboration.collaboration_name=name;

InterChange_Server.ics_name=name;InterChange_Server_Adapter. adapter_name=name;

Categories Name VARCHAR(128) InterChange_Server.Memory

Resources Context VARCHAR(64) InterChange_Server


20

ITM table name Column name Value

InterChange_Server_Collaboration

InterChange_Server_Adapter

InterChange_Server_Status_Up

InterChange_Server_Status_Down

InterChange_Server_Status_Unknown

InterChange_Server_Memory_Free

InterChange_Server_Memory_Used

Percent_of_InterChange_Server_Memory_Free

Percent_of_InterChange_Server_Memory_Used

Consume_Operations

Events_Retrieved

Collaboration_Events_Processed

Collaboration_Events_Successful

Collaboration_Events_Failed

Collaboration_Events_Queued

Percent_of_Failed_Collaboration_Events

Percent_of_Successful_Collaboration_Events

Access_Events_Processed

Access_Events_Successful

Access_Events_Failed

Percent_of_Failed_Access_Events

Percent_of_Successful_Access_Events

Paused_Collaborations

Stopped_Collaborations

Metrics Name VARCHAR(128)

Paused_Adapters

1 Use a semicolon (;) to separate values within Instances. Put a semicolon after the last value.


21

8 Data mart schema information The following sections contain the definition of star schemas, metric dimension tables, data marts, and reports provided with the warehouse pack.

Shaded columns in the following tables are translated and are marked with an asterisk (*). Installing and Configuring Tivoli Enterprise Data Warehouse contains instructions for installing support for additional languages.

8.1 Star schemas Before using this section, read about the star schemas in Enabling an Application for Tivoli Enterprise Data Warehouse. That document defines the content of each table and explains the relationships between the tables in this document.

This warehouse pack provides the following star schemas.

8.1.1 BIX Hourly WebSphere InterChange Server Schema The following table defines the star schema. The description of the star schema is translated. Description of star schema (in IWH_STARSCHEMA) Hourly star schema

Name of fact table BIX.F_ICS_HOUR

Name of metric dimension table BIX.D_ICS_METRIC

BIX.D_BIX_HOST Names of other dimension tables

BIX.D_ICS

8.1.1.1 Fact table BIX.F_ICS_HOUR • Metric_ID INTEGER

• Host_ID INTEGER

• Comp_ID INTEGER

• Meas_hour TIMESTAMP

• Min_value DOUBLE

• Max_value DOUBLE

• Avg_value DOUBLE

• Total_value DOUBLE

• Sample_count INTEGER

8.1.2 BIX Daily WebSphere InterChange Server Schema The following table defines the star schema. The description of the star schema is translated. Description of star schema (in IWH_STARSCHEMA) Daily star schema

Name of fact table BIX.F_ICS_DAY



BIX.D_ICS


22

8.1.2.1 Fact table BIX.F_ICS_DAY • Metric_ID INTEGER

• Host_ID INTEGER

• Comp_ID INTEGER

• Meas_date TIMESTAMP






8.1.3 BIX Weekly WebSphere InterChange Server Schema The following table defines the star schema. The description of the star schema is translated. Description of star schema (in IWH_STARSCHEMA) Weekly star schema

Name of fact table BIX.F_ICS_WEEK



BIX.D_ICS

8.1.3.1 Fact table BIX.F_ICS_WEEK • Metric_ID INTEGER

• Host_ID INTEGER

• Comp_ID INTEGER







8.1.4 BIX Monthly WebSphere InterChange Server Schema The following table defines the star schema. The description of the star schema is translated. Description of star schema (in IWH_STARSCHEMA) Monthly star schema

Name of fact table BIX.F_ICS_MONTH



BIX.D_ICS


23

8.1.4.1 Fact table BIX.F_ICS_MONTH • Metric_ID INTEGER

• Host_ID INTEGER

• Comp_ID INTEGER







8.1.5 BIX Hourly WICS Adapter and Collaboration Schema The following table defines the star schema. The description of the star schema is translated. Description of star schema (in IWH_STARSCHEMA) Hourly star schema for WebSphere InterChange Server

Adapter and Collaboration

Name of fact table BIX.F_ICSCA_HOUR

Name of metric dimension table BIX.D_ICSCA_METRIC

BIX.D_BIX_HOST

BIX.D_ICS

Names of other dimension tables

BIX.D_ICSCA

8.1.5.1 Fact table BIX.F_ICSCA_HOUR • Metric_ID INTEGER

• Ca_ID INTEGER

• Host_ID INTEGER

• Comp_ID INTEGER

• Meas_hour TIMESTAMP






8.1.6 BIX Daily WICS Adapter and Collaboration Schema The following table defines the star schema. The description of the star schema is translated. Description of star schema (in IWH_STARSCHEMA) Daily star schema for WebSphere InterChange Server Adapter

and Collaboration

Name of fact table BIX.F_ICSCA_DAY


24

Description of star schema (in IWH_STARSCHEMA) Daily star schema for WebSphere InterChange Server Adapter and Collaboration


BIX.D_BIX_HOST

BIX.D_ICS


BIX.D_ICSCA

8.1.6.1 Fact table BIX.F_ICSCA_DAY • Metric_ID INTEGER

• Ca_ID INTEGER

• Host_ID INTEGER

• Comp_ID INTEGER







8.1.7 BIX Weekly WICS Adapter and Collaboration Schema The following table defines the star schema. The description of the star schema is translated. Description of star schema (in IWH_STARSCHEMA) Weekly star schema for WebSphere InterChange Server

Adapter and Collaboration

Name of fact table BIX.F_ICSCA_WEEK


BIX.D_BIX_HOST

BIX.D_ICS


BIX.D_ICSCA

8.1.7.1 Fact table BIX.F_ICSCA_WEEK • Metric_ID INTEGER

• Ca_ID INTEGER

• Host_ID INTEGER

• Comp_ID INTEGER







25


8.1.8 BIX Monthly WICS Adapter and Collaboration Schema The following table defines the star schema. The description of the star schema is translated. Description of star schema (in IWH_STARSCHEMA) Monthly star schema for WebSphere InterChange Server

Adapter and Collaboration Schema

Name of fact table BIX.F_ICSCA_MONTH


BIX.D_BIX_HOST

BIX.D_ICS


BIX.D_ICSCA

8.1.8.1 Fact table BIX.F_ICSCA_MONTH • Metric_ID INTEGER

• Ca_ID INTEGER

• Host_ID INTEGER

• Comp_ID INTEGER







8.2 Metric dimension tables This section describes the metric dimension tables used by the star schemas in this warehouse pack. Shaded columns indicate text that is translated. These column headings are also marked with an asterisk (*).

8.2.1 BIX.D_ICS_METRIC Metric_ID INTEGER

Met_category * VARCHAR(10)

Met_desc * VARCHAR(254)

Met_name * VARCHAR(120)

Met_units * VARCHAR(6)

Min_exists CHAR(1)

Max_exists CHAR(1)

Avg_exists CHAR(1)

Total exists CHAR(1)

Msrc_Nm* VARCHAR(6)

1 not used InterChange Server status up

InterChange_Server_Status_Up

PRC N N Y N BIX

8.2.2 BIX.D_ICSCA_METRIC Metric_ID INTEGER

Met_category * VARCHAR(10)

Met_desc * VARCHAR(254)

Met_name * VARCHAR(120)

Met_units * VARCHAR(6)

Min_exists CHAR(1)

Max_exists CHAR(1)

Avg_exists CHAR(1)

Total exists CHAR(1)

Msrc_Nm * VARCHAR(6)

1 not used Number of successful events by

Collaboration_Events_Successfu

QTY N N N Y BIX


26

Metric_ID Met_categ Met_desc Met_name Met_units Min_exists Max_exist Avg_exists Total Msrc_Nm INTEGER ory *

VARCHAR(10)

* VARCHAR(254)

* VARCHAR(120)

* VARCHAR(6)

CHAR(1) s CHAR(1)

CHAR(1) exists CHAR(1)

* VARCHAR(6)

collaborators

l

8.3 Dimension tables The following sections describe the dimension tables (other than metric dimension tables) used by the star schemas in this warehouse pack.

8.3.1 Dimension table BIX.D_ICS The following columns are used in this dimension table.

• comp_id

• ics_name

• ics_memory

• attr_start_dttm

8.3.2 Dimension table BIX.D_ICSCA The following columns are used in this dimension table.

• ca_id

• ca_name

8.4 Data marts and reports This warehouse pack provides the following data marts.

8.4.1 WebSphere InterChange Server data mart This data mart uses the following star schemas:

• Hourly star schema for WebSphere InterChange Server

• Daily star schema for WebSphere InterChange Server

• Weekly star schema for WebSphere InterChange Server

• Monthly star schema for WebSphere InterChange Server

8.4.2 WICS Adapter and Collaboration data mart This data mart uses the following star schemas:

• Hourly star schema for WICS Adapter and Collaboration

• Daily star schema for WICS Adapter and Collaboration

• Weekly star schema for WICS Adapter and Collaboration

• Monthly star schema for WICS Adapter and Collaboration

8.4.3 Reports This data mart provides the following prepackaged reports.


27

8.4.3.1 BIX Availability Status for InterChange Servers This summary report shows the average percent in all states (up, down, and unknown) for all WebSphere InterChange Servers grouped by host and InterChange Server.

Group by: (1) host name (BIX.D_BIX_HOST.HOST_NAME)

(2) InterChange Server name (BIX.D_ICS.ICS_NAME)

Metrics: InterChange_Server_Status_Up, InterChange_Server_Status_Down, InterChange_Server_Status_Unknown

Star schema tables: BIX Daily WebSphere InterChange Server Schema

Start or end time: Last 7 days from current date or time

8.4.3.2 BIX Event Throughput for InterChange Servers This extreme case report shows the collaborations with the highest percent of successful events.

Group by: (1) host name (BIX.D_BIX_HOST.HOST_NAME (2) InterChange Server name (BIX.D_ICS.ICS_NAME) (3) collaboration name (BIX.D_BIX_ICSCA.CA_NAME)

Metric: Percent_of_Successful_Collaboration_Events Star schema tables: BIX Daily WICS Adapter and Collaboration Schema Start or end time: Last 7 days from current date or time

8.4.3.3 BIX Access Throughput for InterChange Servers This extreme case report shows the adapters with the highest percent of successful access events.

Group by: (1) host name (BIX.D_BIX_HOST.HOST_NAME)

(2) InterChange Server name (BIX.D_ICS.ICS_NAME)

(3) adapter name (BIX.D_BIX_ICSCA.CA_NAME)

Metric: Percent_of_Successful_Access_Events

Star schema tables: BIX Daily WICS Adapter and Collaboration Schema


8.4.3.4 BIX Memory Usage for InterChange Servers This extreme case report shows the average percent of memory used by all WebSphere InterChange Servers.

Group by: (1) InterChange Server name (BIX.D_ICS.ICS_NAME)

(2) ) host name (BIX.D_BIX_HOST.HOST_NAME)

Metric: Percent_of_InterChange_Server_Memory_Used



8.4.3.5 BIX Collaboration Status for InterChange Servers This summary report shows the number of collaborations in each non-running state (paused, stopped, or congested).

Group by: (1) host name (BIX.D_BIX_HOST.HOST_NAME) (2) InterChange Server name (BIX.D_ICS.ICS_NAME)

Metric: Paused_Collaborations, Stopped_Collaborations, Congested_Collaborations


28



8.4.3.6 BIX Adapter Status for InterChange Servers This summary report shows the number of adapters in each non-running state (paused or stopped).

Group by: (1) host name (BIX.D_BIX_HOST.HOST_NAME) (2) InterChange Server name (BIX.D_ICS.ICS_NAME)

Metric: Paused_Adapters, Stopped_ Adapters




29

Notices This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other 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. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan 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 might 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 the 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:

IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 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.


30

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 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.

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

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples 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.

If you are viewing this information in softcopy form, the photographs and color illustrations might not appear.

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

IBM, the IBM logo, AIX, CrossWorlds, CrossWorlds Software, DB2, DB2 Universal Database, IBMLink, Informix, MQSeries, NetView, OS/2, OS/400, Tivoli, the Tivoli logo, Tivoli Enterprise Console, TME, WebSphere, and z/OS are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Other company, product, and service names may be trademarks or service marks of others.


31

Printed in U.SA.


32

Documents

IBM Tivoli Monitoring for Business Integration: WebSphere ...publib.boulder.ibm.com/tividd/td/ITMBI/SC32-1406... · IBM Tivoli Monitoring for Business Integration: WebSphere InterChange