You are on page 1of 179

Reporting User Guide

Version 1.1

June 9, 2000

Copyright 2000 BMC Software, Inc., as an unpublished work. All rights reserved. BMC Software, the BMC Software logos, and all other BMC Software product or service names are registered trademarks or trademarks of BMC Software, Inc. IBM and DB2 are registered trademarks of International Business Machines Corp.; Oracle is a registered trademark, and the Oracle product names are registered trademarks or trademarks of Oracle Corp. Actuate is a registered trademark, and the Actuate product names are registered trademarks or trademarks of Actuate Corporation. All other registered trademarks or trademarks belong to their respective companies.

Restricted Rights Legend


U.S. GOVERNMENT RESTRICTED RIGHTS. UNPUBLISHEDRIGHTS RESERVED UNDER THE COPYRIGHT LAWS OF THE UNITED STATES. Use, duplication, or disclosure by the U.S. Government is subject to restrictions set forth in FAR Section 52.227-14 Alt. III (g)(3), FAR Section 52.227-19, DFARS 252.227-7014 (b), or DFARS 227.7202, as amended from time to time. Send any contract notices to Contractor/Manufacturer: BMC Software, Inc. 2101 CityWest Blvd. Houston TX 77042-2827 USA

Contacting BMC Software


You can access the BMC Software Web site at http://www.bmc.com. From this Web site, you can obtain general information about the company, its products, special events, and career opportunities. For a complete list of all BMC Software ofces and locations, go to http://www.bmc.com/corporate/ofces.html.

USA and Canada


Address BMC Software, Inc. 2101 CityWest Blvd. Houston TX 77042-2827 713 918 8800 or 800 841 2031 713 918 8000

Outside USA and Canada


Telephone Fax (01) 713 918 8800 (01) 713 918 8000

Telephone Fax

Customer Support
You can obtain technical support by using Response Online (support from the Web) or Response On Demand. To expedite your inquiry, please see Before Contacting BMC Software, below.

Response Online
You can obtain technical support from BMC Software 24 hours a day, seven days a week by accessing the technical support Web site at http://www.bmc.com/support.html. From this site, you can read overviews about support services and programs that BMC Software offers nd the most current information about BMC Software products search a database for problems similar to yours and possible solutions order or download product documentation report a problem or ask a question subscribe to receive e-mail notices when new product versions are released nd worldwide BMC Software support center locations and contact information, including e-mail addresses, fax numbers, and telephone numbers

Response On Demand
In the USA and Canada, if you need technical support and do not have access to the Web, call 800 537 1813. Outside the USA and Canada, please contact your local support center or your local sales ofce for assistance.

Before Contacting BMC Software


Before you contact BMC Software, have the following information available so that a technical support analyst can begin working on your problem immediately: product information product name product version (release number) license number and password (trial or permanent)

operating-system and environment information machine type operating system type, version, and service pack or program temporary x (PTF) system hardware conguration serial numbers related software (database, application, and communication) including type, version, and service pack or PTF

sequence of events leading to the problem commands and options that you used messages received (and the time and date that you received them) product error messages messages from the operating system, such as file system full messages from related software

BMC Software, Inc., Condential and Proprietary Information

iii

BMC Software, Inc., Condential and Proprietary Information

iv

Reporting User Guide

Contents

Contents
About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Chapter 1 Introducing Reporting

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Checking Reporting System Components . . . . . . . . . . . . . . . . . . . . . 1-3 QuickReport Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Solution Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Report Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 Report Encyclopedia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5 Report Viewers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5 Looking at the Integrated Application . . . . . . . . . . . . . . . . . . . . . . . . 1-6 Providing the Data for Reporting . . . . . . . . . . . . . . . . . . . . . . . . 1-6 Understanding Basic Reporting Concepts . . . . . . . . . . . . . . . . . . . . . 1-7 Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7 QuickReports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7 Solution Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7 Report Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7
Chapter 2 Introducing the Reporting Tools

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Understanding Reporting Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Web Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 QuickReport Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 Actuate Desktop Applications . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 Using the Web Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5 Accessing the Report Encyclopedia . . . . . . . . . . . . . . . . . . . . . . 2-5 Using the Report Encyclopedia . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6 Looking at the Report Encyclopedia using the Web Desktop . . . 2-7
BMC Software, Inc., Condential and Proprietary Information

Contents

Navigating the Report Encyclopedia with the Web Desktop . . .2-9 Navigating in the Report Encyclopedia . . . . . . . . . . . . . . . . . . . .2-11
Chapter 3 Planning Your Reporting Strategy

Introducing Report Types and Templates . . . . . . . . . . . . . . . . . . . . . .3-2 Describing QuickReport Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-2 Planning QuickReports Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . .3-4 QuickReports Reporting Checklist . . . . . . . . . . . . . . . . . . . . . . .3-4 Example: Locating Servers with the Least Available Space . . . .3-5 Example: Examining Servers with Highest CPU Usage . . . . . . .3-7 Example: Finding Server Hot Spots . . . . . . . . . . . . . . . . . . . . . .3-10 Example: Verifying Parameter Collection . . . . . . . . . . . . . . . . . .3-13 Using Solution-Specic Reporting . . . . . . . . . . . . . . . . . . . . . . . . . .3-15 Solution Reporting Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . .3-16 Example: Selecting Windows NT Servers for Upgrading . . . . . .3-16 Example: Locating Heavily Used Unix Servers . . . . . . . . . . . . .3-17 Planning Strategies for Mixing Reporting Types . . . . . . . . . . . . . . . .3-17 Mixing Reporting Types Checklist . . . . . . . . . . . . . . . . . . . . . . .3-17 Example: Getting a Picture of the Enterprise . . . . . . . . . . . . . . .3-18
Chapter 4 Creating, Scheduling, Viewing, and Printing Reports

Creating Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-2 Creating a New Report Template with the QuickReport Editor .4-2 Creating a New Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-3 Editing a Report Template with the QuickReport Editor . . . . . .4-12 Editing an Existing Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-13 Deleting a QuickReport Template that you Created . . . . . . . . . .4-16 Deleting a Template with the QuickReport Editor . . . . . . . . . . .4-17 Scheduling and Generating Reports . . . . . . . . . . . . . . . . . . . . . . . . . .4-19 Scheduling QuickReports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-19 Scheduling a QuickReport Template . . . . . . . . . . . . . . . . . . . . . .4-20 Generating Solution Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-23 Generating a Solution Report . . . . . . . . . . . . . . . . . . . . . . . . . . .4-24 Locating and Viewing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-28 Locating and Viewing QuickReports . . . . . . . . . . . . . . . . . . . . .4-29 Viewing a QuickReport from the Report Encyclopedia . . . . . . .4-30 Locating and Viewing a Solution Report . . . . . . . . . . . . . . . . . .4-30 Viewing a Solution Report from the Report Encyclopedia . . . . .4-31 Printing and Distributing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . .4-31 Printing a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-32
BMC Software, Inc., Condential and Proprietary Information

vi

Reporting User Guide

Printing Reports from the Report Encyclopedia . . . . . . . . . . . . . 4-33


Chapter 5 Working with QuickReports

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2 Describing QuickReport Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2 Interpreting QuickReports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3 Looking at Summary Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3 Looking at Hot Spots Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5 Looking at Data Collection Tables . . . . . . . . . . . . . . . . . . . . . . . 5-6 Summarizing Enterprise Events and Measurements . . . . . . . . . . . . . 5-7 Taking a Closer Look at Enterprise Measurements . . . . . . . . . . . . . . 5-10 Locating Enterprise Hot Spots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15 Checking Database Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
Chapter 6 Working with Solution Reports for Microsoft Windows 2000 Server

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2 Dening Windows Server Status Reports . . . . . . . . . . . . . . . . . . . . . 6-3 Dening Windows Server Parameter Reports . . . . . . . . . . . . . . . . . . 6-3 Describing Server Cache Parameter Reports . . . . . . . . . . . . . . . 6-4 Describing Server CPU Parameter Reports . . . . . . . . . . . . . . . . 6-4 Describing Server Logical Disk Parameter Reports . . . . . . . . . . 6-5 Describing Server Memory Parameter Reports . . . . . . . . . . . . . 6-6 Dening Windows Server Service Availability Reports . . . . . . . . . . 6-7 Interpreting Windows Server Solution Reports . . . . . . . . . . . . . . . . . 6-9 Looking at Summary Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9 Looking at Trend Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10
Chapter 7 Working with Solution Reports for Unix

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2 Dening Unix Status and Availability Reports . . . . . . . . . . . . . . . . . 7-2 Dening Unix Performance Reports . . . . . . . . . . . . . . . . . . . . . . . . . 7-4 Dening Unix Capacity and Utilization Reports . . . . . . . . . . . . . . . . 7-5 Interpreting Solution Reports for Unix . . . . . . . . . . . . . . . . . . . . . . . 7-7 Looking at Summary Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-7 Looking at Summary Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8 Looking at Trend Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9
Chapter 8 Working with Solution Reports for Microsoft Exchange Server

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2 Dening Microsoft Exchange Server Availability Reports . . . . . . . . 8-2


BMC Software, Inc., Condential and Proprietary Information

Contents

vii

Dening Microsoft Exchange Server Performance Reports . . . . . . .8-3 Dening Microsoft Exchange Server Capacity or Usage Reports . . .8-4 Interpreting Solution Reports for Microsoft Exchange . . . . . . . . . . .8-7 Looking at Summary Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-8 Looking at Trend Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-9
Chapter 9 Working with Solution Reports for Oracle

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-2 Dening Oracle Availability Reports . . . . . . . . . . . . . . . . . . . . . . . . .9-3 Dening Oracle Performance Reports . . . . . . . . . . . . . . . . . . . . . . . .9-4 Oracle SGA Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-5 Dening Oracle Capacity Reports . . . . . . . . . . . . . . . . . . . . . . . . . . .9-6 Interpreting Solution Reports for Oracle . . . . . . . . . . . . . . . . . . . . . .9-7 Looking at Trend Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-7 Looking at Summary Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-9
Glossary Index

BMC Software, Inc., Condential and Proprietary Information

viii

Reporting User Guide

About

About This Book


This book contains detailed information about the reporting side of Service Reporting, and is intended for anyone who creates, views, or distributes reports for the management of enterprise resources.
Note

This book assumes that you are familiar with your host operating system. You should know how to perform basic actions in a window environment, such as choosing menu commands and dragging and dropping icons.

BMC Software, Inc., Condential and Proprietary Information

ix

Related Documentation
BMC Software products offer several types of documentation: online and printed books online Help release notes

In addition to this book and the online Help, you can nd useful information in the publications listed in the following table. As Actuate Software Corporation Documentation on page xi explains, these publications are available on request from BMC Software.
Category
Installation documents Core documentation

Document
Service Reporting Getting Started Guide DataStore Administrator Guide Reporting User Guide

Description
contains the installation and basic conguration instructions for Service Reporting provides instructions for using DataStore and the DataStore Console provides instructions for creating, analyzing, viewing, and distributing enterprise-wide reports contain the latest updates to Service Reporting products

Release Notes

Service Reporting Release Notes

BMC Software also provides documentation for the Actuate Software Corporation components of Service Reporting.

BMC Software, Inc., Condential and Proprietary Information

Reporting User Guide

Actuate Software Corporation Documentation


Document
Actuate e.Reporting Suite 4 Release Notes

Description
describes new features, identies known limitations, and lists customer-reported defects that have been xed provides information about managing users, groups, roles, privileges, printers, process groups, and print requests describes the tasks you can perform with reports that have been designed, compiled, and generatedincludes using e.reports on the Web or a desktop, viewing and running a report, searching for and exporting data, printing and distributing a report describes the tasks you can perform using the Actuate Viewerincludes the same topics as Using e.Reports except for running a report describes the tasks you can perform using Microsoft Internet Explorer in combination with the Actuate LRX describes the tasks you can perform using Netscape Navigator in combination with the Actuate LRX

File Name
readme.pdf

Size
51 KB

Administering the Report Encyclopedia

admin-report-encycolpedia.pdf

2,744 KB

Using e.Reports

using-ereports.pdf

4,331 KB

Viewing e.Reports

viewing-ereports.pdf

3,791 KB

LRX for Microsoft Internet Explorer

lrx-microsoft.pdf

3,153 KB

LRX for Netscape Navigator

lrx-netscape.pdf

3,163 KB

BMC Software, Inc., Condential and Proprietary Information

xi

Document
Building an e.Reporting Web Site

Description
provides information on accessing the Actuate Report Encyclopedia on the World Wide Web provides information about managing the interaction between client and server to enable activities such as scheduling and running reports

File Name
reportcast.pdf

Size
3,456 KB

e.Reporting Server Guide

ereporting-server.pdf

2,548 KB

Online and Printed Books


The books that accompany BMC Software products are available in online format and printed format. You can view online books with Acrobat Reader from Adobe Systems. The reader is provided at no cost, as explained in To Access Online Books. You can also obtain additional printed books from BMC Software, as explained in To Request Additional Printed Books.
To Access Online Books

Online books are formatted as Portable Document Format (PDF) files. You can view them, print them, or copy them to your computer by using Acrobat Reader 3.0 or later. You can access online books from the documentation compact disc (CD) that accompanies your product or from the World Wide Web. In some cases, installation of Acrobat Reader and downloading the online books is an optional part of the product-installation process. For information about downloading the free reader from the Web, go to the Adobe Systems site at http://www.adobe.com. To view any online book that BMC Software offers, visit the support page of the BMC Software Web site at http://www.bmc.com/support.html. Log on and select a product to access the related documentation. (To log on, first-time users can

BMC Software, Inc., Condential and Proprietary Information

xii

Reporting User Guide

request a user name and password by registering at the support page or by contacting a BMC Software sales representative.)
To Request Additional Printed Books

BMC Software provides a core set of printed books with your product order. To request additional books, go to http://www.bmc.com/support.html.

Online Help
You can access Help for a product through the products Help menu. The online Help provides information about the products graphical user interface (GUI) and provides instructions for completing tasks.

Release Notes
Printed release notes accompany each BMC Software product. Release notes provide up-to-date information such as summary of new features updates to the installation instructions last-minute product information listing of the related documentation

The latest versions of the release notes are also available on the Web at http://www.bmc.com/support.html.

BMC Software, Inc., Condential and Proprietary Information

xiii

Conventions
The following conventions are used in this book: This book includes special elements called notes, warnings, examples, tips, and see online help:
Note

Notes provide additional information about the current subject.


Warning

Warnings alert you to situations that can cause problems, such as loss of data, if you do not follow instructions carefully.

Example

An example claries a concept discussed in text.

Tip

A tip provides useful information that may improve product performance or make procedures easier to follow. Directs you to product Online Help for information to supplement the printed documentation. The symbol => connects items in a menu sequence. For example, Actions => Create Test instructs you to choose the Create Test command from the Actions menu.

BMC Software, Inc., Condential and Proprietary Information

xiv

Reporting User Guide

Introducing Reporting

This chapter provides information on using the reporting components of Service Reporting and describes how the reporting components relate to the other components of the Service Reporting product. Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Checking Reporting System Components . . . . . . . . . . . . . . . . . . . . . 1-3 Looking at the Integrated Application . . . . . . . . . . . . . . . . . . . . . . . . 1-6 Understanding Basic Reporting Concepts . . . . . . . . . . . . . . . . . . . . . 1-7

BMC Software, Inc., Condential and Proprietary Information

Introducing Reporting

1-1

Overview
Reporting is the part of Service Reporting that provides report creation and viewing facilities. The Service Reporting system allows users to generate, view, distribute, and manage reports. Service Reportings report creation and viewing tool provides predened (Solution Reports) and user-dened (QuickReports) reports. You can use any combination of Solution Reports or QuickReports to look at information from different points of view. Key features and benets of Service Reporting include: An enterprise-scale perspective of systems management Easy report creation Report scheduling options for proactive, exception-based management Quick identication of problem sources through summary and detailed information Easy access to system management information through the Web Enhanced system management productivity through broad-based exception reporting Diagnosis of complex problems through historical insight on similar problems and related symptoms

BMC Software, Inc., Condential and Proprietary Information

1-2

Reporting User Guide

Checking Reporting System Components


The reporting system is based on a Report Server, which generates reports using data from the DataStore, and communicates with clients for report viewing. Reporting consists of components developed by BMC Software and Actuate Software Corporation. BMC Software components: QuickReport Editor Solution Reports (predened report templates)

Actuate Software Corporation components: Report Server Report Encyclopedia Report viewers

QuickReport Editor
The QuickReport Editor allows you to dene new report templates based on specic PATROL parameters and events, to copy and modify report templates, and to delete report templates. The QuickReport Editor is part of a Web-based graphical user interface (GUI), the Web Desktop. You use the QuickReport Editor to create reports from user-dened templates.

Solution Reports
Solution Reports are predened reports created for the management of a specic technology or application. These reports require little or no user setup. Solution Reports might provide information on service management, enterprise resource management, or on other requirements specic to the management of a particular application or technology.

BMC Software, Inc., Condential and Proprietary Information

Introducing Reporting

1-3

These reports consist of a set of pre-dened reports for specic operating systems and applications. The basic operating system (OS) report packages, are shipped as part of Service Reporting. The basic Solution Reports for Service Reporting are: Solution Reports for Microsoft Windows 2000 Server - used to view Windows 2000 and Windows NT measurements across your enterprise Solution Reports for Unix - used to view Unix measurements across your enterprise

Other Solution Reports are available as optional packages specic to a given application, for example: Solution Reports for Microsoft Exchange Server Solution Reports for Oracle

Report Server
The Report Server is the central point for creating and managing reports. From the Report Server, you can: generate on-demand or scheduled reports print reports manage report documents and folders manage users and roles validate users and requests for on-demand reports with run-time parameters

The Actuate Administrator Desktop is the interface for managing report server users and reports. For information on using the Actuate Administrator Desktop, refer to the Actuate documentation.

BMC Software, Inc., Condential and Proprietary Information

1-4

Reporting User Guide

Report Encyclopedia
The Report Encyclopedia is an online storage area for Actuate information that relates to reporting. Information in the Report Encyclopedia is organized into the following directories: administrative directory - stores users, roles, and privileges information requests and scheduling directory - contains active and scheduled requests for report generation report item directory - includes report templates, executables, parameters, and generated reports

You can access a Report Encyclopedia remotely by using a Web-based graphical user interface (GUI), the Web Desktop. For information on how to access and move through the Report Encyclopedia, see Accessing the Report Encyclopedia on page 2-5 and Navigating the Report Encyclopedia with the Web Desktop on page 2-9.

Report Viewers
You can review reports using several applications. BMC Software recommends the use of your Web browser, referred to as the Web Desktop. With a Web browser, you can generate, schedule, view, and print reports. You access the Report Encyclopedia remotely by entering a URL in a Web browser on a supported system. For information on how to access reports through the Web and navigate the Report Encyclopedia, see Using the Web Desktop on page 2-5. You can also use the following Windows applications to view reports: Actuate End User Desktopuse to request immediate report generation, for local report viewing, and for local printing Actuate Administrator Desktopuse to schedule report generation, for local report viewing, and for local printing

BMC Software, Inc., Condential and Proprietary Information

Introducing Reporting

1-5

Actuate Viewer use to view and print on Windows NT only

For information on the Actuate Windows applications, refer to Viewing e.Reports, Using e.Reports, or the respective applications online help.

Looking at the Integrated Application


The Service Reporting application provides the components needed to: collect data summarize data store data create reports using the stored and summarized data store reports and report templates manage stored reports generate reports on demand and on a scheduled basis view reports

The following sections show how the major components of Service Reporting work together to provide an environment to enhance your enterprise reporting capabilities.

Providing the Data for Reporting


Effective reporting depends on the collection and availability of pertinent information in an appropriate format. Service Reporting is an integrated product that not only provides the means to create, view and distribute data, but also includes components for data collection and storage. Retrievers and aggregators are responsible for collecting data and pushing information into the database. DataStore provides the database to store the collected data.

See the DataStore Administrator Guide for more information on collectors, aggregators, and DataStore.

BMC Software, Inc., Condential and Proprietary Information

1-6

Reporting User Guide

Understanding Basic Reporting Concepts


This section reviews basic concepts and terminology relating to the reporting piece of Service Reporting.

Reports
Reports are generated presentations (graphs, tables, or charts) based on stored PATROL event and parameter data that you can view remotely using a Web browser on supported platforms.

QuickReports
QuickReports are reports created from user-dened templates. The reports (graph, table, or chart) are created when you specify parameters, selection criteria, labels, and scheduling options using the QuickReport Editor.

Solution Reports
Solution Reports are packages of reports created for the management of a particular technology or application. The Solution Reports require little or no user setup.

Report Templates
Report templates are denitions for Service Reporting that direct the extraction of data from the DataStore for a given time span and generate a presentation in the form of a graph, table, or chart.

BMC Software, Inc., Condential and Proprietary Information

Introducing Reporting

1-7

BMC Software, Inc., Condential and Proprietary Information

1-8

Reporting User Guide

Introducing the Reporting Tools


This chapter describes the reporting tools that you use to create, schedule, view, and print reports.

Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Understanding Reporting Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Using the Web Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5

BMC Software, Inc., Condential and Proprietary Information

Introducing the Reporting Tools

2-1

Overview
Service Reporting lets you create, schedule, view, and print reports, as well as manage report users and report storage. BMC Software provides several tools to accomplish many of these reporting tasks depending on your requirements. Will you create reports? Are you interested in viewing and printing reports? Will you manage report storage?
Table 2-1 Overview of Reporting Tasks and Tools

Task
creating a report template modifying a report template scheduling a report to run now

Tools to Use
QuickReport Editor QuickReport Editor QuickReport Editor Web Desktop Actuate End User Desktop Actuate Administrator Desktop QuickReport Editor Web Desktop Actuate End User Desktop Actuate Administrator Desktop Web Desktop Report Viewer Actuate End User Desktop Actuate Administrator Desktop Web Desktop Report Viewer Actuate End User Desktop Actuate Administrator Desktop Actuate Administrator Desktop

scheduling a report to run once or at specic times.

viewing a report

printing a report

setting up privileges to view reports

Understanding Reporting Tools


Service Reporting tools includes applications developed by BMC Software and Actuate Software Corporation. The tools you use to create, schedule, view, and print reports include:
2-2 Reporting User Guide

Web Desktop (recommended application)


BMC Software, Inc., Condential and Proprietary Information

QuickReport Editor Actuate Report Viewer (view and print only) Actuate End User Desktop Actuate Administrator Desktop

Web Desktop
You use the Web Desktop to view the contents of the Report Encyclopedia generate and schedule reports locate and view reports print and distribute reports Access the QuickReport Editor

You access the Web Desktop from a Web browser on a supported system. For information on how to access the Web Desktop and navigate through the Report Encyclopedia, see Using the Web Desktop on page 2-5.

QuickReport Editor
You use the QuickReport Editor to create reports by dening new report templates based on specic PATROL parameters and events copy and modify report templates delete report templates

Actuate Desktop Applications


The Actuate desktop applications include the Report Viewer, the Actuate End User Desktop, and the Actuate Administrator Desktop.

BMC Software, Inc., Condential and Proprietary Information

Introducing the Reporting Tools

2-3

Report Viewer

You can use the Report Viewer to view and print reports on Windows machines. For information on how to use the Report Viewer application, refer to Viewing e.Reports or the Report Viewer online help.
Actuate End User Desktop

You can use the Actuate End User Desktop to do the following on Windows machines: request immediate report generation view reports print reports

For information on how to use the Actuate End User Desktop application, refer to Viewing e.Reports, Using e.Reports, or the Actuate End User Desktop online help.
Actuate Administrator Desktop

You can use the Actuate Administrator Desktop to do the following on Windows machines: schedule report generation view reports locally print reports locally

For information on how to use the Actuate Administrator Desktop application, refer to Viewing e.Reports, Using e.Reports, or the Actuate Administrator Desktop online help.

BMC Software, Inc., Condential and Proprietary Information

2-4

Reporting User Guide

Using the Web Desktop


For report viewing and on-demand generation of reports, BMC Software recommends that you use the Web Desktop. Refer to Actuate Desktop Applications on page 2-3 for a brief description of other applications that you can use to generate and view reports. This section tells you: how to access the Report Encyclopedia how to use the Report Encyclopedia

Accessing the Report Encyclopedia


Using the Actuate Report Server and a Web server, you can access the Report Encyclopedia features of Service Reporting using a Web browser. To access the Report Encyclopedia Web page you need one of the following Web browsers: Microsoft Internet Explorer, version 4.0 or later Netscape Navigator, version 4.0 or later
Note

The QuickReport Editor, a Java-based application where you can dene and adjust reports, requires Microsoft Internet Explorer, version 5.0 or later, with the Java Virtual Machine installed or Netscape Navigator with the Java plug-in.

BMC Software, Inc., Condential and Proprietary Information

Introducing the Reporting Tools

2-5

Using the Report Encyclopedia Summary:


This task describes how to access the Report Encyclopedia from your Web browser. Open your Web browser and type the following URL:
http://<Web server>/acweb/<report server>

Step 1

<Web server> is the name of the Web server that is running the Web interface to the Report Encyclopedia acweb is a keyword that is associated with the Report Encyclopedia <report server> is the name of the volume of the Report Server where the Encyclopedia that you want to access is located For example, to access reports from volume jsmith on Web server jsmith, you enter the following URL in your Web browser:
http://jsmith/acweb/jsmith

The Enter Network Password dialog box displays.


Figure 2-1 Enter Network Password Dialog Box

Step 2

Enter the user name and password provided by your administrator. The Web Desktop appears.
BMC Software, Inc., Condential and Proprietary Information

2-6

Reporting User Guide

Looking at the Report Encyclopedia using the Web Desktop


The Report Encyclopedia is an online storage area for your generated reports and report templates. The Report Encyclopedia also contains an administrative directory and requests and scheduling directories.
Note

You must have Actuate administrator privileges to access the administrative directory. Contact your administrator for more information.
Figure 2-2 Report Encyclopedia Web Page
Current folder Tab pages

Reporting and Actuate Help

The Report Encyclopedia Web page lets you: view the contents of the Report Encyclopedia access the Report Encyclopedia hierarchy get detailed information about reports sort the folders by name, type, or date and time created check on active and scheduled requests access your completed reports folder using My Headlines request to generate a report using the QuickReport Editor

BMC Software, Inc., Condential and Proprietary Information

Introducing the Reporting Tools

2-7

Using Tab Pages

The Report Encyclopedias tab pages let you access additional functionality.
Table 2-2 Report Encyclopedia Tab Pages

Description
Documents

Files and Folders Accessed


Lets you access the Solution Reports. You might also see the personal folders of another person if they gave you access to them. A list of completed reports including requests that you submitted and reports that other people requested be sent to you. Provides access to the QuickReport Editor link. You can also set up personal channels. For more information about channels and how to subscribe to a channel, refer to Using the Actuate Web Agent or the Web Agent online documentation. Lets you see a list of reports that are ready for execution or are scheduled to execute at a certain time. Allows you to control and administer the Web Desktop. Allows you to change your password and view your preferences.

My Headlines

Requests

Administration My Prole

Using the Documents Tab Work Area

The Report Encyclopedias work area, located by clicking the Documents tab, lists the available reports and folders you can explore. When you select a report, each report contains the date of the report, the time it was created, and a Details icon containing additional information about each le.
Note

You can click the Details icon to get general status and privileges information for the folder or le.

BMC Software, Inc., Condential and Proprietary Information

2-8

Reporting User Guide

Table 2-3 describes the components of the Report Encyclopedia Web page.
Table 2-3 Report Encyclopedia Components

Component
Name Version Date Details

Description
The Name column contains the list of available reports. The Version shows the version of the report that is available. The Date column contains the date that the administrator or user created the folder or le. The Details column contains status and other information for the associated folder or le, including the name of the log le.

Additional links: QuickReport EditorUse to create custom reports HelpClick to view the Reporting Online Help and the Actuate ReportCast Online Documentation My DocumentsClick to view the ReportCast Channels Personal Channel Page

Navigating the Report Encyclopedia with the Web Desktop


Before using the Web Desktop to explore the Report Encyclopedia, check with your administrator to nd out if you can access reports on the Web.
Tip

If your administrator set up an anonymous user, you can access the Report Encyclopedia without logging in. To view reports, however, you need to log in using the name and password provided to you by your administrator.

BMC Software, Inc., Condential and Proprietary Information

Introducing the Reporting Tools

2-9

You can navigate the Report Encyclopedia just like any other Web site. Just enter a URL, click the available hyperlinks, or use the Tab pages to see the information youre looking for. After clicking the BMCReports link, some of the report types you may be able to view include: Daily Reports Weekly Reports Monthly Reports Yearly Reports ROX & ROV Objects/OnDemand Reports NT Unix Exchange Oracle Cleanup

Some of the top-level hyperlinks that may appear:


,

Table 2-4

Report Encyclopedia Top-Level Hyperlinks

Hyperlinks (Folder)
BMCReports Exchange Windows NT Oracle Unix

Links to
QuickReports, ROV les, and ROX les Solution Reports for Microsoft Exchange Server, ROV les, and ROX les Solution Reports for Microsoft Windows 2000 Server, ROV les, and ROX les Solution Reports for Oracle, ROV les, and ROX les Solution Reports for Unix, ROV les, and ROX les

Navigating from Top Folders to Report Documents

Navigating in the Report Encyclopedia on page 2-11 provides an example of using hyperlinks to navigate from a top-level folder to a subfolder that contains a Report Document that you can view.

BMC Software, Inc., Condential and Proprietary Information

2-10

Reporting User Guide

Navigating in the Report Encyclopedia Summary:


Step 1

This task describes how to navigate in the Report Encyclopedia. Log in to the Report Encyclopedia (refer to Using the Report Encyclopedia on page 2-6). The Report Encyclopedia main page displays to show the top-level folders. On the Report Encyclopedia main page, click a folders link (BMCReports) to display its available reports. The available report types appear on the left side of your browser. In the subfolder, click a link to display its contents.
Note

Step 2

Step 3

You can click Back in the browsers main toolbar to return to the Report Encyclopedias main page. Alternatively, you can click the link to the folder or subfolder located above the list of contents.
Step 4

In the Report Encyclopedia, you can continue to click hyperlinks to explore the folders and les of the Report Encyclopedia.

Navigating the Reports

BMC Software provides a top-level folder, BMCReports, for access to both the QuickReports you create with the QuickReport Editor and the technology and application Solution Reports packages that came with Service Reporting. Click a link to navigate the folders and subfolders to locate a document that you can view.

BMC Software, Inc., Condential and Proprietary Information

Introducing the Reporting Tools

2-11

BMC Software, Inc., Condential and Proprietary Information

2-12

Reporting User Guide

Planning Your Reporting Strategy

This chapter describes the QuickReports and Solution Reports, proposes reporting checklists, and provides some examples that might help you plan a reporting strategy to manage resources in your distributed environment. You need to determine what reports you need and who needs to access these reports. Introducing Report Types and Templates . . . . . . . . . . . . . . . . . . . . . . 3-2 Planning QuickReports Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4 Using Solution-Specic Reporting. . . . . . . . . . . . . . . . . . . . . . . . . . . 3-15 Planning Strategies for Mixing Reporting Types . . . . . . . . . . . . . . . . 3-17

BMC Software, Inc., Condential and Proprietary Information

Planning Your Reporting Strategy

3-1

Introducing Report Types and Templates


Service Reporting reports are based on report templates. Service Reporting provides predened report templates for specic technologies or applications and QuickReport types that you can customize to create new report templates to meet your enterprise reporting requirements. QuickReport types are a class of report templates. Report templates are denitions that direct Service Reporting to extract data from the DataStore for a given time span and to generate a presentation in the form of a graph, table, or chart.

Describing QuickReport Types


A QuickReport type is a general class of report templates that you can use to dene a new report template. To dene a new report template, you ll in values in a form, based on the selection of a QuickReport type.
Table 3-1 QuickReport Types (Part 1 of 2)

Report Types
Data Collection Table Hot Spots Table

Description
Lists all of the components, measurements, and event types collected in the DataStore database. Provides the measurement value of a particular enterprise component for a specied time span of the report and lists the top n or bottom n readings for a measurement or parameter. Given a PATROL parameter, list n component values where the user-specied threshold was crossed. The time span is specied by the user. Displays a customer-dened number of components and their associated events. Displays n number of components with the highest or lowest values of a parameter in bar graph format. Displays n number of components and their associated parameter values, in table format. Displays a measurement value of a set of components representing a specic time period. The time span is specied by the user.

Hot Spots Threshold Table Event Summary Table Summary Graph Summary Table Trend Graph

BMC Software, Inc., Condential and Proprietary Information

3-2

Reporting User Guide

Table 3-1

QuickReport Types (Part 2 of 2)

Report Types
Trend Graph (Multi-Parameter) Trend Table Trend Table (Multi-Parameter)

Description
Displays multiple measurements for multiple components representing a specic time period. The time span is specied by the user. Displays the measurement value of a set of components representing a specic time period, in table format. The time span is specied by the user. Displays multiple measurements for multiple components representing a specic time period. The time span is specied by the user.

BMC Software, Inc., Condential and Proprietary Information

Planning Your Reporting Strategy

3-3

Planning QuickReports Reporting


This section includes a checklist and a few examples to help you plan a reporting strategy for the use of QuickReport types. You can select from the following report types to create your own report templates when you use the QuickReport Editor: Data Collection Table Hot Spots Table Hot Spots Threshold Table Event Summary Table Summary Graph Summary Table Trend Graph Trend Graph (Multi-Parameter) Trend Table Trend Table (Multi-Parameter)
Note

The appropriate PATROL Knowledge Module is required to measure certain parameters.

QuickReports Reporting Checklist


Plan to use the QuickReport Editor to create new report templates to satisfy your enterprise reporting needs if: you cannot nd the report you need in the Solution Reports or you have not purchased optional solution reports to manage enterprise applications you created a new measurement or parameter not provided by your PATROL KM you already created a similar type report and a simple edit would provide the report template you require

BMC Software, Inc., Condential and Proprietary Information

3-4

Reporting User Guide

Example: Locating Servers with the Least Available Space


A system manager wants to know the top ve Microsoft Exchange servers for total message size, measured weekly, to determine if a requirement to consolidate or add resources exists. The system manager uses the QuickReport Editor and creates a new Summary Graph report template. Using the QuickReport Editor, the system manager species the following report parameters: the report typeSummary Graph the node[All] (to select all nodes) the applicationMSEXCH_Server the instance[All] (to select all instances) the parameterServerMsgSize the valueTop the number of values5 the summarization typeAverage the summarization periodWeekly the unit of measurepercentage, count, average scheduleRecurring on Mondays at 13:30:00

The system manager also species a le name and a location to save the report to on the Template Folder and Filename page. Figure 3-1 is a sample of the Data Selection Criteria page the planner used to create the new report template for the Microsoft Exchange Server Message Size report.

BMC Software, Inc., Condential and Proprietary Information

Planning Your Reporting Strategy

3-5

Figure 3-1

Data Selection Criteria Page

Figure 3-2 is an example of a Summary Graph Data Display page that the planner used to create the new report template for the Microsoft Exchange Server Message Size report.

BMC Software, Inc., Condential and Proprietary Information

3-6

Reporting User Guide

Figure 3-2

Data Display Page

The system manager requested and receives notication that the report is nished. The system manager views and prints the report after accessing the Report Encyclopedia using a Web browser and the Web Desktop. For more information on notication of report generation, refer to the Actuate documentation or online help for the Administrator Desktop.

Example: Examining Servers with Highest CPU Usage


A system administrator wants to know which ve Windows NT servers in the enterprise have the highest average CPU utilization over a period of a week. The system manager uses the QuickReport Editor and creates a new Summary Graph report. Using the QuickReport Editor, the system manager selects:

BMC Software, Inc., Condential and Proprietary Information

Planning Your Reporting Strategy

3-7

the report typeSummary Graph the node[All] (to select all nodes) the applicationNT_CPU the instance[All] (to select all instances) the parameterCPUprcrProcessorTimePercent the valueTop the number of values5 the summarization typeAverage the summarization periodWeekly the unit of measurepercentage, count, average scheduleSundays at 13:30:00

The system manager also species a le name and a location to save the report to on the Template Folder and Filename page. Figure 3-3 a sample of the Data Selection page the planner used to create the new report template for the Windows NT CPU Utilization report.

BMC Software, Inc., Condential and Proprietary Information

3-8

Reporting User Guide

Figure 3-3

Windows NT CPU Utilization Data Selection Criteria Page

Figure 3-4 is an example of a Summary Graph Report Parameters page that the planner used to create the new report template for the Windows NT Server Percent CPU Utilization report.

BMC Software, Inc., Condential and Proprietary Information

Planning Your Reporting Strategy

3-9

Figure 3-4

Windows NT CPU Utilization Report Parameters Page

The system manager requested and receives notication that the report is nished. The system manager views and prints the report after accessing the Report Encyclopedia using a Web browser and the Web Desktop. For more information on notication of report generation, refer to the Actuate documentation or online help for the Administrator Desktop.

Example: Finding Server Hot Spots


An information systems manager wants to know the 10 peak use periods for Window NT servers in the domain, and also wants to see if peak times occur on the same or different servers. The request is to create automatic reports that list these hot spots daily for a week. You can use the QuickReport Editor and create a new report template with the Hot Spots Table template. Using the QuickReport Editor, select:

BMC Software, Inc., Condential and Proprietary Information

3-10

Reporting User Guide

the report typeHot Spots Table the applicationNT_CPU the parameterCPUprcrProcessorTimePercent the valueTop the number of values10 the summarization typeAverage the summarization periodWeekly the sub-span summarization periodDaily the unit of measurepercentage, count, average schedule typePeriodic schedule settingsSundays at 06:00

Also enter labels that the report displays in the title, the subtitle, and unit label for the y-axis (which shows the unit of measure). Figure 3-5 is a sample of the Data Selection Criteria page used to create the new report template for the Windows NT CPU Hot Spots report.

BMC Software, Inc., Condential and Proprietary Information

Planning Your Reporting Strategy

3-11

Figure 3-5

Windows NT CPU Hot Spots Data Selection Criteria Page

Figure 3-6 is an example of a Hot Spots Table Report Parameters page used to create the new report template for the Windows NT CPU Hot Spots report.

BMC Software, Inc., Condential and Proprietary Information

3-12

Reporting User Guide

Figure 3-6

Windows NT CPU Hot Spots Report Parameters Page

Example: Verifying Parameter Collection


A database administrator needs to verify that all of the required PATROL measurements and parameters are being collected in the DataStore for Windows NT servers to meet the enterprise reporting requirements. The administrator wants the report as the day begins to add any missing parameters. The administrator uses the QuickReport Editor and creates a Data Collection Table report template. Using the QuickReport Editor, the administrator selects: the report typeData Collection Table the node[All] ( to select all nodes) the applicationNT_SERVICES schedule Once, today at 07:00:00

BMC Software, Inc., Condential and Proprietary Information

Planning Your Reporting Strategy

3-13

The administrator also species a le name and a location to save the report to on the Template Folder and Filename page. Figure 3-7 is a sample of the Data Selection Criteria page the planner used to create the new report template for the Data Collection Table report.
Figure 3-7 Windows NT Data Collection Data Selection Criteria Page

Figure 3-8 is an example of a Data Collection Table Schedule page that the planner used to create the new report template for the Windows NT Data Collection Table report.

BMC Software, Inc., Condential and Proprietary Information

3-14

Reporting User Guide

Figure 3-8

Windows NT Data Collection Schedule Page

The administrator requested and receives notication that the report is nished. The system manager views the report from the Report Encyclopedia using a Web browser and the Web Desktop. For more information on notication of report generation, refer to the Actuate documentation or online help for the Administrator Desktop.

Using Solution-Specic Reporting


This section includes a checklist and a few scenarios to help you plan a reporting strategy for the use of predened reports. Service Reporting contains predened reports of two types, the Basic OS report package (Windows 2000 Server and Unix) and optional application-specic report packages (Oracle and Microsoft Exchange Server).

BMC Software, Inc., Condential and Proprietary Information

Planning Your Reporting Strategy

3-15

Solution Reporting Checklist


Plan to use the Solution Reports provided with Service Reporting to manage your enterprise if: you manage a Windows 2000 and Windows NT, or Unix server environment, or both you have not added Application measurements or parameters to your PATROL KMs you have purchased optional solution packages for your enterprise applications

Example: Selecting Windows NT Servers for Upgrading


A manager of information services and capacity planning has money in the budget to upgrade the Windows NT servers in the organization at the end of the year. The manager wants to know which ve are the best candidates. The IS manager decides to look at both weekly and monthly trends for the last ve months. The IS manager asks a junior capacity planner to prepare reports at the beginning of each month for the previous month. The manager wants these reports to show the ve servers with the highest average CPU use and the ve top consumers of memory. The manager wants to use the internet to view the reports. To create the reports with the information the manager requested, the capacity planner uses Service Reporting predened solution reports for the Windows NT products. The planner logs in to the Report Encyclopedia using a browser (see Using the Report Encyclopedia on page 2-6) and locates the appropriate report folders.

BMC Software, Inc., Condential and Proprietary Information

3-16

Reporting User Guide

Example: Locating Heavily Used Unix Servers


An information systems manager believes that some Unix servers in the organization may be over-utilized, and wants to know what to do to prevent future system problems. The information systems manager wants to take a look at several measurements within the enterprise, compare the results, and make the necessary decisions to keep the servers running efciently. The manager requests that a member of the staff create daily trend reports for the next few weeks with information on the top ve servers in several categories. The manager wants printed copies of all reports for each staff member who attends the Wednesday afternoon meetings.

Planning Strategies for Mixing Reporting Types


This section includes a checklist and describes a scenario that might help you plan a reporting strategy for the use of both generic and solution reports for resources management in your enterprise.

Mixing Reporting Types Checklist


Plan to use a combination of QuickReports and predened Solution Reports to satisfy your enterprise reporting needs if: you manage a Windows 2000 or Unix server environment and not all your reporting requirements are met by the reports in the Windows 2000 or Unix reporting package you have purchased optional solution packages for your enterprise applications and you cannot nd the report you need you have not purchased optional solution packages to manage enterprise applications you created a new measurement or parameter not provided by your PATROL KM

BMC Software, Inc., Condential and Proprietary Information

Planning Your Reporting Strategy

3-17

you already created a similar QuickReport type report and a simple edit would provide the report you require

Example: Getting a Picture of the Enterprise


An information systems and capacity planning manager wants to understand the big picture of the organization for budget planning purposes. These are some of the questions that need answers: Do the Windows NT or Unix servers need to be upgraded? Is the computing power sufcient for the needs of the organization? Do the Oracle databases satisfy the needs of the organization? Does the organization need additional server space for Microsoft Exchange?

The manager asks a junior capacity planner to provide information to help make budget-planning decisions for the coming year. To provide the manager with the information, the junior capacity planner decides to: create a Data Collection Table report with the QuickReport Editor to understand what application and parameter data exists in the DataStore check CPU usage and server memory availability measurements for Windows NT and Unix operating systems, as well as for the Microsoft Exchange and Oracle applications check for hot spots or peak use periods for Windows NT and Unix servers

The organization uses the Service Reporting product for predened Solution Reports for Windows 2000 and Unix servers and the QuickReport Editor to customize report templates to meet their requirements. The enterprise also collects PATROL data for Microsoft Exchange Server and Oracle. The junior planner needs to use a combination of customized reports and Solution Reports to provide the information the manager requires.
BMC Software, Inc., Condential and Proprietary Information

3-18

Reporting User Guide

The junior planner created a table like Table 3-2 to list the information needed, the report type, and the PATROL application classes and parameters that need to be analyzed.
Table 3-2 Reporting Requirements for the Enterprise

Requirement
Determine what application and parameters are collected for the devices in the organization Find Windows NT CPU utilization hot spots (readings) daily for a week Find the Unix CPU utilization hot spots (readings) daily for a week Find the Oracle servers with the least capacity Find the Oracle servers with the least available space Find the Microsoft Exchange servers with the highest memory usage Find the Microsoft Exchange servers with the greatest number of messages Find the busiest Windows NT servers Find the Windows NT servers with the least available virtual memory Find the Unix servers with highest CPU usage Find the Unix server with the least available space

Reporting Type
customized Data Collection Table report

PATROL Application/Parameter
All

customized Top N Hot Spots (Readings) Table report customized Top N Hot Spots (Readings) Table report predened Solution Report customized Bottom N Summary Graph report customized Top N Summary Graph report customized Top N S Summary Graph report predened Solution Report predened Solution Report

NT_CPU/ CPUcrprProcessorTimePercent CPU/ CPUUtil ORACLE_CAPACITY/ CusorsLeft ORACLE_AVAILABILITY/ FreeSpace MSEXCH_Server/ ServerMemory MSEXCH_Server/ ServerMsgSize NT_CPU/ CPUcrprProcessorTimePercent NT_MEMORY/ MEMmemAvailableBytes CPU/ CPUCpuUtil FILESYSTEM/ FSAvailableSpace

predened Solution Report predened Solution Report

BMC Software, Inc., Condential and Proprietary Information

Planning Your Reporting Strategy

3-19

Gathering Information on CPU Using the QuickReport Editor

The junior planner uses the QuickReport Editor to determine what information is available in the DataStore for reporting CPU. The planner uses a Data Collection Table report template and selects: report typeData Collection Table node[All] (to select all nodes) applicationCPU schedule Once, December 5, 1999 at 07:00

Gathering Hot Spot Information Using the QuickReport Editor

The junior planner wants to create reports that show the 10 peak CPU utilization times for the Window NT and Unix servers in the domain for a period of a week. The planner uses the QuickReport Editor and creates new report templates with the Top N Hot Spots (Readings) Table template. For the Windows NT Hot Spots report, the junior planner selects the following to create a new report template: the report typeTop N Hot Spots (Readings) Table the applicationNT_CPU the parameterCPUprcrProcessorTimePercent the number of values10 the summarization valueAverage the summarization periodWeekly the sub-span periodDaily schedule typePeriodic schedule settingsSundays at 06:00

For the Unix Servers Hot Spots report, the junior planner selects the following to create another new report template: the report typeTop N Hot Spots (Readings) Table the applicationCPU the parameterCPUUtil the number of values10 the summarization valueAverage the summarization periodWeekly
BMC Software, Inc., Condential and Proprietary Information

3-20

Reporting User Guide

the sub-span periodDaily schedule typePeriodic schedule settingsSundays at 06:00

Figure 3-9 is a sample of the Data Selection Criteria page the planner used to create the new report template for the Unix CPU Hot Spots report.
Figure 3-9 Sample Unix Hot Spots Data Selection Criteria Page

Figure 3-10 is an example of a Top N Summary Graph Report Parameters page that the planner used to create the new report template for the Unix CPU Hot Spots report.

BMC Software, Inc., Condential and Proprietary Information

Planning Your Reporting Strategy

3-21

Figure 3-10 Sample Unix Hot Spots Data Selection Page

For an example of a Windows NT Hot Spots Report Parameters page, see Figure 3-6 on page 3-13.
Gathering Information on Oracle Servers Using the QuickReport Editor

The junior planner uses the QuickReport Editor to create the Oracle server reports. Servers with the least available capacity Servers with the least available space

The planner uses a Bottom N Summary Graph report for both reports. In the QuickReport Editor, the planner species the following report parameters for a report that shows the Oracle servers with the least available capacity:
3-22

the report typeBottom N Summary Graph the node[All] (to select all nodes) the applicationORACLE_CAPACITY
BMC Software, Inc., Condential and Proprietary Information

Reporting User Guide

the instance[All] (to select all instances) the parameterCursorsLeft the number of values5 the summarization typeAverage the time spanWeekly scheduleRecurring on Mondays at 13:30:00

The planner also enters report labelsOracle Servers and Capacity, a units labelCursors, and a le name and location into which to copy the report after the report is generated. Other parameters to look at to get a picture of the Oracle server capacity include: Locks Free (LocksFree), Processes Left (ProcsLeft), Sessions Left (SessionsLeft), and Transactions Left (TransLeft). Figure 3-11 is a sample of the Data Selection Criteria page, the planner used to create the new template for this report.

BMC Software, Inc., Condential and Proprietary Information

Planning Your Reporting Strategy

3-23

Figure 3-11 Oracle Capacity Data Selection Criteria Page

For the second report, the planner uses the QuickReport Editor, then species the following report parameters for a report that highlights the Oracle servers with the least available free space: the report typeBottom N Summary Graph the node[All] (to select all nodes) the applicationORACLE_AVAILABILITY the instance[All] (to select all instances) the parameterFreeSpace the number of values5 the summarization typeAverage the time spanWeekly scheduleRecurring on Mondays at 13:30:00

The planner also enters report labelsOracle Servers and Least Available Space, a units label%, and a le name and location into which to copy the report after the report is generated.

BMC Software, Inc., Condential and Proprietary Information

3-24

Reporting User Guide

Figure 3-12 is a sample of the Data Selection page the planner used to create the new template for the Oracle Least Available Space report.
Figure 3-12 Oracle Availability Data Selection Criteria Page

Gathering Information on Microsoft Exchange Servers Using the QuickReport Editor

The junior planner uses the QuickReport Editor to create the Microsoft Exchange server reports. Servers with the highest memory usage Servers with the greatest number of messages

The planner uses a Top N Summary Graph report for both reports. In the QuickReport Editor, the planner species the following report parameters for a report that shows the Microsoft Exchange servers with the highest memory usage: the report typeTop N Summary Graph the node[All] (to select all nodes) the applicationMSEXCH_Server

BMC Software, Inc., Condential and Proprietary Information

Planning Your Reporting Strategy

3-25

the instance[All] (to select all instances) the parameterServerMemory the number of values5 the summarization typeAverage the time spanWeekly scheduleRecurring on Mondays at 13:30:00

The planner also enters report labelsMS Exchange Server and Memory Usage, a units labelMegabytes, and a le name and location into which to copy the report after the report is generated. Figure 3-13 is a sample of the Data Selection Criteria page the planner used to create the new template for this report.
Figure 3-13 Microsoft Exchange Memory Data Selection Criteria Page

For the second report, the planner uses the QuickReport Editor, then species the following report parameters for a report that highlights the Microsoft Exchange servers with the greatest number of messages: the report typeTop N Summary Graph
BMC Software, Inc., Condential and Proprietary Information

3-26

Reporting User Guide

the node[All] (to select all nodes) the applicationMSEXCH_Server the instance[All] (to select all instances) the parameterServerMsgSize the number of values5 the summarization typeAverage the time spanWeekly scheduleRecurring on Mondays at 13:30:00

The planner also enters report labelsMicrosoft Exchange Servers and Server Messages, a units labelCount, and a le name and location into which to copy the report after the report is generated.
Figure 3-14 Microsoft Exchange Messages Data Selection Criteria Page

Locating Information on Windows 2000 Servers Using Solution Reports

The junior planner looks in the Report Encyclopedia for the weekly solution reports for the Windows 2000 servers for reports on the busiest servers

BMC Software, Inc., Condential and Proprietary Information

Planning Your Reporting Strategy

3-27

servers with least available memory

Locating Information on Unix Servers Using Solution Reports

The junior planner looks in the Report Encyclopedia for the weekly solution reports for the Unix servers. Servers with the highest CPU usage Servers with least available space

The planner produces a sample report that shows the weekly summary of the ve Unix servers with the highest CPU load as measured by the CPULoad parameter. The report is based on a Top N Summary Graph provided as part of the Solution Reports for Unix servers.

BMC Software, Inc., Condential and Proprietary Information

3-28

Reporting User Guide

Creating, Scheduling, Viewing, and Printing Reports 4


This chapter describes how to create new reports, how to create reports by using existing documents as templates, how to schedule and generate your reports, how to locate and view reports, and how to print and distribute reports. Creating Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2 Scheduling and Generating Reports . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19 Locating and Viewing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-28 Printing and Distributing Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-31

BMC Software, Inc., Condential and Proprietary Information

Creating, Scheduling, Viewing, and Printing Reports

4-1

Creating Reports
You use the QuickReport Editor to create new report templates based on QuickReport types. With the QuickReport Editor, you can also edit existing report templates to create new report templates. You cannot design new report types or templates with the QuickReport Editor.

Creating a New Report Template with the QuickReport Editor


The QuickReport Editor leads you through a series of Web pages where you choose a QuickReport type and dene additional parameters based on the selected report. You can select from the following reports: Data Collection Table Event Summary Table Hot Spots Table Hot Spots Threshold Table Summary Graph Summary Table Trend Graph Trend Graph (Multi-Parameter) Trend Table Trend Table (Multi-Parameter)

Additional parameters and selection criteria you can choose include: all or selected nodes parameters all or selected instances applications level of summarization (daily, weekly, monthly, yearly) time frame (current day, month of December, and so on) input to the report title, subtitle, and axis labels

Before you create and save the report template, you choose whether to generate the report immediately, to save the report to generate later, or schedule the report to generate on a periodic basis.

BMC Software, Inc., Condential and Proprietary Information

4-2

Reporting User Guide

Creating a New Report Summary:


This task describes how to create a new report from a report template using the QuickReport Editor. Open your Web browser and enter the URL for the Report Encyclopedia. (See Using the Report Encyclopedia on page 2-6.) Enter the user name and password provided by your administrator for the Report Encyclopedia in the login dialog box, if applicable. The Report Encyclopedia appears. Click the My Headlines tab. The link for access to the QuickReport Editor appears.

Step 1

Step 2

Step 3

Step 4

Click the QuickReport Editor link. The QuickReport Editor launches.

BMC Software, Inc., Condential and Proprietary Information

Creating, Scheduling, Viewing, and Printing Reports

4-3

Figure 4-1

QuickReport Editor Welcome Page

Step 5

Click Create a new report template to create a new report. The Template Type Selection page displays.

BMC Software, Inc., Condential and Proprietary Information

4-4

Reporting User Guide

Note

Clicking Previous on the QuickReport Editor page moves back to the previous page in the QuickReport Editor. Clicking Cancel on any QuickReport Editor page cancels your report selections and returns to the rst page of the QuickReport Editor. Clicking on the main Web browser window returns the Report Encyclopedia to the front.
Figure 4-2 QuickReport Editor Template Style Selection Page

Step 6

On the Template Type Selection page, select the type of report template that you want to create: Data Collection Table Event Summary Table Hot Spots Table Hot Spots Threshold Table Summary Graph
Creating, Scheduling, Viewing, and Printing Reports 4-5

BMC Software, Inc., Condential and Proprietary Information

Summary Table Trend Graph Trend Graph (Multi-Parameter) Trend Table Trend Table (Multi-Parameter) Then, click Next. The Data Selection Criteria page displays.

Figure 4-3

Data Selection Criteria Page

Step 7

On the Data Selection Criteria page, you construct your data parameters. The values you need to select for this page depend on the report type you selected on the previous page.

BMC Software, Inc., Condential and Proprietary Information

4-6

Reporting User Guide

7.A

Select values for the Node, Application, Instance, and Parameter from the available choices in their respective drop-down list boxes. To include all Nodes and Instances, select [All] from their respective drop-down list boxes.
Note

Choices available on the Data Selection Criteria page depend on the report type you selected on the Template Type Selection page. For example, if you selected to create a Data Collection Table, only Node and Application Data elements display.
7.B

Change the labels for the Application and Parameter, as appropriate. The QuickReport Editor inserts your inputs into the titles for the new report. Then, click Next. The Display Choices page appears.

7.C

BMC Software, Inc., Condential and Proprietary Information

Creating, Scheduling, Viewing, and Printing Reports

4-7

Figure 4-4

QuickReport Editor Report Display Choices Page

Step 8

On the Data Display page, select the parameters you want your report to display.
Note

Choices available on the Data Display page depend on the report type you selected on the Template Type Selection page. For example, if you selected to create a Data Collection Table, a Report Parameter page does not display. If you selected to create a Hot Spot Table or Trend Graph, you need to enter additional parameters, for example, a sub-span period or a threshold value.
8.A

Input or select the top order values or the bottom order values that you want your report to display. The default number is ve. Select the summarization type parameter: Average, Maximum, Minimum, Sample_Count, Standard_Deviation, Variance, or Sum.
BMC Software, Inc., Condential and Proprietary Information

8.B

4-8

Reporting User Guide

8.C

Select Daily, Weekly, Monthly or Yearly for the period to summarize. Then, click Next. The Template Folder and Filename page displays.

8.D

Figure 4-5

QuickReport Editor Template Folder and Filename Page

Step 9

On the Template Folder and Filename page, enter the report le name and folder for the report in the input box. Click Browse if you need to nd or add a folder. Then, click Next. The Schedule page displays. To add a folder, click the Create New Folder button, type the folder name, press the Enter key, and click OK.

BMC Software, Inc., Condential and Proprietary Information

Creating, Scheduling, Viewing, and Printing Reports

4-9

Figure 4-6

QuickReport Editor Schedule Page

Step 10

On the Schedule Page, set up the schedule to generate the report.


10.A

Select the check box for the schedule you want to use to generate the report: Periodic, Now, Once, or None (postpone scheduling). If you choose Periodic or Once, select the appropriate times from the drop-down boxes in the Settings area. If you choose None, the QuickReport Editor creates a Report Template (Parameter Values le) from which you can generate a report at a later time.

10.B

10.C

Then, select Next. The Template Creation Summary page displays.

BMC Software, Inc., Condential and Proprietary Information

4-10

Reporting User Guide

Figure 4-7

QuickReport Editor Template Creation Summary Page

Step 11

On the Template Creation Summary page, click Cancel to return to the Welcome page or Previous to go back to previous pages and change any information. If you are satised with the report, click Finish to complete the report. The Successfully Completed page displays.

BMC Software, Inc., Condential and Proprietary Information

Creating, Scheduling, Viewing, and Printing Reports

4-11

Figure 4-8

QuickReport Editor Successfully Completed Page

Editing a Report Template with the QuickReport Editor


You can use the QuickReport Editor to edit existing report templates to create a new report. You might edit a report to change the PATROL parameter, the summarization type, the summarization period, or both the application and parameter.

BMC Software, Inc., Condential and Proprietary Information

4-12

Reporting User Guide

Editing an Existing Report Summary:


This task describes how to create a new report by editing an existing report template using the QuickReport Editor. Log in to the Report Encyclopedia, if you have not already. (See Using the Report Encyclopedia on page 2-6.) The Report Encyclopedia folders display. Click the My Headlines tab to display the QuickReport Editor link. Click the QuickReport Editor link. The QuickReport Editor launches. Click Modify an existing report templates properties to edit an existing report. The Report Template Selection page appears. On the Report Template Selection page, click Browse and select the report le you want to modify.
Figure 4-9 Report Template Selection Page Browse Window

Step 1

Step 2 Step 3 Step 4

Step 5

The name of the report le displays in the Report Template input box.

BMC Software, Inc., Condential and Proprietary Information

Creating, Scheduling, Viewing, and Printing Reports

4-13

Figure 4-10 Report Template to Edit

Step 6

After you make your edit selection, click Next. The Edit Data Selection page displays.
Figure 4-11 QuickReport Editor Edit Data Selection Criteria Page

Step 7

On the Data Selection Criteria page, create the parameters for your new report.

BMC Software, Inc., Condential and Proprietary Information

4-14

Reporting User Guide

7.A

Change the values for Node, Application, Instance, and Parameter, as required for your new report. Again, the values displayed on the Data Selection page depend on the generic report type of the report you chose to edit.

7.B

Change the values for the Application and Parameter, as appropriate. Click the tab of the next QuickReport Editor page where you need to make changes: Data Display, Template Name (required, unless you want to overwrite the existing report), or Schedule. These are the same set of pages that you use when you create a new report.

7.C

7.D

After you change report parameters, summarizations, scheduling, name and location to satisfy your new report requirements, click Finish on the Schedule page. The Successfully Completed page displays.
Note

You can click Cancel to quit without saving or generating a report or Previous to go back to previous pages and change any information for the report.

BMC Software, Inc., Condential and Proprietary Information

Creating, Scheduling, Viewing, and Printing Reports

4-15

Figure 4-12 QuickReport Editor Edit Successfully Completed Page

Deleting a QuickReport Template that you Created


You can use the QuickReport Editor to delete a template that you created.

BMC Software, Inc., Condential and Proprietary Information

4-16

Reporting User Guide

Deleting a Template with the QuickReport Editor Summary:


This task describes how to delete a generic report template you created using the QuickReport Editor. Log in to the Report Encyclopedia, if you have not already. (See Using the Report Encyclopedia on page 2-6.) The Report Encyclopedia folders display. Click the My Headlines tab to display the QuickReport Editor link. Click the QuickReport Editor link. The QuickReport Editor launches.
Figure 4-13 QuickReport Editor Welcome Page

Step 1

Step 2 Step 3

Step 4

Select the Delete a report template link. The Report Deletion dialog box displays.

BMC Software, Inc., Condential and Proprietary Information

Creating, Scheduling, Viewing, and Printing Reports

4-17

Step 5

On the Report Deletion dialog, select a report le, and then click Delete. A conrmation message appears. Click OK to delete the report. Repeat to delete additional reports.

BMC Software, Inc., Condential and Proprietary Information

4-18

Reporting User Guide

Scheduling and Generating Reports


You can schedule and generate reports on demand using Service Reporting. You might want to schedule and generate: a QuickReport created without a schedule a QuickReport to execute on a different schedule a Solution Report to execute immediately

For information specic to QuickReports, refer to Scheduling QuickReports on page 4-19 specic to Solution Reports, refer to Generating Solution Reports on page 4-23

Scheduling QuickReports
To schedule and generate reports, BMC Software recommends that you use the editing function of the QuickReport Editor.

BMC Software, Inc., Condential and Proprietary Information

Creating, Scheduling, Viewing, and Printing Reports

4-19

Scheduling a QuickReport Template Summary:


This task describes how to generate and schedule a report created with the QuickReport Editor from a Web browser using the Web Desktop. Open your Web browser and enter the URL for the Report Encyclopedia. (See Using the Report Encyclopedia on page 2-6.) Enter the user name and password provided by your administrator for the Report Encyclopedia in the login dialog box, if applicable. The Report Encyclopedia main page appears.
Figure 4-14 Report Encyclopedia Main Page

Step 1

Step 2

Step 3 Step 4 Step 5

Click the My Headlines tab. The QuickReport Editor link appears. Click the QuickReport Editor link. The QuickReport Editor launches. Click Modify an existing report templates properties to edit an existing report template. Click Browse and select the report template you want to modify. The name of the report le displays in the Report Template input box.
BMC Software, Inc., Condential and Proprietary Information

Step 6

4-20

Reporting User Guide

Figure 4-15 QuickReport Editor Report Template Selection Page

Step 7

After you make your selection, click Next. The Data Selection Criteria page displays.
Figure 4-16 QuickReport Editor Data Selection Page

Step 8

To schedule the report template to generate the selected report, click the Schedule tab. On the Schedule tab, set up the schedule to generate the report.

Step 9

BMC Software, Inc., Condential and Proprietary Information

Creating, Scheduling, Viewing, and Printing Reports

4-21

9.A

Select the check box for the schedule you want to use to generate the report: Periodic, Now, Once or None. If you choose Periodic or Once, select the appropriate times from the drop-down boxes in the Settings area. Then, select Finish. The Successfully Completed page displays.

9.B

9.C

Figure 4-17 QuickReport Editor Successfully Completed Page

BMC Software, Inc., Condential and Proprietary Information

4-22

Reporting User Guide

Generating Solution Reports


To schedule and generate Solution Reports from the Report Encyclopedia, BMC Software recommends that you use the Web Desktop. For information on how to use the Web Desktop, see Using the Web Desktop on page 2-5 access the Report Encyclopedia, see Using the Report Encyclopedia on page 2-6 navigate in the Report Encyclopedia, see Navigating in the Report Encyclopedia on page 2-11

Check with your Report Server administrator to see if you can access parameter value les and report executables on the Web. You can also schedule and generate reports from the Report Encyclopedia using the Administrator Desktop or the End User Desktop. The interfaces you use and the tasks you perform to schedule and generate a report using these desktop application are different from those of the Web Desktop. For information on scheduling reports and generating reports using the Administrator Desktop or the End User Desktop, see Viewing e.Reports, Using e.Reports, or the respective applications online help.

BMC Software, Inc., Condential and Proprietary Information

Creating, Scheduling, Viewing, and Printing Reports

4-23

Generating a Solution Report Summary:


This task describes how to generate and schedule a Solution Report in the Report Encyclopedia from a Web browser using the Web Desktop. Log in to the Report Server for your Report Encyclopedia using your Web browser. The Report Encyclopedia main page displays. Click the BMCReports link. Links for available reports appear on the left-side of the browser. Navigate to a folder that contains the Report Object Value (.ROV) le for the report that you want to schedule and generate. Click the Report Object Value le and select a report. The Request Report page for the report displays.
Figure 4-18 Request Report Page

Step 1

Step 2

Step 3

Step 4

Step 5

Scroll to the Schedule section.

BMC Software, Inc., Condential and Proprietary Information

4-24

Reporting User Guide

Figure 4-19 Request Report Scheduling Options

Step 6

In the Schedule section, select the time you want the report to generate: Right Now, Once, or Recurring. The default is to generate right now. Enter dates and times as required by your schedule selection. Then, scroll to the Priority section of the Request Report page.
Figure 4-20 Request Report Priority Options

Step 7

In the Priority section, set the priority at which to generate the report: High (800), Medium (500), Low (200), or Other (1-1000). This is the priority the server assigns to generating the report, Medium (500) is the default. Scroll to the Version section of the Request Report page.
Figure 4-21 Request Report Version Options

Step 8

In the Version section, select the version information for the report.

BMC Software, Inc., Condential and Proprietary Information

Creating, Scheduling, Viewing, and Printing Reports

4-25

8.A

Select the Create new version or the Overwrite existing version option button. The default is to create a new version. Enter a name for the version in the Version Name input box, if you are maintaining versions. A version number is used by default, for example, Version 1 or Version 2. Enter a full path name in the Output Name input box.

8.B

8.C Step 9

Scroll down to the Archive Policy section and create archive information for this report. You can set the Archive Policy to: use the default archive policy - Use the archive policy for the distribution folder(s) never delete the report - Do not automatically delete items delete a report after a set time period - Delete objects older than: set a specic date to delete - Delete objects on:

Figure 4-22 Archive Policy Options

BMC Software, Inc., Condential and Proprietary Information

4-26

Reporting User Guide

Step 10

After entering all of your information, click Submit Request on the left side of the browser. On the Conrmation page, click Request Status to check on the status of your request. To cancel the request, click Cancel Request. You can also check on the status of your report by clicking the Active Request folder in the Report Encyclopedia left panel.

Step 11

BMC Software, Inc., Condential and Proprietary Information

Creating, Scheduling, Viewing, and Printing Reports

4-27

Locating and Viewing Reports


All reports and report templates are stored in the Report Encyclopedia on a Report Server. To locate and view Report Encyclopedia reports, BMC Software recommends that you use the Web Desktop. For information on how to: use the Web Desktop, see Using the Web Desktop on page 2-5 access the Report Encyclopedia, see Using the Report Encyclopedia on page 2-6 navigate in the Report Encyclopedia, see Navigating in the Report Encyclopedia on page 2-11

Check with your Report Server administrator to see if you can access reports on the Web. You can also locate and view reports from the Report Encyclopedia using the Report Viewer, the End User Desktop, or the Administrator Desktop. For information on locating reports and viewing reports using the Report Viewer, the End User Desktop or the Administrator Desktop, see Viewing e.Reports, Using e.Reports, or the respective applications online help. The following sections describe how to locate and view generic reports that you create using the QuickReport Editor and predened Solution Reports provided by Service Reporting.
Note

When viewing a report using the Web Desktop, the Search function is not available.

BMC Software, Inc., Condential and Proprietary Information

4-28

Reporting User Guide

Locating and Viewing QuickReports


Service Reporting includes a QuickReport Editor with several QuickReport types. You can choose from these report types to create the report templates you need to manage your enterprise. See Creating a New Report on page 4-3 for information on how to use the QuickReport Editor to create a new QuickReport Template. QuickReports are stored in the Report Encyclopedia. BMC Software provides the top-level folder, BMCReports, for the storage of reports and the les that support customized reporting.

BMC Software, Inc., Condential and Proprietary Information

Creating, Scheduling, Viewing, and Printing Reports

4-29

Viewing a QuickReport from the Report Encyclopedia Summary:


This task describes how to locate and view a QuickReport in the Report Encyclopedia using the Web Desktop from a Web browser. Open your Web browser and enter the URL for the Report Encyclopedia. (See Using the Report Encyclopedia on page 2-6.) Enter the user name and password provided by your administrator for the Report Encyclopedia in the login dialog box, if applicable. The Report Encyclopedia folders display. Click the BMCReports link. BMCReports is the name of the top-level folder that stores QuickReport Report Document les with the associated Parameter Values les (ROVs) and Report Executable les (ROXs). Continue to navigate through the BMCReports subfolders until you locate the report that you want to view. Click the folder for the report that you want to view. Click the Report Document for Available Virtual Memory. The QuickReport displays.

Step 1

Step 2

Step 3

Step 4 Step 5

Locating and Viewing a Solution Report


Service Reporting provides Solution Reports for the management of a specic technology or application. Solution Reports might provide information on service management, enterprise resource management, or on other requirements specic to the management of a particular application or technology. These reports are stored in the Report Encyclopedia. Solution Reports are available for the Windows 2000 and Unix operating systems and the Microsoft Exchange and Oracle applications.

BMC Software, Inc., Condential and Proprietary Information

4-30

Reporting User Guide

Viewing a Solution Report from the Report Encyclopedia Summary:


This task describes how to locate and view a Solution Report in the Report Encyclopedia using the Web Desktop from a Web browser. Open your Web browser and enter the URL for the Report Encyclopedia. (See Using the Report Encyclopedia on page 2-6.) Enter the user name and password provided by your administrator for the Report Encyclopedia in the login dialog box, if applicable. The Report Encyclopedia displays. Click the BMCReports link. Search through the Report Encyclopedia folders until you nd the Solution Report that you want to view. You nd Solution Reports in top-level folders, Exchange, NT, Oracle, and Unix. For example, if you wanted to view reports with information on the Window NT workstations with the highest memory usage in your enterprise, click NT, Daily, AvailableBytes, in succession.
Step 5

Step 1

Step 2

Step 3 Step 4

Click the Report Document that you want to view. For example, click MEMmemAvailableBytes19991001. The report displays. Click Back in the Web browsers toolbar to return to the Report Encyclopedia and to locate other Solution Reports that you want to view.

Step 6

Printing and Distributing Reports


You can print and distribute reports stored in the Report Encyclopedia. Anytime after generating a report, you can use the Web Desktop from your browser to: print the report save a report as a .PDF le

BMC Software, Inc., Condential and Proprietary Information

Creating, Scheduling, Viewing, and Printing Reports

4-31

You can also request the printing of a report when you create a request to generate a report in the Report Encyclopedia from the End User Desktop, or the Administrator Desktop, using the applicationss Requester dialog box. For more information on printing and distributing reports using the End User Desktop or the Administrator Desktop, see Viewing e.Reports, Using e.Reports, or the respective applications online help.

Printing a Report
To print and distribute reports from the Report Encyclopedia, BMC Software recommends that you use the Web Desktop.

BMC Software, Inc., Condential and Proprietary Information

4-32

Reporting User Guide

Printing Reports from the Report Encyclopedia Summary:


This task explains how to print a report from the Report Encyclopedia using the Web Desktop any time after the report is generated.

Note

Because printing using the following method may clip portions of your report, BMC Software recommends that you save the report as a .PDF le and then print from the .PDF viewer. To do this, click the Print/Download link on the Web Desktop and follow the screens to save the report. See your Adobe Acrobat documentation for information on printing a .PDF le.
Step 1

Open your Web browser, enter the URL for the Report Server for your Report Encyclopedia, and log in using the user name and password assigned to you. For more information on accessing the Report Encyclopedia from a browser, see Using the Report Encyclopedia on page 2-6.

Step 2

Locate and open the report that you want to print. See Locating and Viewing Reports on page 4-28.

BMC Software, Inc., Condential and Proprietary Information

Creating, Scheduling, Viewing, and Printing Reports

4-33

Figure 4-23 Browser File Menu

Step 3

With the report in the browser window, choose File => Print. The Print dialog box displays.

BMC Software, Inc., Condential and Proprietary Information

4-34

Reporting User Guide

Figure 4-24 Print Dialog Box

Step 4

Click Properties to change printer properties, as required. The Document Properties dialog box displays.

BMC Software, Inc., Condential and Proprietary Information

Creating, Scheduling, Viewing, and Printing Reports

4-35

Figure 4-25 Printer Properties Dialog Box

Step 5

To avoid possible clipping of your reports, you should reduce the size of your report or change printer properties as required. For example, you might try to change the report size from 100% to 75% and the print orientation to Landscape. If you are printing the report on a color printer, you might want to check color options. After selecting printer properties, click OK. When the Print dialog box displays again, click OK to print the report.
Note

Step 6

You can also save a report as a .PDF le and print from the .PDF viewer. Click the Print/Download link on the Web Desktop and follow the screens to save the report. See your Adobe Acrobat documentation for information on printing a .PDF le.

BMC Software, Inc., Condential and Proprietary Information

4-36

Reporting User Guide

Working with QuickReports

This chapter describes the QuickReport types included with the Service Reporting product for use with the QuickReport Editor, and explains how to use QuickReports to manage resources in your enterprise. Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2 Interpreting QuickReports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3 Summarizing Enterprise Events and Measurements . . . . . . . . . . . . . 5-7 Taking a Closer Look at Enterprise Measurements . . . . . . . . . . . . . . 5-10 Locating Enterprise Hot Spots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15 Checking Database Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19

BMC Software, Inc., Condential and Proprietary Information

Working with QuickReports

5-1

Overview
Service Reporting provides QuickReport templates for use with the QuickReport Editor to allow users to dene the report templates that they require to manage the resources in their enterprise. You can easily transform QuickReport types into the report templates you need by specifying or lling in options in a series of Web pages. You start by selecting a report type with the QuickReport Editor, then choose additional parameters based on the report type.

Describing QuickReport Types


A QuickReport type is a general class of report templates that you can use to dene a new report template. To dene a new report template, you ll in values in a form, based on the selection of a QuickReport type.
Table 5-1 QuickReport Types (Part 1 of 2)

Report Types
Data Collection Table Hot Spots Table

Description
Lists all of the components, measurements, and event types collected in the DataStore database. Provides the measurement value of a particular enterprise component for a specied time span of the report and lists the top n or bottom n readings for a measurement or parameter. Given a PATROL parameter, list n component values where the user-specied threshold was crossed. The time span is specied by the user. Displays a customer-dened number of components and their associated events. Displays n number of components with the highest or lowest values of a parameter in bar graph format. Displays n number of components and their associated parameter values, in table format. Displays a measurement value of a set of components representing a specic time period. The time span is specied by the user. Displays multiple measurements for multiple components representing a specic time period. The time span is specied by the user.

Hot Spots Threshold Table Event Summary Table Summary Graph Summary Table Trend Graph Trend Graph (Multi-Parameter)

BMC Software, Inc., Condential and Proprietary Information

5-2

Reporting User Guide

Table 5-1

QuickReport Types (Part 2 of 2)

Report Types
Trend Table Trend Table (Multi-Parameter)

Description
Displays the measurement value of a set of components representing a specic time period, in table format. The time span is specied by the user. Displays multiple measurements for multiple components representing a specic time period. The time span is specied by the user.

Interpreting QuickReports
You create report templates using the QuickReport Editor. This section looks at selected reports you can create by customizing QuickReport types: Summary Graph Hot Spots Data Collection

Looking at Summary Graphs


You create a summary graph report by selecting and customizing the Summary Graph template using the QuickReport Editor. Summary graphs present N or fewer components with the highest or lowest values of a parameter. Each of the N components is represented by a bar. The length of the bar represents the value of the parameter. Summary graphs can show daily, weekly, or monthly information for a selected parameter. Table 5-2 lists the items of the Summary Graph presentation, an example, and the items origin.

BMC Software, Inc., Condential and Proprietary Information

Working with QuickReports

5-3

Table 5-2

Looking at the Summary Graph Presentation

Item
title

Example
Bottom 5 Available Virtual Memory

Origin
selection typeTop or Bottom selection limitN selected on the Parameters page (optimum number is ve) labelmeaning of the graph entered in input box on Data selection page (Available Virtual Memory) date for which the measurements were collected span of the graphselected on the Parameters page (Daily) summary typeselected on the Parameters page (Average) selection typeTop or Bottom (as in title) selection limitN selected on the Parameters page labelcomponent label entered in input box on Data Selection page (NT Workstation) labelmeaning of the graph entered in input box on Data Selection page (Available Virtual Memory) selection typeTop or Bottom selection limitN selected on the Parameters page labelcomponent label entered in input box on Data Selection page (NT Workstation) the parameter nameselected on the Data Selection page the value typeunit label selected on the Parameters page (MB)

subtitle table caption

for Fri 1999-Aug-20 Daily Average of Bottom 5 NT Workstation by Available Virtual Memory

X-axis

Bottom 5 NT workstation

Y-axis

NT_Memory/MEMmemAvailable Bytes (MB)

BMC Software, Inc., Condential and Proprietary Information

5-4

Reporting User Guide

Looking at Hot Spots Tables


A reading is a measurement value for a particular enterprise component for a specied subspan within the time span of the report. In the DataStore, each parameter has one reading for each component for each hour of the day. The Hot Spots Table report lists the top N readings for a particular measurement or parameter regardless of when or on which component the top reading occurs. Table 5-3 lists the items of the Hot Spots Table presentation, an example, and the items origin.
Table 5-3 Looking at the Top N Hot Spots Table Presentation

Item
title

Example
Bottom 10 NT CPU Utilization Readings

Origin
selection typeTop or Bottom selection limitN selected on the Parameters page labelmeaning of the graph entered in input box on the Data Selection page (NT CPU Utilization) Readingsset by report type date for which the measurements were collected span of the graphselected on the Parameters page (Daily) summary typeselected on the Parameters page (Average) Readings ofset by report type selection typeTop or Bottom (as in title) selection limitN selected on the Parameters page labelmeaning of the graph entered in input box on the Data Selection page (NT CPU Utilization) node and instance where a top reading was observedfrom DataStore subspan interval when reading was observedfrom DataStore value of the readingfrom DataStore (percent CPU utilization)

subtitle table caption

for Week of 1999-Aug-22 Daily Average Readings of Bottom 10 NT CPU Utilization

Component Time Value

reporttest1/NT01 Sun 1999-08-22 12:00:00 AM 55

BMC Software, Inc., Condential and Proprietary Information

Working with QuickReports

5-5

Looking at Data Collection Tables


A Data Collection Table report lists all the components, measurements, and event types collected in the DataStore database on or after a given date. Table 5-4 lists the items of the Data Collection Table presentation, an example, and the items origin.
Table 5-4 Looking at the Data Collection Table Presentation

Item
title subtitles

Example
PATROL 3 Data Collection Table Collection on or After Wed 1999-Aug-01

Origin
PATROL 3 Data Collection Tableset by report type Collection on or Afterset by report type date for which the measurements were collected NT indicates that NT application classes were selected on the Data Selection page for Application % wildcard that indicates [all] was selected on the Data Selection page for Node application classset by Application selection node where measurement was collected set by Node selection parameters measuredset by Application selection instanceset by node selection last date the measurement was collectedfrom the DataStore

Report Patterns

AppClass Pattern NT

Node Pattern%

report segregator Node Name Parameter Instance Last Collected Date

APPClass NT_CACHE reporttest1 CacheCopyReadHitsPercent CacheCopyReadPerSec NT01 Wed 1999-09-01 03:45:00

BMC Software, Inc., Condential and Proprietary Information

5-6

Reporting User Guide

Summarizing Enterprise Events and Measurements


To create reports that summarize particular events and measurements on the servers in your enterprise, you can customize the following report templates using the QuickReport Editor: Event Summary Table templates

With the summary reports, you can determine the highest or lowest server measurements for Windows NT enterprise-wide parameters, such as the following: memory availability CPU utilization logical and physical disk usage cache usage

For a list of Windows NT parameters available for reporting, see the Data Selection page of the QuickReport Editor. You can customize the summary report templates to investigate Unix server parameters, such as available space NFS read and write calls CPU utilization or load memory availability busiest disks disk reads and writes incoming network packets user or session counts

For a list of Unix parameters available for reporting, see the Data Selection page of the QuickReport Editor. If data for Microsoft Exchange and Oracle is collected and stored in the DataStore, you can use the summary reports to investigate parameters of these applications.
BMC Software, Inc., Condential and Proprietary Information

Working with QuickReports

5-7

Looking at the top ve servers based on the highest or lowest measurements for several parameters can provide information to help: plan for redistribution of your enterprise resources determine the need for upgrades and replacements aid in troubleshooting device problems

You can create the rst report based on a summary template, then edit the report as many times as you need to create other similar reports.
Note

You need to change the le name of each new report template you create, if you want to keep the template. Editing a report template without changing its le name, overwrites the report template. After you select the report type and click Next in the QuickReport Editor, the Data Selection page for the selected report type displays. On this page, you nd listed all nodes, applications, instances, and parameters available for a report in their respective drop-down list boxes. Figure 5-1 shows a sample list of application classes available for Top N Summary Graph reports for Windows NT servers. These same application classes are available if you wanted to create a Bottom N Summary Graph, a Top N Summary Table, or a Bottom N Summary Table report.

BMC Software, Inc., Condential and Proprietary Information

5-8

Reporting User Guide

Figure 5-1

Summary Graph Application Classes

After selecting an Application on the Data Selection Criteria - Summary Graph page, for example, NT_CACHE, click the Parameter drop-down list box to display the parameters for the selected Application. Figure 5-2 shows a sample NT_Memory application class and the associated parameters available for a report.

BMC Software, Inc., Condential and Proprietary Information

Working with QuickReports

5-9

Figure 5-2

Summary Graph Windows NT Memory Parameters

Taking a Closer Look at Enterprise Measurements


To create reports that take a closer look at particular measurements on the servers in your enterprise, you can customize the Top or Bottom N Trend Graph templates using the QuickReport Editor. You choose components and parameters for trend graph reports just as you do for summary reports. In the trend graph, the parameter for each of the N components is plotted over the selected span by intervals: a daily report is plotted by the hour a weekly report is plotted by the day a monthly report is plotted by the week

BMC Software, Inc., Condential and Proprietary Information

5-10

Reporting User Guide

With a trend graph report, you can view the highest or lowest hourly, daily, or weekly server measurements for Windows NT parameters, such as: memory availability CPU utilization logical and physical disk usage cache usage network usage services availability

For a list of Windows NT parameters available for reporting, see the Data Selection Criteria page of the QuickReport Editor. You can customize the trend report templates to investigate Unix server parameters, such as: available space NFS read and write calls CPU utilization or load memory availability busiest disks disk reads and writes incoming network packets user or session counts

For a list of Unix parameters available for reporting, see the Data Selection Criteria page of the QuickReport Editor. If data for Microsoft Exchange and Oracle is collected and stored in the DataStore, you can use the trend graph reports to investigate parameters of these applications.

BMC Software, Inc., Condential and Proprietary Information

Working with QuickReports

5-11

You can create the rst report based on the Top N Trend Graph template, then edit the report as many times as you need to create other similar reports.
Note

You need to change the le name of each new report template you create to save as a new template. Editing a report template without changing its le name, overwrites the report template. After you select the report type and click Next in the QuickReport Editor, the Data Selection Criteria page for the selected report type displays. On this page, you nd listed all nodes, applications, instances, and parameters available for a report in their respective drop-down list boxes. Figure 5-3 shows a sample list of application classes available for Trend Graph reports for Windows NT servers.

BMC Software, Inc., Condential and Proprietary Information

5-12

Reporting User Guide

Figure 5-3

Trend Graph Application Classes

After selecting an Application on the Data Selection Criteria - Top N Trend Graph page, for example, NT_SYSTEM, click the Parameter drop-down list box to display the parameters for the selected Application. Figure 5-4 shows a sample NT_SYSTEM application class and the associated parameters available for a report.

BMC Software, Inc., Condential and Proprietary Information

Working with QuickReports

5-13

Figure 5-4

Trend Graph Parameters

BMC Software, Inc., Condential and Proprietary Information

5-14

Reporting User Guide

Locating Enterprise Hot Spots


To create reports that highlight enterprise hot spots, you use the QuickReport Editor to customize either of the following report templates: Hot Spots (Readings) Table templates Hot Spots (Readings) Threshold Table templates

The hot spot reports show the highest or lowest readings for a subspan for the selected parameter regardless of which server or when the reading occurs. The threshold hot spot report lists only those component-interval pairs that cross the specied threshold. For the selected parameter you can create: a daily report listing hourly hot spots a weekly report listing daily hot spots a monthly report listing daily hot spots

Parameters available for hot spot reporting for Windows NT servers include: memory availability, cache faults, or page faults CPU utilization logical disk space physical queue length cache hits or read rate system availability service availability

For a list of Windows NT parameters available for reporting, see the Data Selection Criteria page of the QuickReport Editor Parameters available for hot spot reporting for Unix servers include: space availability percentage of NFS read and write calls CPU utilization CPU load memory availability

BMC Software, Inc., Condential and Proprietary Information

Working with QuickReports

5-15

busiest disks disk reads and writes incoming network packets user or session counts

For a list of Unix parameters available for reporting, see the Data Selection Criteria page of the QuickReport Editor If data for Microsoft Exchange and Oracle is collected and stored in the DataStore, you can use the hot spot reports to investigate parameters of these applications. You can use the Hot Spot Reports as a troubleshooting tool to locate problems before they cause server downtime. You can create the rst report based on the Hot Spots (Readings) Table template or the Hot spots (Readings) Threshold Table template, then edit the report as many times as you need to create other similar reports.
Note

You need to change the le name of each new report template you create, if you want to keep the template. Editing a report template without changing its le name, overwrites the report template. After you select the report type and click Next in the QuickReport Editor, the Data Selection Criteria page displays. On this page, you nd listed the applications and parameters available for these reports in their respective drop-down list boxes. Figure 5-5 shows a sample list of application classes available for Hot Spots (Readings) Table reports for Windows NT servers. The same application classes are available for a Bottom N Hot Spots Table report and Top and Bottom N Hot Spots Threshold Table reports.

BMC Software, Inc., Condential and Proprietary Information

5-16

Reporting User Guide

Figure 5-5

Hot Spots Table Application Classes

After selecting an Application on the Data Selection Criteria - Hot Spots Table page, for example, NT_CPU, click the Parameter drop-down list box to display the parameters for the selected Application. Figure 5-6 shows the NT_CPU application class and the parameters available for a Top N Hot Spots (Readings) Table report. The same parameters are available for a Bottom N Hot Spots Table report and Top and Bottom N Hot Spots Threshold Table reports.

BMC Software, Inc., Condential and Proprietary Information

Working with QuickReports

5-17

Figure 5-6

Hot Spots Table Windows NT CPU Parameters

BMC Software, Inc., Condential and Proprietary Information

5-18

Reporting User Guide

Checking Database Information


To create a report that shows database information collected on or after a given date, you customize the Data Collection Table template using the QuickReport Editor. You can choose to view data collected in the DataStore for one server or all servers, and for one application class. For Windows NT nodes, you can use a Data Collection Table report to determine if parameters for the following application classes are collected and stored in the DataStore on or after a given date: NT_CACHE NT_CPU NT_FTP NT_LOGICAL_DISKS NT_MEMORY NT_PAGEFILE NT_PHYSICAL_DISKS NT_PRINTER NT_PROCESS NT_SECURITY NT_SERVER NT_SERVICES NT_SYSTEM

Using a Data Collection Table report, you can check if the parameters for the following Unix application classes and nodes are collected and stored in the DataStore on or after a given date: CPU DISK FILESYSTEM MEMORY NETWORK NFS SWAP USERS

BMC Software, Inc., Condential and Proprietary Information

Working with QuickReports

5-19

If data for Microsoft Exchange and Oracle is collected and stored in the DataStore, you can use the Data Collection Table report to investigate parameters of these applications. Use the Data Collection Table report to verify that data exists for the nodes, applications, parameters, and instances in your enterprise. That is, that the expected data is discovered, collected, and available. You can create the rst report based on the Data Collection Table template, then edit the report as many times as you need to create other similar reports.
Note

You need to change the le name of each new report template you create, if you want to keep the template. Editing a report template without changing its le name, overwrites the report template. After you select the report type and click Next in the QuickReport Editor, the Data Selection - Data Collection Table page displays. On this page, you nd the nodes and applications available for a report listed in their respective drop-down list boxes. Selecting a node or nodes determines the instances for the report. Selecting the application or applications determines the parameters for the report. Figure 5-7 shows a sample list of nodes available for Data Collection Table reports. The default selection is all [All] nodes.

BMC Software, Inc., Condential and Proprietary Information

5-20

Reporting User Guide

Figure 5-7

Data Collection Table Node Selection

Figure 5-8 shows a sample list of application classes available for Data Collection Table reports for Windows NT servers.

BMC Software, Inc., Condential and Proprietary Information

Working with QuickReports

5-21

Figure 5-8

Data Collection Table Application Selection

BMC Software, Inc., Condential and Proprietary Information

5-22

Reporting User Guide

Working with Solution Reports for Microsoft Windows 2000 Server

This chapter describes the Solution Reports for Microsoft Windows 2000 Server. Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2 Dening Windows Server Status Reports . . . . . . . . . . . . . . . . . . . . . 6-3 Dening Windows Server Parameter Reports . . . . . . . . . . . . . . . . . . 6-3 Dening Windows Server Service Availability Reports. . . . . . . . . . . 6-7 Interpreting Windows Server Solution Reports . . . . . . . . . . . . . . . . . 6-9

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Microsoft Windows 2000 Server

6-1

Overview
Solution Reports for Microsoft Windows 2000 Server provide a pre-dened set of reports for the management of your Windows 2000 Servers and Windows NT Servers. These reports provide the ability to analyze availability data across multiple Windows 2000 Server and Windows NT Server hosts in a distributed enterprise. You can highlight the enterprise-wide availability of a particular Windows service, or of the Windows host, or of selected server parameters that affect enterprise network availability and performance. Reports are based on Windows management data that is collected and deposited in the DataStore. The DataStore is the central database that contains both event and parameter information gathered from Windows PATROL Agents in your enterprise.

BMC Software, Inc., Condential and Proprietary Information

6-2

Reporting User Guide

Dening Windows Server Status Reports


Table 6-1 describes the reports that are part of the reporting solutions for Windows Servers that show Windows Server status and availability. Each report includes a summary bar graph and a more detailed trend line graph. You can view daily, weekly, or monthly data.
Table 6-1 Windows Server Status Reports

Report Title
5 Least Stable NT Servers

Description and Use


This report shows the top N servers based on the highest system downtime over a period of time. Use this report to locate and troubleshoot those servers with the most down time over a period of time.

5 Busiest NT Servers in CPU%

This report shows the top N busiest servers based on the highest total percentage of processor time used. Use this report to determine which servers are the busiest and could benet from the redistribution of system processes or the addition of central processing units.

Top 5 Servers in Processor Queue Length

This report shows the top N servers based on the largest processor queue length. Use this report to locate those servers with the longest processor queues.

Dening Windows Server Parameter Reports


This section describes the reporting solutions for various Windows Server parameters. Each report includes a summary bar graph and a more detailed trend line graph. You can view daily, weekly, or monthly data.

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Microsoft Windows 2000 Server

6-3

Describing Server Cache Parameter Reports


Table 6-2 describes the reports that show the status of Windows Server cache parameters.
Table 6-2 Windows Server Cache Parameter Reports

Report Title
5 Worst NT Cache Copy Read Requests

Description and Use


This report shows the top N servers based on the highest percentage of cache copy and cache read requests. Use this report to determine which servers have the most calls to the cache.

Describing Server CPU Parameter Reports


Table 6-3 describes the reports that show the status of Windows Server CPU parameters
Table 6-3 Windows Server CPU Parameter Reports

Report Title
5 Busiest NT Server CPUs (user time)

Description and Use


This report shows the top N busiest servers based on highest percent of user processor time. Use this report to locate the servers with the highest use of user processor time.

5 Busiest NT Server CPUs (processor time)

This report shows top N busiest servers based on the highest percent of process processor time. Use this report to locate the servers with the highest use of process processor time.

BMC Software, Inc., Condential and Proprietary Information

6-4

Reporting User Guide

Describing Server Logical Disk Parameter Reports


Table 6-4 describes the reports that show the status of Windows Server logical disk parameters.
Table 6-4 Windows Server Logical Disk Parameter Reports

Report Title
5 Highest NT Servers in Logical Disk Queue Lengths

Description and Use


This report shows the top N servers based on the highest logical disk queue lengths. Use this report to locate the servers with the highest logical queue disk length.

5 Highest NT Servers in Disk Time Percent

This report shows the top N servers based on the highest percent of disk time use. Use this report to locate servers with the highest logical disk use.

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Microsoft Windows 2000 Server

6-5

Describing Server Memory Parameter Reports


Table 6-5 describes the reports that show the status of Windows Server memory parameters.
Table 6-5 Windows Server Memory Parameter Reports

Report Title
5 Lowest NT Servers in Available Virtual Memory

Description and Use


This report shows the top N servers based on the least amount of virtual memory available. Use this report to nd and troubleshoot servers with the least available memory.

5 Highest NT Servers in Cache Faults Per second

This report shows the top N servers based on the highest measurement of memory cache faults per second. Use this report to nd and troubleshoot those servers with the highest number of memory cache faults per second.

5 HIghest NT Servers in Page Faults Per Second

This report shows the top N servers based on the highest measurement of memory page faults per second. Use this report to nd and troubleshoot those severs with the highest number of page faults per second.

5 Highest NT Servers in Disk Pages Per Second

This report shows the top N servers based on the highest measurement of disk pages per second. Use this report to locate the server with the highest number of disk pages per second.

BMC Software, Inc., Condential and Proprietary Information

6-6

Reporting User Guide

Dening Windows Server Service Availability Reports


This section describes the reporting solutions for various Windows Server services. Each report includes a summary bar graph and a more detailed trend line graph. You can view daily, weekly, or monthly reports. Table 6-6 describes the Service Availability (5 Least Available) reports for the various Windows Server services.
Table 6-6 Windows Server Service Availability Reports (Part 1 of 2)

Service
DHCP

Description and Use


This Service Availability report shows the top N servers where the service DHCP is the least available. Use this report to nd and troubleshoot those systems where DHCP is least available.

EventLog

This Service Availability report shows the top N servers where the service EventLog is the least available. Use this report to nd and troubleshoot those systems where EventLog is least available.

IISADMIN

This Service Availability report shows the top N servers where the service IISADMIN is the least available. Use this report to nd and troubleshoot those systems where IISADMIN is least available.

LanmanServer

This Service Availability report shows the top N servers where the service LanmanServer is the least available. Use this report to nd and troubleshoot those systems where LanmanServer is least available.

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Microsoft Windows 2000 Server

6-7

Table 6-6

Windows Server Service Availability Reports (Part 2 of 2)

Service
LanmanWorkstation

Description and Use


This Service Availability report shows the top N servers where the service LanmanWorkstation is the least available. Use this report to nd and troubleshoot those systems where LanmanWorkstation is least available.

LicenseService

This Service Availability report shows the top N servers where the service LicenseService is the least available. Use this report to nd and troubleshoot those systems where LicenseService is least available.

MSExchangeCCMC

This Service Availability report shows the top N servers where the service MSExchangeCCMC is the least available. Use this report to nd and troubleshoot those systems where MSExchangeCCMC is least available.

BMC Software, Inc., Condential and Proprietary Information

6-8

Reporting User Guide

Interpreting Windows Server Solution Reports


This section describes how to interpret Solution Reports for Microsoft Windows 2000 and NT Server. Each solution-specic report includes a summary graph or table and a detailed or trend graph. The summary graph is a bar graph that shows no greater than N components that have the highest or lowest values of a selected parameter. Each of the N components is represented by one bar. The length of the bar represents the value of the parameter. The trend or detailed graph is a line graph that shows N components with the highest or lowest values for a selected parameter over the time of the report. Each of the N lines represents a component. Data points on the line represent the unit measurement for the parameter. If the report is for a month, then the line contains a data point for each week of the month. If the report is for a day, each data point along the line represents an hour.
Note

When data is not found for a report, a blank report is created displaying the report header only.

Looking at Summary Graphs


Solution Reports for Windows Server display summary information in either of two formats: a bar graph or a table. Summary reports show the top or bottom parameter measurements for N number of components. Use these summary reports to show enterprise-wide availability of host servers or to show related measurements of enterprise-oriented parameters.

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Microsoft Windows 2000 Server

6-9

Figure 6-1 is a top N summary graph that shows the Windows Server CPU processor time percentage. The height of each bar represents the percentage of CPU processor uptime for the server over the 24 hour period. The key explains which color represents each server. This report gives you a good picture of those servers that you need to investigate further.
Figure 6-1 Summary Graph Showing Top NT CPU

For the trend graph that completes the Top CPU Usage report, see Figure 6-2 on page 6-11.

BMC Software, Inc., Condential and Proprietary Information

6-10

Reporting User Guide

Looking at Trend Graphs


The trend graph is a line graph that shows N components with the highest or lowest values for a selected parameter over the time of the report. Each of the N lines represents a component. Data points on the line represent the unit measurement for the parameter. Figure 6-2 is a sample trend graph that shows the average CPU processor time for your Windows Servers. Each color-coded symbol represents the hourly average downtime for a server. The key associates each symbol and color with a server instance. The trend graph provides more detail than the accompanying summary graph (see Figure 6-1 on page 6-10). You can see the hourly averages during the 24 hour period on the trend report. You can also tell during what time periods the downtime increased and during which time periods no information on a server was available.

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Microsoft Windows 2000 Server

6-11

Figure 6-2

Trend Graph Showing Top CPU Processor Time

BMC Software, Inc., Condential and Proprietary Information

6-12

Reporting User Guide

Working with Solution Reports for Unix


This chapter describes the Solution Reports for Unix.

Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2 Dening Unix Status and Availability Reports . . . . . . . . . . . . . . . . . 7-2 Dening Unix Performance Reports . . . . . . . . . . . . . . . . . . . . . . . . . 7-4 Dening Unix Capacity and Utilization Reports . . . . . . . . . . . . . . . . 7-5 Interpreting Solution Reports for Unix. . . . . . . . . . . . . . . . . . . . . . . . 7-7

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Unix

7-1

Overview
Solution Reports for Unix provide a predened set of reports for the management of your Unix systems. These reports provide the ability to analyze availability data across multiple Unix hosts in a distributed enterprise. You can highlight the enterprise-wide availability, performance, and capacity of a particular Unix host or of Unix system parameters. Reports are based on Unix management data that is collected and deposited in the DataStore. The DataStore is the central database that contains both event and parameter information gathered from Unix PATROL Agents in your enterprise.

Dening Unix Status and Availability Reports


Table 7-1 describes the reports that are part of the reporting solutions for Unix that show enterprise-wide Unix server status and availability. Each report includes a summary bar graph and a more detailed trend line graph. You can view daily, weekly, or monthly data.
Table 7-1 Unix Server Status Reports (Part 1 of 2)

Report Title
Top 10 Busiest Disks

Description and Use


This report shows the top N Unix servers in the enterprise based on those with the highest percentage of disk use. Use this report to determine which disks on what servers are the busiest. Use this information to plan system resources.

Top 10 Disk Read/Writes

This report shows the top N Unix servers based on the highest combination of disk reads and writes. Use this report to which disks on what servers are the busiest. Use this information to plan system resources.

BMC Software, Inc., Condential and Proprietary Information

7-2

Reporting User Guide

Table 7-1

Unix Server Status Reports (Part 2 of 2)

Report Title
Top 5 NFS Client Calls to Read and Write Data

Description and Use


This report shows the top N Unix servers with highest NFS average trafc. Use this report to help identify potential network bottlenecks.

% of NFS Server Calls to Read Data From Files (Top 5)

This report shows the top N Unix servers with the greatest percentage of NFS server calls to read data from les. Use this le to help identify potential network bottlenecks.

% of NFS Server Calls to Write Data To Files (Top 5)

This report shows the top N Unix servers based on the highest percentage of NFS server calls to write data to les. Use this report to help identify potential network bottlenecks.

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Unix

7-3

Dening Unix Performance Reports


Table 7-2 describes the reports that show the status of Unix system performance parameters. Each report includes a summary bar graph and a more detailed trend line graph. You can view daily, weekly, or monthly data.
Table 7-2 Unix Performance Parameter Reports (Part 1 of 2)

Report Title
Top 5 CPU Load

Description and Use


This report shows the top N Unix servers with the most CPU compute cycles available. Use this report to locate servers with available CPU compute time.

Top 5 CPU Utilization

This report shows the top N Unix servers with the greatest percentage of CPU time used. Use this report to locate the servers with the least CPU time available.

Top 5 Nodes of network Trafc

This report shows the top N Unix servers based on the highest total network trafc, packets in, packets out, and errors. Use this report to help identify potential network problems.

Top 5 Summary Swap Free Space

This report shows the top N Unix servers with the greatest amount of free space in a swap area. Use this report to locate servers with the most free swap space.

Bottom 5 Summary Swap Free Space

This report shows the top N Unix servers with the least amount of free space in a swap area. Use this report to locate servers with the least free swap space.

BMC Software, Inc., Condential and Proprietary Information

7-4

Reporting User Guide

Table 7-2

Unix Performance Parameter Reports (Part 2 of 2)

Report Title
Top 5 Summary Swap Used %

Description and Use


This report shows the top N Unix servers with the percentage or summary swap area used. This report shows the bottom N Unix servers with the percentage or summary swap area used This report shows the top N Unix servers by summary swap size. This report shows the bottom N Unix servers by summary swap size. This report shows the top N Unix servers with free memory. This report shows the top N Unix servers by memory page out. This report shows the top N Unix servers by memory page in.

Bottom 5 Summary Swap Used % Top 5 Summary Swap Size Bottom 5 Summary Swap Size Top 5 Free Memory Top 5 Memory Page Out Top 5 Memory Page In

Dening Unix Capacity and Utilization Reports


Table 7-3 describes the reports that show the status of Unix system capacity or utilization parameters. Each report includes a summary bar graph and a more detailed trend line graph. You can view daily, weekly, or monthly data.

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Unix

7-5

Table 7-3

Unix Capacity Parameter Reports

Report Title
Top 5 Highest Capacity

Description and Use


This report shows the top N Unix servers with the highest percentage of available space in use. Use this report to locate servers with the least le system space available for use.

Top 5 Lowest Capacity

This report shows the top N Unix servers with the least percentage of the available space in use. Use this report to locate servers with the most le system space available for use.

Top 5 Most Available Space

This report shows the top N Unix servers with the most available le system space. Use this report to determine what servers have the most le system space available.

Top 5 Least Available Space

This report shows the top N Unix servers with the least available le system space. Use this report to determine what servers have the least space available.

Top 5 Most Used Space

This report shows the top N Unix servers with the most used le system space. Use this report to determine what servers have the least available space.

Top 5 Least Used Space

This report shows the top N Unix servers with the least used le system space. Use this report to determine what servers have the most available space.

5 Highest User Counts

This report shows the top N Unix servers with the greatest number of users. Use this report to locate the servers with the greatest number of users.

5 Highest User Sessions

This report shows the top N Unix servers with the greatest number of user sessions.

BMC Software, Inc., Condential and Proprietary Information

7-6

Reporting User Guide

Interpreting Solution Reports for Unix


This section describes how to interpret Solution Reports for Unix. Each solution-specic report includes a summary graph or table and a detailed or trend graph, along with a cover page. The summary graph is a bar graph that shows no greater than N components that have the highest or lowest values of a selected parameter. Each of the N components is represented by one bar. The length of the bar represents the value of the parameter. The summary table is available for some reporting solutions. The left column in the table lists the top or bottom N servers and the associated PATROL parameter. Right-hand columns list the values for the N parameters. Reports with tabular format display more detailed information than the summary or trend graph, which can aid in troubleshooting. The trend or detailed graph is a line graph that shows N components with the highest or lowest values for a selected parameter over the time of the report. Each of the N lines represents a component. Data points on the line represent the unit measurement for the parameter. If the report is for a month, then the line contains a data point for each week of the month. If the report is for a day, each data point along the line represents an hour.
Note

When data is not found for a report, a blank report is created displaying the report header only.

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Unix

7-7

Looking at Summary Graphs


Solution reports may display summary information in either of two formats: a bar graph or a table. Summary reports show the top or bottom parameter measurements for N number of components. Use these summary reports to show enterprise-wide availability of host servers or to show related measurements of enterprise-oriented parameters.

Looking at Summary Tables


Summary table reports also show the top or bottom parameter measurements for N number of components. Reports in tabular form display more detailed information and can help in troubleshooting. The following is a sample summary table report that shows the Top 5 le system space used for your Unix servers. The left-most column contains the time.
Figure 7-1 Summary Table Showing Top 5 Space Used

BMC Software, Inc., Condential and Proprietary Information

7-8

Reporting User Guide

A summary bar graph with the same information would show only one of the value types: minimum, average, or maximum. You view more details in a summary table report than a summary bar graph. The type you choose depends on the information you require and the report templates available with your solution report package.

Looking at Trend Graphs


The second or third page of each solution report is a trend graph. The trend or detailed graph is a line graph that shows N components with the highest or lowest values for a selected parameter over the time of the report. Each of the N lines represents a component. Data points on the line represent the unit measurement for the parameter. The sample trend graph below shows the CPU Load for the Unix servers in your enterprise. Each color-coded symbol represents the CPU Load percentage for a server. The key associates each symbol and color with a server instance.

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Unix

7-9

Figure 7-2

Trend Graph Showing Top CPU

The trend graph provides more detail than the accompanying summary bar graph. You can see the hourly averages during the 24 hour period on the trend report. You can also tell during what time periods the disk usage increases or decreases and during which time periods no information on a server was available. This example shows that the average disk usage on a particular server did not change from one hour to the next.

The sample trend graph below shows the Unix servers with the Top 5 le system used space in your enterprise. Each color-coded symbol represents the le system space percentage for a server. The key associates each symbol and color with a server instance.

BMC Software, Inc., Condential and Proprietary Information

7-10

Reporting User Guide

Figure 7-3

Trend Graph Showing Top 5 File System Used Space

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Unix

7-11

Working with Solution Reports for Microsoft Exchange Server

This chapter describes the Solution Reports for Microsoft Exchange Server. Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2 Dening Microsoft Exchange Server Availability Reports . . . . . . . . 8-2 Dening Microsoft Exchange Server Performance Reports . . . . . . . 8-3 Dening Microsoft Exchange Server Capacity or Usage Reports . . . 8-4 Interpreting Solution Reports for Microsoft Exchange . . . . . . . . . . 8-7

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Microsoft Exchange Server

8-1

Overview
Solution Reports for Microsoft Exchange Server provides a pre-dened set of reports for the management of your Microsoft Exchange Server systems. These reports provide the ability to analyze availability, performance, and capacity data across multiple Microsoft Exchange Servers in a distributed enterprise. Reports are based on Microsoft Exchange Server management data that is collected and deposited in the DataStore. The DataStore is the central database that contains both event and parameter information gathered from Microsoft Exchange Server PATROL Agents in your enterprise.

Dening Microsoft Exchange Server Availability Reports


Table 8-1 describes the reports that are part of the reporting solutions for Microsoft Exchange Server that show server status and availability. Each report includes a summary bar graph and a more detailed trend line graph. You can view daily, weekly, or monthly data.
Table 8-1 Microsoft Exchange Status Reports

Report Title
Server Downtime (5 Least Available)

Description and Use


This report shows the top N Microsoft Exchange Servers based on those with the most downtime. Use this report to locate and troubleshoot the Microsoft Exchange Servers with the most downtime.

BMC Software, Inc., Condential and Proprietary Information

8-2

Reporting User Guide

Dening Microsoft Exchange Server Performance Reports


Table 8-2 describes the reports that are part of the Solution Reports for Microsoft Exchange Server that show server performance parameter data. Each report includes a summary bar graph and a more detailed trend line graph. You can view daily, weekly, or monthly data.
Table 8-2 Microsoft Exchange Performance Parameter Reports (Part 1 of 2)

Report Title
Top 5 Server Memory

Description and Use


This report shows the top N Microsoft Exchange Servers based on the highest memory usage. Use this report to locate servers with the highest use of memory.

Top 5 Sent Messages/Hour

This report shows the top N Microsoft Exchange Servers based on the highest average message send rates per hour of the top senders. Top senders is a value congured for a host by a menu command from the PATROL console. Use this report to locate servers of top message senders with the highest message send rates per hour.

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Microsoft Exchange Server

8-3

Table 8-2

Microsoft Exchange Performance Parameter Reports (Part 2 of 2)

Report Title
Top 5 Messages Received/ Hour

Description and Use


This report shows the top N Microsoft Exchange Servers based on the highest average message receive rate per hour of the top receivers. Top receivers is a value congured for a host by a menu command from the PATROL console. Use this report to locate servers of top message receivers with the highest message receive rates per hour.

5 Slowest Average Message Delivery

This report shows the top N Microsoft Exchange Servers based on the slowest delivery of messages to MTA. Use this message to determine and troubleshoot the servers with the slowest delivery to MTA.

Dening Microsoft Exchange Server Capacity or Usage Reports


Table 8-3 describes the reports that are part of the Solution Reports for Microsoft Exchange Server that show server capacity or utilization parameter data. Each report includes a summary bar graph and a more detailed trend line graph. You can view daily, weekly, or monthly data.

BMC Software, Inc., Condential and Proprietary Information

8-4

Reporting User Guide

Table 8-3

Microsoft Exchange Capacity or Utilization Reports (Part 1 of 2)

Report Title
Top 5 Count Private Folders

Description and Use


This report shows the top N Microsoft Exchange Servers based on the greatest number of private folders. Use this report to nd the servers with the greatest number of private folders.

Top 5 Count Public Folders

This report shows the top N Microsoft Exchange Servers based on the greatest number of public folders. Use this report to nd the servers with the greatest number of public folders.

Top 5 Count Server Messages

This report shows the top N Microsoft Exchange Servers based on the greatest number of server messages. Use this report to nd the servers with the greatest number of server messages.

Top 5 Server Message Sizes

This report shows the top N Microsoft Exchange Servers based on the largest message size (space). Use this report to nd the server with the largest message size.

Top 5 Count Client Connections

This report shows the top N Microsoft Exchange Servers based on the greatest number of client connections. Use this report to nd the server with the largest number of client connections.

Top 5 Max Folder Messages

This report shows the top N Microsoft Exchange Servers based on the greatest size of public folder messages. Use this report to nd the servers with the greatest public folder message sizes.

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Microsoft Exchange Server

8-5

Table 8-3

Microsoft Exchange Capacity or Utilization Reports (Part 2 of 2)

Report Title
Top 5 Count Messages Sent

Description and Use


This report shows the top N Microsoft Exchange Servers based on the highest average number of messages sent by top senders. Top senders is a value congured for a host by a menu command from the PATROL console.

Top 5 Count Messages Received

This report shows the top N Microsoft Exchange Servers based on the highest average number of messages received by the top receivers. Top receivers is a value congured for a host by a menu command from the PATROL console.

Top 5 Work Queue Size

This report shows the top N Microsoft Exchange Servers based on the measurement of the total volume of messages stored in the MTA in kilobytes.

BMC Software, Inc., Condential and Proprietary Information

8-6

Reporting User Guide

Interpreting Solution Reports for Microsoft Exchange


This section describes how to interpret Solution Reports for Microsoft Exchange Server. Each solution-specic report includes a summary graph or table and a detailed or trend graph. The summary graph is a bar graph that shows no greater than N components that have the highest or lowest values of a selected parameter. Each of the N components is represented by one bar. The length of the bar represents the value of the parameter. The summary table is available for some reporting solutions. The left column in the table lists the top or bottom N servers and the associated PATROL parameter. Right-hand columns list the values for the N parameters. Reports with tabular format display more detailed information than the summary or trend graph, which can aid in troubleshooting. The trend or detailed graph is a line graph that shows N components with the highest or lowest values for a selected parameter over the time of the report. Each of the N lines represents a component. Data points on the line represent the unit measurement for the parameter. If the report is for a month, then the line contains a data point for each week of the month. If the report is for a day, each data point along the line represents an hour.
Note

When data is not found for a report, a blank report is created displaying the report header only.

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Microsoft Exchange Server

8-7

Looking at Summary Graphs


Solution reports may display summary information in either of two formats: a bar graph or a table. Summary reports show the top or bottom parameter measurements for N number of components. Use these summary reports to show enterprise-wide availability of host servers or to show related measurements of enterprise-oriented parameters. Figure 8-1 is a top N summary graph that shows the Top 5 Microsoft Exchange Server private folders over a period of 24 hours. The height of the bar represents the private folder size during the 24 hour period. The key explains which color represents each server. This report gives you a good picture of those servers that you need to investigate further.
Figure 8-1 Summary Graph Showing Top 5 Exchange Private Folders

BMC Software, Inc., Condential and Proprietary Information

8-8

Reporting User Guide

Looking at Trend Graphs


The second or third page of each solution report is a trend graph. The trend or detailed graph is a line graph that shows N components with the highest or lowest values for a selected parameter over the time of the report. Each of the N lines represents a component. Data points on the line represent the unit measurement for the parameter. Figure 8-2 is a sample trend graph that shows the Top 5 Microsoft Exchange Server private folders over a period of 24 hours. Each color-coded symbol represents the folder size. The key associates each symbol and color with a server instance. The trend graph provides more detail than the accompanying summary bar graph (see Figure 8-1 on page 8-8). You can see the hourly averages during the 24 hour period on the trend report. You can also tell during what time periods the usage increases or decreases.
Figure 8-2 Trend Graph Showing Top 5 Exchange Private Folders

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Microsoft Exchange Server

8-9

BMC Software, Inc., Condential and Proprietary Information

8-10

Reporting User Guide

Working with Solution Reports for Oracle


This chapter describes the Solution Reports for Oracle.

Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2 Dening Oracle Availability Reports . . . . . . . . . . . . . . . . . . . . . . . . . 9-3 Dening Oracle Performance Reports . . . . . . . . . . . . . . . . . . . . . . . . 9-4 Dening Oracle Capacity Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-6 Interpreting Solution Reports for Oracle . . . . . . . . . . . . . . . . . . . . . . 9-7

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Oracle

9-1

Overview
Solution Reports for Oracle provide a predened set of reports for the management of your Oracle servers. These reports provide the ability to analyze data across multiple Oracle databases in a distributed enterprise. You can determine the enterprise-wide Oracle server availability, performance, and capacity. Reports are based on PATROL management data that is collected and deposited in the DataStore. The DataStore is the central database that contains both event and parameter information gathered from Oracle PATROL Agents in your enterprise.

BMC Software, Inc., Condential and Proprietary Information

9-2

Reporting User Guide

Dening Oracle Availability Reports


Table 9-1 describes the reports that are part of the Solution Reports for Oracle that measure availability parameters. Each report includes a trend line graph and a summary table. You can view daily, weekly, or monthly data.
Table 9-1 Oracle Availability Reports

Report Title
Oracle Lock Conicts (5 most frequent)

Description and Use


This report shows the top N Oracle database servers based on the most frequent lock conicts. Use this report to nd and troubleshoot the Oracle servers where most frequent lock conicts occur.

Oracle Space Allocation (Bottom 5)

This report shows the top N Oracle database servers based on the Oracle availability parameter Minimum Extents Left. Use this report to determine which database servers have space allocation problems.

Oracle Performance/Availability (Availability Report)

This report shows the status of the top/bottom N Oracle databases based serverss average response time and on the time the server was available. Use this report to determine what servers have the least or most downtime and what servers have the best or worst response times.

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Oracle

9-3

Dening Oracle Performance Reports


Table 9-2 describes the Solution Reports that show measurements for performance parameters. Each report includes a trend line graph and a summary table. You can view daily, weekly, or monthly data.
Table 9-2 Oracle Performance Reports (Part 1 of 2)

Report Title
Oracle Redo Rate

Description and Use


This report shows the top N Oracle database servers based on the lowest measurements of the Redo Rate. Use this report to nd database servers with slower than normal redo rates.

Oracle Transaction Rates (5 busiest)

This report shows top N busiest Oracle database servers based on the highest transaction rates. Use this report to nd database servers with the highest transaction rates.

Oracle Disk Sort Rate

This report shows the top N Oracle database servers based on the highest measurements of the Disk Sort Rate performance parameter. Use this report to track disk sort rate performance of the Oracle servers.

BMC Software, Inc., Condential and Proprietary Information

9-4

Reporting User Guide

Table 9-2

Oracle Performance Reports (Part 2 of 2)

Report Title
Oracle Lock Wait Ratio

Description and Use


This report shows the top N Oracle database servers based on the highest measurements of the Lock Wait Ratio performance parameter. Use this report to track the servers with the highest lock wait ratios.

Oracle Performance/Availability (Performance Report)

This report shows the status of the top/bottom N Oracle databases based serverss average response time and on the time the server was available. Use this report to determine what servers have the most up or down time and what servers have the best or worst response times.

Oracle SGA Reports


Table 9-3 describes the Solution Reports that show the measurements for SGA parameters. Each report includes a trend line graph and a summary table. You can view daily, weekly, or monthly data.
Table 9-3 Oracle SGA Reports

Report Title
Oracle Cache (Bottom 5)

Description and Uses


This report shows the top N database servers based on lowest cache hit ratio, lowest dictionary hit ratio and the lowest latch get ratio. Use this report to determine which Oracle servers have the fewest cache calls.

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Oracle

9-5

Dening Oracle Capacity Reports


Table 9-4 describes the Solution Reports that show the status of capacity parameters. Each report includes a trend line graph and a summary table. You can view daily, weekly, or monthly data.
Table 9-4 Oracle Capacity Reports

Report Title
Oracle Capacity (5 to Watch)

Description and Use


This report shows the top N Oracle servers based on the lowest values of the Oracle capacity parameters: Cursors Left, Locks Free, Processes Left, Sessions Left, and Transactions Left. Use this report to locate Oracle servers that are approaching their capacity.

Oracle Session Count (5 busiest)

This report shows the top N busiest Oracle database servers based the highest number of user sessions. Use this report to locate the database servers with the most users.

BMC Software, Inc., Condential and Proprietary Information

9-6

Reporting User Guide

Interpreting Solution Reports for Oracle


This section describes how to interpret Solution Reports for Oracle. Each solution-specic report includes a summary graph or table and a detailed or trend graph. The summary graph is a bar graph that shows no greater than N components that have the highest or lowest values of a selected parameter. Each of the N components is represented by one bar. The length of the bar represents the value of the parameter. The summary table is available for some reporting solutions. The left column in the table lists the top or bottom N servers and the associated PATROL parameter. Right-hand columns list the values for the N parameters. Reports with tabular format display more detailed information than the summary or trend graph, which can aid in troubleshooting. The trend or detailed graph is a line graph that shows N components with the highest or lowest values for a selected parameter over the time of the report. Each of the N lines represents a component. Data points on the line represent the unit measurement for the parameter. If the report is for a month, then the line contains a data point for each week of the month. If the report is for a day, each data point along the line represents an hour.
Note

When data is not found for a report, a blank report is created displaying the report header only.

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Oracle

9-7

Looking at Trend Graphs


The second or third page of each solution report is a trend graph. The trend or detailed graph is a line graph that shows N components with the highest or lowest values for a selected parameter over the time of the report. Each of the N lines represents a component. Data points on the line represent the unit measurement for the parameter. Figure 9-1 is a sample trend graph that shows the Top 5 Oracle users in your enterprise for a period of 24 hours. Each color-coded symbol represents the user percentage. The key associates each symbol and color with a server instance. You can see the hourly averages during the 24 hour period on the trend report. You can also tell during what time periods usage increases or decreases or during which time periods no information on a server was available. This report shows that four of the ve Oracle database server instances might require watching.

BMC Software, Inc., Condential and Proprietary Information

9-8

Reporting User Guide

Figure 9-1

Trend Graph Showing Top 5 Oracle Users

BMC Software, Inc., Condential and Proprietary Information

Working with Solution Reports for Oracle

9-9

Looking at Summary Tables


Solution reports may display summary information in either of two formats: a bar graph or a table. Summary reports show the top or bottom parameter measurements for N number of components. Use these summary reports to show enterprise-wide availability of host servers or to show related measurements of enterprise-oriented parameters. Summary reports in tabular form display more detailed information, which can help in troubleshooting. Figure 9-2 is a sample daily summary table report that shows the Oracle Users on a specic day. The left column contains the sever name and parameter. The right columns show the associated units of measurement, and the minimum, average, and maximum values recorded for each parameter. This report shows the daily minimum, average, and maximum values for ve capacity parameters (Cursors Left, Locks Free, Processes Left, Sessions Left, and Transactions Left) for ve database server instances.
Figure 9-2 Summary Table Showing Oracle Users

BMC Software, Inc., Condential and Proprietary Information

9-10

Reporting User Guide

Glossary
1 1Review copyRrr

Glossary
Actuate Live Report Extension (LRX)

A Web browser plug-in that an end user can use to nd, view, and print reports (not generate reports) accessed over the Internet. Component of Service Reporting used to manage the Report Server. Using the Administrator Desktop, you can add or remove report executables and documents, generate reports, set and maintain user information, and congure security for report server resources. A component that compiles the information collected from one or more retrievers and stores the data in the DataStore as raw and summarized data. See data aggregator A way to classify related namespace data (application classes, application instances, and parameters) used for a common purpose. Data can be associated by location, organization, and category. The subject of a measurement or event. Examples in PATROL include, an Oracle database instance; a host running a Windows NT server.

Administrator Desktop

aggregator

associations

component

BMC Software, Inc., Condential and Proprietary Information

Glossary

data aggregator

A data aggregator receives event and parameter data from retrievers and forwards that data to the DataStore. Data aggregators control the DataStores summarizing activities, normalize and synchronize time values between different data sources, control and monitor a retrievers status, and downloads conguration parameters to a retriever. A process that converts raw data located in the DataStore into summary data. When raw data is converted, it is organized into the summary time periods of hourly, daily, weekly, and monthly summary values of maximum, average, sum, standard deviation, and variance. The summarized data is then used in the QuickReport Editor and Solution Reports. The DataStore is the database used by Service Reporting to store parameter and event data collected from your PATROL environment. The database stores raw data, measurement values, and time-summarized measurements. Time-summarized measurements are the inputs to reports. The DataStore Console is the graphical user interface (GUI) for the DataStore. With the DataStore Console, you can determine what data is collected, as well as monitor and maintain aggregators and retrievers. The knowledge module (KM) that Service Reporting uses to congure and monitor DataStore components, including data aggregators and retrievers. The DataStore KM lets you congure local or remote data aggregators and retrievers, as well as start, stop, and monitor the current status or performance of these components. See Knowledge Module (KM). While viewing a report, the ability to view the same information in more detail as part of the same report. A command line utility that lets you save parameter history data from databases on PATROL Agents to ASCII text les.

data summarization

DataStore

DataStore Console

DataStore KM

drill down

dump_hist utility

BMC Software, Inc., Condential and Proprietary Information

Reporting User Guide

End User Desktop

On Windows NT platforms, a graphical user interface that end users can use to request local report generation, as well as local printing and viewing of reports. All the components, measurements, and events in the PATROL Datastore valid for a given time. A subset of the components, measurements, and events stored in the DataStore for a given time span. Examples include: all Windows NT nodes located in Houston and their KM parameter values for yesterday all Microsoft Exchange servers on nodes whose name starts hou and their Exchange KM parameter TotalMsgSize averaged daily for the last week

enterprise

enterprise view

event lter

Created in the DataStore Console, an event lter controls the collection of event data. Criteria an event lter may contain includes type, status, and severity. An event lter lets you collect information, state change, error, and warning events. A component that collects data when an event matches criteria specied in the event lter. Once the event occurs, the event retriever forwards the raw event data to the data aggregator. A lter is used to determine what information is collected. Service Reporting uses the following lters: history lterscollect parameter information event lterscollect event information

event retriever

lters

generic report

A presentation (graph, table, or chart) generated by specifying parameters, selection criteria, and labels using the QuickReport Editor.

BMC Software, Inc., Condential and Proprietary Information

Glossary

history lter

A history lter lets you specify what parameter data is collected from a PATROL Agent. Parameter data you can collect depends upon the KMs installed on the agent being queried. Once dened, you must add the history lter to at least one history lter group before it can start gathering parameter data. See history lter group. A history lter group is the mechanism that forwards history lter settings to the data aggregator. The data aggregator sends the history lter settings to a retriever, which uses the settings to determine what data to collect. All history lters must belong to one or more history lter groups. A process that collects parameter information from an agents local cache. To provide a set of denitions and instructions to be used as a starting point for a component or executable. Usually, you can redene these settings at any point. A computer or discovered application that is running in the PATROL-managed environment. An instance has all the attributes of the class that it belongs to. A computer instance is a monitored computer that has been added to the PATROL Console. An application instance is discovered by PATROL. See associations. The time unit, for example hour, day, week, month, and year. See Knowledge Module (KM). A list of KMs to be loaded by a PATROL Agent. See also Knowledge Module (KM).

history lter group

history retriever

initialize

instance

interval type KM KM list

BMC Software, Inc., Condential and Proprietary Information

Reporting User Guide

KM tree

A feature of PATROL for Windows NT only. One of two views of folders available in Windows NT. The KM tree displays computer classes, application classes, and their customized instances in the knowledge hierarchy and also displays the Standard Event Catalog. A PATROL Operator Console can only view the KM tree; only the PATROL Developer Console can change KM properties and attributes. See also Knowledge Module (KM). A set of les from which a PATROL Agent receives information about resources running on a monitored computer. A KM le can contain the actual instructions for monitoring objects or simply a list of KMs to load. KMs are loaded by a PATROL Agent and a PATROL Console. KMs provide information for the way monitored computers are represented on the PATROL Desktop, for the discovery of application instances and the way they are represented, for parameters that are run under those applications, and for the options available on object menus. A PATROL Developer Console can change KM knowledge for its current session, save knowledge for all of its future sessions, and commit KM changes to specied PATROL Agent computers. See also KM list, KM tree, and load KMs.

Knowledge Module (KM)

load applications

Same as load KMs; most KMs are composed of application les with a *.kml extension. To place KM les into memory for execution. After conguration and during startup, the PATROL Agent loads the KM les that are listed in its conguration le and that reside on the PATROL Agent machine. When a PATROL Console connects to the PATROL Agent, the KM versions that the Agent executes depend on whether the Console is an Operator Console or a Developer Console. See also Knowledge Module (KM). The history (stored parameter values) for an object or instance. The user-dened length of time during which stored parameter values for an object or instance are retained.

load KMs

local history local history retention period

BMC Software, Inc., Condential and Proprietary Information

Glossary

manual collection

Lets you start or stop collection of parameter data regardless of the settings in a history lter. Manual collection lets you be very specic about what data is or is not collected. Once you use manual collection, those settings remain in effect until you clear them. Process that reads a comma separated value le and lets you load dump_hist data into the DataStore. See retrievers A graphical user interface that you can use to create new reports based on generic report templates to meet your management reporting requirements. A series of dialogs help you dene the input parameters for your report. One of several report denitions or templates that a user can select to generate a specic report. The denition includes a visual presentation and a list of parameters that control the presentation a family of content and a list of required parameters to specify the content

open data retriever

QuickReport Editor

QuickReport Template

For example, the top/bottom N summary graph denes the visual presentation as a bar graph and denes the input as at the most N rows of data, sorted in ascending or descending order.
report

Generated presentations (graphs, tables, or charts) based on stored PATROL event and parameter data that you can view remotely using a Web browser on supported platforms. Person who locates, runs, schedules, and views report documents.Typically, this person is a manager or senior IT professional in charge of managing a portion of the enterprise infrastructure.

report consumer

BMC Software, Inc., Condential and Proprietary Information

Reporting User Guide

report composer

Person who creates schedules and runs report templates, creates new report templates, and ensures that the necessary data is being collected. Typically, this person is a technical IT professional who needs certain kinds of PATROL information to appear in reports. A component of Service Reporting that is used to control access to reporting data. With the report server, you can: manage users request (on-demand reports with run-time parameters) control the report encyclopedia and validate users and requests generate report instances print reports manage persistent objects, such as report instances, folders, users, and roles

Report Server

report store administrator

A person who installs and sets up components, and periodically cleans up the report store/encyclopedia (removes or archives old reports, removes unused report templates, and the like). Report templates (RTs) are denitions for Service Reporting that direct Service Reporting to extract data from the DataStore for a given time span and generate a presentation in the form of a graph, table, or chart. Components that compile, lter, and forward agent data to an aggregator. Aggregrators send lter settings to the retrievers that specify which parameter data and event data to collect. Service Reporting includes the following types of retrievers: History Retrievercollects parameter data from an agents local cache Event Retrievercollects event data Open Data Retrieverreads a comma separated value le and lets you load dump_hist data into the DataStore

report template

retrievers

BMC Software, Inc., Condential and Proprietary Information

Glossary

ROI les

Report document les. The reports that you view and print. ROI les are stored in the Report Encyclopedia. You can use the End User Desktop or the Administrator Desktop to create report document les. Parameter value les. The les that store parameter values specied for a specic report executable. The values in the le lter the data for a report document. You use a parameter values les to generate a report with a specied set of criteria. Report template executable les. The les that you execute to generate report documents with current data. A package of report templates created for the management of a particular technology or application. The reports require little or no user setup. A particular interval dened by its interval type and start time, for example, week of October 10, 1999. For simple time spans, the interval type. For nested time spans, the interval type and number of sub-intervals, for example, weekly span shown as 168 hours. Component of Service Reporting that provides access to reporting. Using the Web Desktop, you can view contents of the Report Encyclopedia, create your own reports with the QuickReport Editor, and generate, schedule, locate, view, print, and distribute reports. On Windows NT platforms, an application that an end user can use to print and view reports.

ROV les

ROX les

Solution Reports

time span

time span type

Web Desktop

Windows NT Viewer

BMC Software, Inc., Condential and Proprietary Information

Reporting User Guide

Index

Index
A
Actuate components of Service Reporting 1-3 desktop applications 2-3 documentation xi Actuate Administrator Desktop 1-4 Actuate Viewer 1-6 Administration 2-8 Administrative directory 1-5 administrator privileges needed for access 2-7 Administrator Desktop 1-5 available space 5-7 CPU utilization 5-7 CPU utilization or load 5-7 Creating reports 4-2

D
Data Collection Table 4-2, 5-6 DataStore Unix data 7-2 Windows NT data 6-2 Deleting reports 4-16 Details icon 2-8 disk reads and writes 5-7 document conventions xiv documentation related x Documents 2-8

B
Basic reporting concepts 1-7 blank reports 7-7 BMCReports 4-29 busiest disks 5-7

E
Editing reports 4-12 End User Desktop 1-5 Enterprise Events and Measurements 5-7 Enterprise Hot Spots 5-15 Event Summary Table 4-2 Examining Server CPU Usage 3-7

C
cache usage 5-7 conventions,document xiv
BMC Software, Inc., Condential and Proprietary Information

Index

Exchange server availability reports 8-2 server capacity and usage reports 8-4 server performance parameter data 8-3 server performance reports 8-3 solution reports 8-7 summary graphs 8-8 trend graphs 8-9 view daily data 8-3 view data 8-3 view monthly data 8-3 view performance reports 8-3 view weekly data 8-3 Exchange Server Solution Reports for 3-18

for Netscape 2-5 Java Virtual Machine 2-5

L
Locating Servers with low Message Space 3-5 logical and physical disk usage 5-7

M
memory availability 5-7 Microsoft Exchange PATROL Agents 8-2 Microsoft Internet Explorer 2-5 My Documents link on Web Desktop 2-9 My Headlines 2-8 My Prole 2-8

F
Finding Server Hot Spots 3-10

H
Help link on Web Desktop 2-9 Hot Spot Information 3-20 Hot Spots 5-5 Hot Spots Table 4-2 Hot Spots Threshold Table 4-2

N
Netscape Navigator 2-5 New reports creating using the QuickReport Editor 4-3 NFS read and write calls 5-7

I
incoming network packets 5-7 Internet Explorer 2-5

O
online documentation xiii Oracle availability reports 9-3 capacity reports 9-6 PATROL Agents 9-2 performance reports 9-4 server availability 9-2

J
Java plug-in
BMC Software, Inc., Condential and Proprietary Information

Reporting User Guide

SGA reports 9-5 Solution Reports for 3-18 Oracle Solution Reports 1-4

P
Parameter Collection verifying 3-13 Parameters for QuickReports 4-2 PATROL data deposited in the DataStore 9-2 events 1-3 management data 9-2 parameters 1-3 PATROL application classes 3-19 Planning solution-specic reporting 3-15 Predened reports 1-3 Solution Reports 1-3 Print/Download link 4-33 Printing Reports 4-33

nding 2-11 interpreting 5-3 locating and viewing 4-29 planning 3-4 scenarios 3-4 scheduling 4-19 using the QuickReport Editor 3-4

R
related documentation xiii related publications x release notes xiii Report Encyclopedia 1-3, 1-5 accessing 2-5 navigation of 2-8, 2-9 remote access 1-5 requirements for the Web page 2-5 Tab pages 2-8 Web access 1-5 Web page 2-7 Report item directory 1-5 Report Object Value (.ROV) 4-24 Report Server 1-3, 1-4 functions of 1-4 parameter value les 4-23 Report viewers 1-3, 1-5 overview 1-5 Reporting overview 2-2 planning 2-2 Reporting concepts overview 1-7 understanding 1-7 Reports locating and viewing 4-28 scheduling and generating 4-19 Requests 2-8 Requests directory 1-5

Q
QuickReport Editor 1-3 copy and modify reports 2-3 creating new reports 4-2 customized report templates 3-18 dene new reports 2-3 delete reports 2-3 introduction to 1-3 Oracle reports 3-22 planning your reporting strategy 3-4 reporting checklist 3-4 QuickReport types 3-2 description of 3-2 QuickReports creating report templates 4-2
BMC Software, Inc., Condential and Proprietary Information

Index

S
Sample trend graph Exchange Servers 8-9 Saving reports as .PDF 4-33 Scheduling directory 1-5 Server CPU Usage examining 3-7 Server Hot Spots nding 3-10 Servers locating with low Message Space 3-5 Service Reporting Actuate Software Corporation components 1-3 BMC Software components 1-3 components of 1-3 features and benets 1-2 introducing report types and templates 3-2 Solution Report generate and schedule 4-24 Solution Reporting Checklist 3-16 Solution Reports 1-3 checklist for 3-16 for Microsoft Exchange 1-4 for Microsoft Exchange Server 1-4 for Microsoft Windows 2000 Server 1-4 for Oracle 1-4, 9-2 for Unix 1-4 for Windows 2000 1-4 generating 4-23 locating and viewing 4-30 planning 3-15 Solution specic reporting 3-15 Summary Graph 4-2, 5-3 report parameters 3-6 Summary Table 4-2

T
Top 10 Busiest Disks 7-2 Top 10 Disk Read/Writes 7-2 Trend Graph 4-2 Trend Graph (Multi-Parameter) 4-2 Trend Graphs 6-10 Trend Table 4-2 Trend Table (Multi-Parameter) 4-2

U
Unix capacity and utilization reports 7-5 capacity parameters 7-5 data stored in DataStore 7-2 performance parameters 7-4 performance reports 7-4 Solution Reports 7-7 status and availability reports 7-2 summary graphs 7-7 summary tables 7-8 trend graphs 7-9 utilization parameters 7-5 Unix reports overview 7-1 Unix server parameters investigation of 5-7 Unix Servers locating heavy usage 3-17 user or session counts 5-7

V
Verifying Parameter Collection 3-13

BMC Software, Inc., Condential and Proprietary Information

Reporting User Guide

W
Web browsers required for reporting 2-5 Web Desktop using 2-5 web user interface 1-3 Windows NT looking at enterprise-wide parameters 5-7 PATROL Agents 6-2 server status 6-3 Solution Reports 6-9 summary graphs 6-9 Windows NT Reports availability 6-7 server cache parameter 6-4 server CPU parameter 6-4 server logical disk parameter 6-5 server memory parameter 6-6 server parameter 6-3 server status 6-3 Windows NT Servers selecting for upgrading 3-16

BMC Software, Inc., Condential and Proprietary Information

Index

BMC Software, Inc., Condential and Proprietary Information

Reporting User Guide

Notes

*100031050* *100031050* *100031050* *100031050*


*100031050*

You might also like