Beruflich Dokumente
Kultur Dokumente
User Guide
Monitoring and Managing with PATROL
Volume 2
Version 3.5
iii
• 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
iv PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Contents
Contents
Contents v
Methods for Viewing Information about Parameters . . . . . . . . . . . . .2-8
Types of Information Available about Parameters . . . . . . . . . . .2-9
Types of Parameter Charts and Graphs Available . . . . . . . . . . . .2-9
Parameter Information Viewed as Charts and Graphs . . . . . . . . . . . .2-11
What the PATROL Console Charting Server Is . . . . . . . . . . . . . .2-12
PATROL Console Charting Server Main Window . . . . . . . . . . .2-12
Files Used by the PATROL Console Charting Server . . . . . . . . .2-13
What You Can Do with the PATROL Console Charting Server .2-15
Manipulation of Data Shown in the Chart or Graph . . . . . . . . . .2-20
Creating a New Graph Folder . . . . . . . . . . . . . . . . . . . . . . . . . . .2-21
Saving the Attributes of a Chart or Graph . . . . . . . . . . . . . . . . . .2-22
Displaying Annotated Data Points . . . . . . . . . . . . . . . . . . . . . . .2-23
Removing Parameters from Existing Charts . . . . . . . . . . . . . . . .2-24
Viewing Data History for a Parameter . . . . . . . . . . . . . . . . . . . .2-26
Plotting Data from Specific Time Periods . . . . . . . . . . . . . . . . . .2-27
Manipulation of Data Shown in the Chart or Graph . . . . . . . . . .2-28
Using Optional Chart Views . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-29
Displaying Data Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-31
Displaying Data Point Coordinates . . . . . . . . . . . . . . . . . . . . . . .2-32
Rotating a Chart in 3-D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-33
Using the Zoom Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-34
Customizing the Chart Window and Data Area . . . . . . . . . . . . .2-35
Chart Axes Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-38
Chart Chart Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-39
Chart Gridline Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-41
Chart Title Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-42
Chart Legend Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-43
Chart Data Series Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-45
Parameter History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-47
Methods of Manipulating Parameter History . . . . . . . . . . . . . . .2-47
Viewing Parameter Value History . . . . . . . . . . . . . . . . . . . . . . . .2-49
Methods for Manipulating Parameters . . . . . . . . . . . . . . . . . . . . . . . .2-49
Snoozing an Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-50
Refreshing All Parameters for a Computer Instance . . . . . . . . . .2-51
Refreshing All Parameters for an Application Instance . . . . . . .2-52
Overriding Application Discovery Properties . . . . . . . . . . . . . . .2-53
Overriding Parameter Attributes . . . . . . . . . . . . . . . . . . . . . . . . .2-55
vi PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Management of Computers, Applications, and Parameters as Groups 3-2
Creating a Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Moving an Object into a Folder . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
Removing an Object from a Folder . . . . . . . . . . . . . . . . . . . . . . . 3-7
Deleting a Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8
Shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
Creating a Shortcut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10
Removing a Shortcut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
Contents vii
Chapter 6 Use of the Agent Query
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-3
Components of the Agent Query Window . . . . . . . . . . . . . . . . .6-3
Components of the Query Results Window . . . . . . . . . . . . . . . .6-7
Agent Query Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-13
Examples of Using Agent Query . . . . . . . . . . . . . . . . . . . . . . . . .6-15
Creating a Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-15
About Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-16
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-16
Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-17
Creating a Query with Quick Query . . . . . . . . . . . . . . . . . . . . . .6-18
Creating Your Own Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-20
Where to Go from Here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-25
Modifying a Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-26
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-26
Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-26
Modifying a Query with Quick Query . . . . . . . . . . . . . . . . . . . .6-27
Modifying a Query with the SELECT and WHERE Boxes . . . .6-28
Modifying Queries with the Query Box Buttons . . . . . . . . . . . .6-30
Where to Go from Here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-32
Issuing a Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-32
Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-33
Issuing a Query from the Agent Query Window . . . . . . . . . . . . .6-34
Where to Go from Here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-34
Using Query Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-35
Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-35
Selecting Rows in the Query Results Table . . . . . . . . . . . . . . . . .6-36
Sorting Objects in the Query Results Table . . . . . . . . . . . . . . . . .6-40
Setting the Display of Table Columns . . . . . . . . . . . . . . . . . . . . .6-43
Resizing Columns in the Query Results Table . . . . . . . . . . . . . .6-44
Scheduling a Query for Reissue . . . . . . . . . . . . . . . . . . . . . . . . .6-45
Disabling Scheduled Reissue of Queries . . . . . . . . . . . . . . . . . . .6-47
Reissuing a Query at Random . . . . . . . . . . . . . . . . . . . . . . . . . . .6-48
Hiding a Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-49
Working with Results of a Different Query . . . . . . . . . . . . . . . . .6-50
Where to Go from Here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-50
Managing Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-51
Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-51
Adding Objects to Containers or Graphs . . . . . . . . . . . . . . . . . . .6-52
Connecting Computers to PATROL Agents . . . . . . . . . . . . . . . .6-54
viii PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Disconnecting Computers from PATROL Agents . . . . . . . . . . . 6-55
Finding an Object’s Container . . . . . . . . . . . . . . . . . . . . . . . . . . 6-56
Opening Containers, Gauges, and Graphs . . . . . . . . . . . . . . . . . 6-57
Creating Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-58
Snoozing Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-59
Resetting Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-61
Where to Go from Here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-61
Saving Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-61
Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-61
Saving a Query in the Agent Query Window . . . . . . . . . . . . . . . 6-63
Saving Results of a Query in the Query Results Window . . . . . 6-64
Exporting Query Results to a Text File . . . . . . . . . . . . . . . . . . . . 6-65
Where to Go from Here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-65
Using Saved Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-65
Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-66
Using a Saved Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-67
Using Saved Query Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-68
Saving Changes to Query Files . . . . . . . . . . . . . . . . . . . . . . . . . . 6-69
Where to Go from Here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-69
Closing and Exiting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-70
Contents ix
Setting a Persistent Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-32
Viewing a Persistent Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-33
How to Sort Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-34
Sorting Events in the PEM Window . . . . . . . . . . . . . . . . . . . . . .7-35
How to Manage Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-36
Making an Entry in the Event Diary . . . . . . . . . . . . . . . . . . . . . .7-38
Acknowledging, Closing, or Deleting a Single Event . . . . . . . . .7-41
Performing Matching Operations . . . . . . . . . . . . . . . . . . . . . . . .7-43
How to Generate Event Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-44
Displaying Statistics for Multiple PATROL Agents . . . . . . . . . .7-46
Displaying a PEM Window Statistics Report . . . . . . . . . . . . . . .7-49
Closing the PEM Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-51
Index
x PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Tables
Tables
Tables xi
Table 5-2 Tasks for Managing the PATROL Agent . . . . . . . . . . . . . . . . . . 5-3
Table 6-1 File Menu in the Agent Query Window . . . . . . . . . . . . . . . . . . . 6-5
Table 6-2 Quick Query Menu in the Agent Query Window. . . . . . . . . . . . 6-5
Table 6-3 Button Bar in the Agent Query Window . . . . . . . . . . . . . . . . . . 6-7
Table 6-4 File Menu in the Query Results Window . . . . . . . . . . . . . . . . . . 6-9
Table 6-5 Edit Menu in the Query Results Window. . . . . . . . . . . . . . . . . . 6-9
Table 6-6 View Menu in the Query Results Window . . . . . . . . . . . . . . . . . 6-10
Table 6-7 Actions Menu in the Query Results Window . . . . . . . . . . . . . . . 6-11
Table 6-8 Query Results Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-12
Table 6-9 Button Bar in the Query Results Window . . . . . . . . . . . . . . . . . 6-13
Table 6-10 Examples of Using Agent Query . . . . . . . . . . . . . . . . . . . . . . . . 6-15
Table 7-1 Event Type Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5
Table 7-2 PEM Window Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-6
Table 7-3 Event Repository Statistics Window Menu Bar . . . . . . . . . . . . . 7-11
Table 7-4 Tasks Available from the View menu . . . . . . . . . . . . . . . . . . . . . 7-17
Table 7-5 Information Items of the Event Details Dialog Box. . . . . . . . . . 7-23
Table 7-6 Using wildcard characters to filter events . . . . . . . . . . . . . . . . . 7-30
Table 7-7 Column Headings in the PEM Window . . . . . . . . . . . . . . . . . . . 7-34
Table 7-8 Information Items in the Event Repository Statistics Window . 7-47
xii PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Figures
Figures
Figures xiii
Figure 7-8 Window Statistics Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . 7-13
Figure 7-9 Sorting the PATROL Event Manager Window. . . . . . . . . . . . . . 7-15
Figure 7-10 Event Details Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-23
Figure 7-11 Filter Window Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-28
Figure 7-12 Real-Time Event Updates in a Multiuser Environment . . . . . . . 7-37
Figure 7-13 Event Diary Text Editor Dialog Box . . . . . . . . . . . . . . . . . . . . 7-39
Figure 7-14 Toolbar Buttons for Managing Events . . . . . . . . . . . . . . . . . . . . 7-42
Figure 7-15 Event Repository Statistics Window . . . . . . . . . . . . . . . . . . . . 7-47
Figure 7-16 PEM Window Statistics Report . . . . . . . . . . . . . . . . . . . . . . . . 7-50
xiv PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
About . . .
This book also contains instructions for loading and configuring the
PATROL Knowledge Module™ (KM). For more details, refer to the
online Help for the KM.
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.
xvi PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Chapter Title Purpose
4 Using Commands and Contains information about using
Tasks commands and tasks. It describes the
differences between commands and
tasks, lists the methods available for
running commands and tasks and
viewing the resulting output.
5 Management of the Contains information about managing
PATROL Agent the PATROL Agent. It provides
information regarding the self-tuning
ability of the PATROL Agent as well as
instructions for tasks you can perform
to manage the PATROL Agent.
6 Use of the Agent Query Provides an overview of using the
Agent Query function to query the
PATROL agent for monitored objects.
7 Management of Events Contains overview information about
managing events using the PATROL
Event Manager.
Index Index Lists index entries for Volume 2.
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 request a user name and password by registering
at the support page or by contacting a BMC Software sales
representative.)
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 product’s Help menu. The
online Help provides information about the product’s graphical user
interface (GUI) and provides instructions for completing tasks.
Release Notes
The latest versions of the release notes are also available on the Web at
http://www.bmc.com/support.
xviii PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Conventions
The following conventions are used in this book:
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 clarifies a concept discussed in text.
Tip
A tip provides useful information that may improve product performance
or make procedures easier to follow.
system/instance/file_name
a | b | c
• The following table shows equivalent mouse buttons for Unix users
and Microsoft Windows users:
xx PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Unix Button Windows Button Description
MB1 left mouse button Click this button on an
icon or menu command to
select that icon or
command. Click MB1 on a
command button to initiate
action. Double-click an
icon to open its container.
MB2 not applicable Click this button on an
icon to display the InfoBox
for the icon. To simulate
MB2 on a two-button
mouse, simultaneously
press the two buttons
(MB1 and MB3).
MB3 right mouse button Click this button on an
icon to display its pop-up
menu.
Note
If you have a one-button mouse (such as an Apple Macintosh mouse),
assign MB1 to that button. You should also define a user-selectable
combination of option and arrow keys to simulate MB2 and MB3. For
details, refer to the documentation for your emulation software.
xxii PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
1
Icon Display
Examples State Characteristics Description
void; connection round, gray base The PATROL Console cannot connect to
cannot be (yellow triangle at the computer for one of the following
established upper right may or reasons:
may not be • computer is offline, shutdown, or not
displayed) accessible
• connection between the computer and
the PATROL Console is down or not
functioning correctly
void; connection broken square base The PATROL Console is no longer
previously that is connected to the computer for one of the
established but • flashing red and following reasons:
now broken yellow, if user • computer went down
preference is set • PATROL Agent stopped running
• gray, if user • network connection failed
preference is not
set
1-2 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Table 1-1 Computer Icon States (Part 2 of 2)
Icon Display
Examples State Characteristics Description
OK; no output round, white base None of the application parameters are
messages in warning or alarm state; the system
pending output window does not contain new
messages from the OS or the PATROL
Agent.
OK; output round, white base; None of the application parameters are
messages yellow triangle at in warning or alarm state; the system
pending upper right output window contains new messages
(new data) from the OS or PATROL Agent.
Icon Display
Examples State Characteristics Description
offline; depending on the PATROL Agent can no longer monitor
application KM definition, can the application for one of the following
previously be reasons:
discovered and • round, gray base • application is offline, shutdown, or not
connected but • square, flashing accessible
now red and yellow • application has been changed or
disconnected base upgraded, and the KM does not know
about the changes
OK round, white base None of the application parameters are
in warning or alarm state.
1-4 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Parameter Icon States
A parameter’s icon indicates the parameter’s status. Parameter icons are
displayed in object windows, the Desktop tree, and the KM tree.
Icon
Examples State Display Characteristics Description
offline round, gray base The parameter is not running for
one of the following reasons:
• PATROL Agent has not yet run
the parameter.
• Parameter is not functioning
properly.
Icon
Examples State Display Characteristics Description
no history gray triangle displayed in the The parameter is not collecting
upper-left corner history for one of the following
reasons:
• Parameter is running but the
history retention period has
been set to zero.
• Parameter is offline or has
been suspended and history
has not been collected.
snoozed • round, white base, if The parameter has returned a
parameter type is graph, value that is in the alarm range,
gauge, or text but the parameter’s alarm has
• green light, if parameter been manually snoozed.
type is stoplight
• green check mark, if
parameter is Boolean
suspended the letter s in a red circle is The parameter has been
displayed in the upper-right manually suspended.
corner
• InfoBoxes
• events
• error Messages
1-6 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
InfoBoxes
Each monitored object has its own InfoBox that displays certain
attributes about that object and that contains the results of specific data
collection commands. For example, selecting the InfoBox for a database
may display the last time the transaction log was dumped or the date on
which the database was created. For another example, selecting the
InfoBox for a computer may display the host name, IP address, and
machine class.
Events
Error Messages
From the PATROL Console, you can view error messages generated by
PATROL or by your operating system and applications. PATROL error
messages are generated automatically by the PATROL Console or the
PATROL Agent. Error messages can also be generated manually when
you choose to load and set up a KM or to issue a KM menu command or
a task. Error messages are displayed with command output in any one of
the command output windows.
Some KMs provide a menu item that allows you to search for and display
certain operating system and application error messages. Many KMs also
provide one or more debugging menu items that allow you to view
debugging messages issued during a particular process, such as setting up
a new server or a new database to monitor. Refer to the online Help
system or to the manual for each KM that you use.
BMC Software, Inc., Confidential and Proprietary Information
When you issue parameter recovery action commands or tasks, you can
use PSL functions, built-in commands, and built-in macro variables. For
detailed information about PSL and built-in commands and macros, refer
to the PATROL Script Language Reference Manual Volume 1-PSL
Essentials.
1-8 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Menu and Task Commands
Menu commands and tasks sent by the PATROL Console are executed by
the PATROL Agent and then returned to the PATROL Console in an
output window.
When you issue a menu command or a task, you can use PSL functions,
built-in commands and built-in macro variables. Some commands can be
executed only by a PATROL Developer Console. For detailed
information about PSL built-in commands, refer to the PATROL Script
Language Reference Manual Volume 2-PSL Functions.
When you issue state change action commands, you can use built-in
commands and built-in macro variables.
When you issue PATROL Agent setup commands, you can use PSL
functions, built-in commands, and built-in macro variables. For detailed
information about PSL built-in commands, refer to the PATROL Script
Language Reference Manual Volume 2-PSL Functions.
1-10 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
For information about creating or changing PATROL Agent setup
commands, refer to the PATROL for Microsoft Windows User
Guide—Customizing PATROL.
Event Commands
Used with PATROL Event Manager, event commands are run by the
PATROL Agent when certain events occur. The commands are specified
for the event class associated with the event. A command can be one of
three types: escalation, notification, or acknowledgment. For example, an
event class can specify that commands be executed
These startup and shutdown commands differ from PATROL Agent setup
commands that are executed on the PATROL Agent machine when the
PATROL Console connects or reconnects to the PATROL Agent. Startup
and shutdown commands also differ from state change actions that are
executed on the PATROL Agent machine when a computer or application
changes from one state to another.
• quickly find the container for one or more objects, open containers,
and open parameter gauges and graphs
For information about using Agent Query, refer to Chapter 6, “Use of the
Agent Query.”
1-12 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Service Reporting
Service Reporting, found under the Tools menu of PATROL, is an
integrated product that combines data collection, storage, and retrieval
with report creation and viewing facilities. Service Reporting provides a
visual presentation of system management data that you might already be
collecting. You can analyze collected data across multiple KMs and
computers, then select user-defined generic reports and predefined
custom reports that reflect this data.
Note
If the Service Reporting menu pick and its submenus are grayed out, you
do not have Service Reporting installed. Service Reporting is a feature of
Perform for Microsoft Windows and must be installed separately. To
obtain Perform for Microsoft Windows, please contact your BMC
Software, Inc. representative.
1-14 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
2
2-2 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Overview of Parameters
This section contains basic information about parameters. It describes
what parameters are, what they do, when they are run, how they display
information, and the types of parameters.
What Parameters Do
Parameters contain thresholds and can trigger alarms. The thresholds for
the parameters are called alarm ranges. When a value is returned by the
parameter, the value is checked against the alarm range. If the value
returned by the parameter triggers an alarm, the PATROL Agent notifies
the PATROL Console of the alarm and runs any recovery actions
associated with the parameter.
The execution schedule defined for the parameter determines when the
PATROL Agent runs the parameter. Before the parameter can be run, it
must be activated. Most parameters are activated by default. For
information about activating and deactivating parameters, see the
PATROL Console for Microsoft Windows User Guide—Customizing
PATROL.
You can force the PATROL Agent to run one or more parameters
immediately, regardless of their polling cycle, through updating of
parameters. Updating does not reset the polling cycle; rather it gathers a
new data point between polling cycles. For information about updating
parameters, see “Refreshing All Parameters for a Computer Instance” on
page 2-51 and “Refreshing All Parameters for an Application Instance”
on page 2-52.
Note
Using the PATROL Agent’s configuration file, you can also specify the
maximum number of data points stored in cache and the period of time
(in seconds) after which the parameter cache is flushed to the history file.
See the PATROL Agent Reference Manual for more information.
2-4 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
How Parameters Store History Data
Parameter history data is stored by the PATROL Agent in compressed
binary files. The history files are circular, keeping only the most current
number of days selected. History is stored for all parameters, except
those that display output as text. With a PATROL Developer Console (or
PATROL Operator Console with an appropriate user role), you can
specify how many days of data are to be stored. With a PATROL
Developer Console, you can also clear history for an individual
parameter of an instance.
Note
You can also specify the number of days that parameter history is to be
collected by using the PATROL Agent’s configuration file. See the
PATROL Agent Reference Manual for more information.
Table 2-1 shows the types of information and how the information is
depicted.
For information about the states indicated by parameter icons and other
icons, see Chapter 1, “Overview of Monitoring and Managing.”
Types of Parameters
Parameters differ in the way they gather and display data. PATROL®
Console for Microsoft Windows has three types of parameters:
• collector
• consumer
• standard
Table 2-2 shows the types of parameters and the characteristics of each
type.
2-6 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Table 2-2 Types of Parameters and Their Characteristics
Executes according
Recovery Actions
to Polling Cycle
Commands
Executes
Displays
Alarms
Values
Issues
Type of Values
Runs
Type Gathered
collector multiple values yes yes no no no
consumer N/A no no yes yes yes
standard single number or yes yes yes yes yes
text string
Collector Parameter
Consumer Parameter
Standard Parameter
Table 2-3 Tasks Available for Parameters from the Shortcut Menu
2-8 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Types of Information Available about Parameters
Table 2-4 shows the types of information about parameters that are
available to you, tells you where each type of information is displayed,
and provides a reference for detailed descriptions of each type.
2-10 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Table 2-5 Types of Parameter Charts and Graphs Available (Part 2 of 2)
You can access the PATROL Console Charting Server main window from
either a graph folder icon or a parameter graph icon. To access the
PATROL Console Charting Server main window, do the following:
2-12 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Figure 2-1 PATROL Console Charting Server Main Window
Graph
Folder
Menu Bar
Tool Bar
Header
Data Area
Y-axis
X-axis
Legend
Time Line
Slider Bar
Parameter
List
Message
Area
Note
When there is a gap in the curve data of a graph and the Show data gap
feature ( )is turned on, the first point following the gap is not
displayed. The point following the gap can be displayed by turning Show
data gap off.
Note
Customization files are not required for the charting server to function
correctly. If there are no customization files defined, the charting server
uses built-in, default values when a chart window is opened.
Table 2-6 lists and describes the files used by the PATROL Console
Charting Server. All files are contained in
%PATROL_HOME%\patrol\chart.
Command That
File Name Purpose Writes to File
chart_config This file is a global default for all charts and graphs. All File => Save As
newly created charts and graphs use the colors, Default
backgrounds, line styles and widths, and other settings
that are contained in this chart or graph.
2-14 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Table 2-6 Files Used by the PATROL Console Charting Server
Command That
File Name Purpose Writes to File
*.ctf This file is a chart template file that is unique to an File => Save
individual chart or graph. It contains the display attributes
for a chart or graph that are directly associated with the
actual plot portion of the chart window.
2-16 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Where to Find More
Task You Want to Perform Method to Use Information
change the grid lines in the chart or • Options => “Customizing the Chart Window
graph Customize and Data Area” on page 2-35
command, Gridlines and “Chart Gridline Properties”
tab on page 2-41
• Customize chart
button from the Chart
toolbar
• Right-click on chart
and select
Customize from
context menu
set the size of the data point symbols • Options => “Chart Data Series Properties”
Customize, Data on page 2-45
Series tab
• Customize chart
button from the Chart
toolbar
• Right-click on chart
and select
Customize from
context menu
set the time range on the x-axis • Options => “Chart Axes Properties” on page
Customize, Axes tab 2-38
• Customize chart
button from the Chart
toolbar
• Right-click on chart
and select
Customize from
context menu
set the y-axis scale range • Options => “ Parameter History” on page
Customize, Axes tab 2-47
• Customize chart
button from the Chart
toolbar
• Right-click on chart
and select
Customize from
context menu
close the PATROL Console Charting Click on X in upper
Server right-hand corner of
dialog box
2-18 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Where to Find More
Task You Want to Perform Method to Use Information
plot your parameter data as a pie chart • Type => Pie Chart “Types of Parameter Charts and
command Graphs Available” on page 2-9
• Pie chart button from
the Chart toolbar
plot previous data values collected for Options => History “Viewing Data History for a
your parameters Parameter” on page 2-26
plot the y-axis parameter values on an View => Axis =>
exponential scale Logarithmic Y
switch the orientation of the x-axis and View => Axis => Invert
y-axis X-Y Axes
print the chart or graph to a local File => Print
printer or a PostScript file
restore your chart or graph to the View => Reset Zoom “Using the Zoom Feature” on
original view after you zoom in on a page 2-34
portion of the graph
save any changes you have made to File => Save Chart Save button from the Chart
the chart window, headers, legend, toolbar
line styles, and so on
2-20 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Creating a New Graph Folder
Step 1 From the PatrolMainMap menu bar, choose File => New => Graph
Folder.
Step 4 Locate the system and application parameters that you want to plot in
your chart.
Step 5 Drag and drop the parameter icons into the graph folder.
Summary: In this procedure, you will save the attributes of a chart, graph, or graph
folder.
• If you want to save any changes you have made to the headers,
legend, line styles, and so on, choose File => Save.
• If you want to save any changes you have made to the data area,
headers, legend, line styles, and so on, as the default format for all
subsequent charts or graphs you create, choose File => Save As
Default.
• If you want to save any changes you have made to the headers,
legend, line styles, and so on, to a file name of your choice, choose
File => Save As.
2-22 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Displaying Annotated Data Points
Some area and line plots contain annotated data points that provide
detailed information about a parameter in an alarm state at a particular
point in time. An asterisk (*) appears on annotated data points.
Note
The default annotation character is (*). However, the default annotation
character can be changed to any other character by editing the annotation
character field in the Miscellaneous tab of the User Preferences dialog
box.
Summary: In this procedure, you will remove parameters from existing charts.
Step 1 In the Parameter List, click the parameter entry you wish to remove.
The PATROL Console Charting Server removes the parameter from your
chart, but the parameter will be in the chart the next time the chart is
opened.
2-24 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
To Remove Parameters from Existing Charts–Permanently
Step 1 In the Desktop tree, expand the folder for the existing chart.
The PATROL Console Charting Server removes the parameter from your
chart, and the chart will not contain the parameter the next time it is
opened.
Summary: In this procedure, you will view historical (old) data for a parameter.
Before you can plot parameter data from specific time periods, data
history collection must be turned on for the parameters in your chart. For
information about history collection, see the PATROL Console for
Microsoft Windows User Guide—Customizing PATROL.
Step 1 From the PATROL® Console for Microsoft Windows window menu bar,
choose Options => History.
The Pick History Range dialog box appears, as shown in Figure 2-2 on
page 2-27.
2-26 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Plotting Data from Specific Time Periods
Summary: In this procedure, you will plot data from a specific time period.
Before you can plot parameter data from specific time periods, data
history collection must be turned on for the parameters in your chart. For
information about turning on data history collection, see the PATROL
Console for Microsoft Windows User Guide—Customizing PATROL.
Follow these steps to plot parameter data from specific time periods.
Step 1 From the PATROL Console Charting Server window menu bar, choose
Options => History.
The Pick History Range dialog box appears, as shown in Figure 2-2.
Step 2 Click the Start spin box until you have set the beginning of the time
period you would like to plot.
2-28 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Using Optional Chart Views
Note
On the View menu, a check mark to the left of a view option indicates
that the view is currently active. Views without a check mark are not
active.
Table 2-7 describes the types of information you can display and the
command to use.
2-30 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Displaying Data Statistics
Summary: In this procedure, you will display statistics on the parameter data plotted
in the chart.
Step 1 From the PATROL Console Charting Server main window menu bar,
choose Options => Statistics.
Step 2 After you are finished viewing the data statistics, click the X button to
close the Statistics window.
Follow this step to display data point coordinates in area and line plots:
» Simultaneously click and hold the left and right mouse buttons.
The precise x-axis and y-axis data point coordinates appear in the bottom
message area.
Note
If you click and hold both mouse buttons simultaneously, you can drag
the cursor across the data area and continuously display the precise
x-axis and y-axis data point coordinates.
2-32 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Rotating a Chart in 3-D
If you prefer, you can rotate the 3-D chart until it appears as a 2-D, or
flat, chart.
Follow these steps to rotate bar, pie, and stacked bar charts:
Step 1 Simultaneously click and hold the left and right mouse buttons anywhere
in the data area of your chart.
Step 2 Move your mouse until you have rotated the chart to the desired view.
Summary: In this procedure, you will use the zoom feature to enlarge portions of an
area and line plots to see the data points more clearly.
Note
The Zoom feature is only available for line plots and area plots.
Step 1 Position your cursor at the uppermost corner of the section of the chart
you would like to enlarge.
Step 2 Click and drag your cursor downwards until you have created a box
around the section of the chart you would like to enlarge.
The PATROL Console Charting Server enlarges the section of your chart
to fill the data area.
Step 4 After you have finished viewing the enlarged section, choose
Options => Zoom Reset to restore your chart to the original view.
2-34 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Customizing the Chart Window and Data Area
Summary: In this procedure, you will customize the color and appearance of the
PATROL Console Charting Server window and data area.
Before you begin to customize the color and appearance of the PATROL
Console Charting Server window and data area, make sure you are aware
of the following note.
Note
The PATROL Console Charting Server recognizes up to 226 colors. If
your configuration supports fewer colors, the colors that are not
supported by your configuration are mapped to the nearest color that is
supported. On systems that support only 256 or fewer colors, PATROL
may produce incorrect chart colors. When possible, set your video
controller to display more than 256 colors.
Step 2 Click the appropriate tab for the item you want to customize. Refer to
Table 2-8.
2-36 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Table 2-8 Customize Grid Dialog Fields (Part 2 of 2)
Step 3 Customize the chart window and data area by changing the appropriate
values.
• If you want to save any changes you have made to the chart window,
headers, legend, line styles, choose File => Save Configuration.
The next time you open the graph or graph folder, the chart will
retain the customized format.
• If you want to save any changes you have made to the chart window,
headers, legend, line styles, and so on, to a file name of your choice,
choose File => Save Chart As.
• If you want to save any changes you have made to the chart window,
data area, headers, legend, line styles, and so on, as the default
format for all subsequent graphs you create, choose File => Save
Chart as Default.
2-38 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Table 2-9 Axes Property Elements (Part 2 of 2)
2-40 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Table 2-10 Chart Property Elements (Part 2 of 2)
Note
You can enter fractional values using the format “0.n” (the “0” preceding
the decimal point is required). This feature is useful for displaying y axis
grids for curves that have a small range of values. For example, if a curve
has a minimum value of 0, and a maximum value of 1.0, you can display
a grid between 0 and 1 by entering “0.5” for the y axis grid interval.
2-42 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Table 2-12 displays the chart title property elements.
The customizations you make here are only visible if the legend is shown
for the chart. To add the legend to a chart, choose View => Legend from
the PATROL Console Charting Server main window or click the Legend
button on the Chart toolbar.
2-44 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Table 2-13 Legend Property Elements (Part 2 of 2)
Table 2-14 displays the data item line and data point marker property
elements.
2-46 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Parameter History
This section contains information on historical information regarding
parameters.
param.hist File
Parameter values can be retained for a maximum of one year before they
are automatically deleted. You can review different parameter values at
different points to analyze trends and identify other problem areas.
Example
\PATROL3-4\log\history\patuser\history\3181
With the PATROL History Loader KM, you can extract data to a target
machine and load it into a specified database table. You can create, purge,
or drop database tables with the PATROL History Loader KM. The utility
can be set to automatically propagate the history or can be used to
manually propagate data for a specified period of time.
2-48 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Viewing Parameter Value History
Summary: In this procedure, you will view parameter value history information.
• From the parameter window menu bar, choose Options => History.
Step 3 Enter the history span you want to see displayed by the graph by using
the spin boxes for the start and end dates.
Summary: If you have not resolved the problem associated with an alarm, and you
do not want the associated icons to flash, snooze the alarm. The
parameter will remain red but will not flash. In this procedure, you will
snooze a parameter.
To Snooze an Alarm
2-50 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Refreshing All Parameters for a Computer Instance
Summary: In this procedure, you will refresh all parameters for a computer instance.
Step 1 Right-click the computer icon. The shortcut menu for the computer
instance appears.
The parameters for all the application instances on the computer are
updated with new values.
Summary: In this procedure, you will refresh all parameters for an application
instance.
Step 1 Right-click the application icon. The shortcut menu for the application
instance appears.
All the parameters for the application instance are updated with new
values.
2-52 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Overriding Application Discovery Properties
Summary: In this procedure, you will change the discovery properties for an
application. These changes supersede properties set by the default for the
KM or that were set by another user.
Step 1 Right-click the icon for the application whose properties you need to
modify. The shortcut menu for the application appears.
Attribute Description
Name The name of the application you are overriding.
PATROL supplies the value for this field based on
the application you are modifying.
Custom Discovery Cycle Check to set a custom discovery cycle for the
application. Fill in the hours, minutes, and seconds
fields to specify how often to run discovery for this
application. By default, PATROL attempts to
discover applications every five minutes.
2-54 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Overriding Parameter Attributes
Note
If you override the attributes of a parameter, any recovery actions defined
for the parameter are disabled.
Step 1 Right-click the icon for the parameter you need to modify. The shortcut
menu for the parameter appears.
Step 3 Change the attributes as needed. Table 2-17 describes the property
elements on the Override Parameters dialog box.
Attribute Description
Parameter Name The name of the parameter you are overriding.
PATROL supplies the value for this field based on
the name of the parameter you are changing.
Parameter Type The type of the parameter you are overriding.
PATROL supplies the value for this field based on
the type of the parameter you are changing.
Active Check to activate monitoring of this parameter.
Apply to All Instances Check to apply your parameter attribute changes to
all instances of the application. Remove the check
to limit the change to the instance you selected in
Step 1.
Poll Interval Enter the period of time in hours, minutes, and
seconds, between each execution of the parameter.
Enter an interval of 0:0:0 to run the parameter
continuously.
2-56 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Table 2-17 Override Parameter Attributes (Part 2 of 2)
Attribute Description
History Retention Enter the number of days to retain data for this
parameter.
Border Alarm Check the Active box to enable the border alarm.
Note
Parameter overrides can also be defined in external files. See the
PATROL Agent Reference Manual for more information on external
parameter overrides.
2-58 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
3
3-2 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Where to Find More
Task You Want to Perform Method to Use Information
create a new folder File => New => Folder “Creating a Folder” on page 3-4
command from the
PatrolMainMap window
delete a folder Delete command from “Deleting a Folder” on page 3-8
the folder shortcut
menu
move an object into a folder click and drag the “Moving an Object into a Folder”
object inside the folder on page 3-6
remove an object from a folder click and drag the “Removing an Object from a
object outside the folder Folder” on page 3-7
Summary: In this task, you will create an empty folder icon and later drag and drop
each object icon you want to include into the folder.
Before you begin to create a folder, make sure you have performed the
following actions:
To Create a Folder
Step 1 From the Console window, Choose File => New => Folder.
3-4 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Step 2 Complete the fields on both of the tabs of the Properties Sheet.
Step 3 Click on OK to remove the Properties Sheet and create a new folder icon.
Before you begin to move an object into a folder, make sure you have
performed the following actions:
» Click and drag the object icon and drop it onto the folder icon.
The object icon disappears, and the object becomes part of the logical
group represented by the folder.
3-6 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Removing an Object from a Folder
Before you begin to remove an object from a folder, make sure you have
performed the following actions:
Step 1 Double-click on the folder icon to display the folder icon window.
Step 2 Click and drag the object icon that you want to remove from the group
out of the window and back to either the PatrolMainMap or its parent
windows.
Before you begin to delete a folder, make sure you have performed the
following actions:
To Delete a Folder
Step 3 Click one or more folders that you want to delete, then use right-click to
access the shortcut menu for the folder.
Step 5 Click Yes to confirm that you want to delete the folder and move the
objects it contains back to their parent windows.
The folder is deleted, the folder icon is no longer displayed, and the
objects that were in the folder are now displayed in their parent windows.
3-8 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Shortcuts
If you want to create an alternative method for accessing a computer,
application, or parameter independently of the object hierarchy, you can
create a shortcut. When you create a shortcut, you create a duplicate icon
for the computer, application, or parameter. You can place the duplicate
icon in a folder or graph, or you can place it on the PatrolMainMap.
When you double-click the duplicate icon, you access the computer,
application, or parameter directly.
To Create a Shortcut
Step 3 If you want to move the shortcut icon to another folder, drag the shortcut
icon and drop it on the folder.
3-10 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Removing a Shortcut
To Delete a Shortcut
Step 1 Right-click the shortcut icon for the computer, application, or parameter.
3-12 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
4
4-2 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Types of Commands You Can Run
The following table lists the types of commands you can run, the
methods available for running each type, and any additional information.
User Account
Object Command Defined for User Account Used for
Is Run Against Instance Command
computer yes account for the computer
instance
no account for PATROL
application yes account for the application
instance
no account for PATROL
Note
If you have loaded the operating system Knowledge Module, interactive
commands of the type OS and PSL that prompt for the command
argument are available from the computer pop-up and Commands
pull-down menus.
4-4 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
» Right-click on the computer on which you want to run the command and
choose Show System Output Window.
Note
In general, only commands that output plain text are supported by the
System Output window. Commands that launch a GUI or interact with
the system display or keyboard will not work correctly.
Note
The command types known to PATROL other than OS and PSL depend
on the Knowledge Modules you have loaded.
4-6 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Types of Commands You Can Run Using Command Dialog
The command you define can be either of the two default command
types, OS (including PATROL built-in commands) or PSL, or any other
command type displayed in the Commands dialog. For more detail about
command types, see PATROL Console for Microsoft Windows User
Guide—Customizing PATROL . You can use the PSL response function to
interactively prompt for responses as part of any custom PSL commands
you create using a PATROL Developer Console. Refer to the the PATROL
Script Language Reference Manual Volume 2-PSL Functions for further
details.
Type of
Command or
Task From PATROL Main Menu Menu Item From Shortcut Menu
OS command Commands => For Computers => KM Commands => OS Command
<computer_class> => OS Command
OS command as a Commands => For Computers => KM Commands => OS Task
task <computer_class> => OS Task
PSL command Commands => For Computers => KM Commands => PSL Command
<computer_class> => PSL Command
PSL command as a Commands => For Computers => PSL Commands => PSL Task
task computer_class> => PSL Task
4-8 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Running a Command or Task from a Command or Task Dialog
Summary: In this task, you will run a command or task from a Command or Task
dialog.
Step 2 Click the command entry area (the bottom half of the Command or Task
dialog).
• If the command is a long command and you want to use a text editor
to enter the command, click the text editor button.
The system displays the text editor. Continue with “Using the Text
Editor to Write a Command” on page 4-11.
• If you want to run the command on the selected host, click Apply.
• If you want to run the command on all selected hosts, click Apply to
Selected.
4-10 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Using the Text Editor to Write a Command
Summary: In this task, you will load an existing command or define a long, complex
command into a Command or Task dialog using the text editor.
The text editor has different menu options and functions depending on
the type of command you are entering. See the online Help for the
window.
Before you begin using the text editor to write a command, make sure
you have performed the following actions:
• You have started the PATROL Console and have accessed the text
editor from a Command or Task dialog.
• If you want to write a new command by typing it, type the command.
• If you want to save your command for future use, choose either File
=> Save or File => Save As.
• If you are writing your command in PSL, you can check its syntax
before running it. Choose Options => Check Syntax from the editor
menu bar. This option is available only if you chose PSL Command
from the shortcut menu.
Step 2 Choose File => Exit from the editor menu bar.
A dialog is displayed.
• To both display the command in the Command dialog and save the
command to a file, click Separate File.
• To neither display the command in the Command dialog nor save the
command to a file, click Cancel.
PSL Commands
PATROL provides a scripting language called PATROL Script Language
(PSL). You can use PSL to create commands and tasks that you can run
in PATROL.
4-12 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Method Available for Checking the Syntax of a PSL Command
You can perform a quick check of the syntax of a PSL command by using
the text editor available from the Command and Task dialogs. For more
information, see “Using the Text Editor to Write a Command” on page
4-11.
Built-in Commands
PATROL provides a set of built-in commands for handling commonly
encountered situations like setting a variable or forcing application
discovery. These commands run as OS commands.
The following table lists the tasks you can perform using the built-in
commands supported by the PATROL Agent and the built-in command to
use for the task.
4-14 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Running Built-in Commands
Summary: In this task, you will run a built-in command against an object in
PATROL.
Step 1 In the PATROL Main window, click on the computer against which you
want to run the built-in command.
Step 3 Define the command type as OS and type the built-in command.
» Right-click on the computer on which you want to run the command and
choose Show System Output Window.
4-16 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
5
However, you can alter the scheduling policy of the PATROL Agent.
Take care to modify PATROL Agent activity only when absolutely
necessary. You can modify or override its self-tuning mechanism at any
time by either modifying PATROL Agent parameters or executing a
tuning command.
5-2 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
PATROL Agent Load Monitoring
The PATROL Agent application class includes parameters for monitoring
the load and work rate of the PATROL Agent. These parameters are
displayed by double-clicking on the PATROL Agent icon to display the
Icon window. The parameters are described in Table 5-1. The Macro
Variable column shows the variable used for each parameter. Refer to the
PATROL Script Language Reference Manual Volume 1-PSL Essentials
for a full listing of macro variables for computers, applications, and
parameters.
5-4 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Table 5-2 Tasks for Managing the PATROL Agent (Part 2 of 5)
5-6 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Table 5-2 Tasks for Managing the PATROL Agent (Part 4 of 5)
5-8 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
6
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3
Components of the Agent Query Window. . . . . . . . . . . . . . . . . . 6-3
Components of the Query Results Window. . . . . . . . . . . . . . . . . 6-7
Agent Query Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-14
Examples of Using Agent Query . . . . . . . . . . . . . . . . . . . . . . . . . 6-15
Creating a Query. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16
About Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16
Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16
Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-17
Creating a Query with Quick Query . . . . . . . . . . . . . . . . . . . . . . 6-18
Creating Your Own Queries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-20
Where to Go from Here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-25
Modifying a Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26
Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26
Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26
Modifying a Query with Quick Query. . . . . . . . . . . . . . . . . . . . . 6-27
Modifying a Query with the SELECT and WHERE Boxes . . . . 6-28
Modifying Queries with the Query Box Buttons. . . . . . . . . . . . . 6-30
Where to Go from Here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-32
Issuing a Query. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-33
Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-33
Issuing a Query from the Agent Query Window . . . . . . . . . . . . . 6-34
Where to Go from Here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-34
6-2 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Overview
Agent Query is a powerful tool for monitoring and managing objects in
your enterprise. Using this function, you can work with objects outside of
the console window. Instead of viewing objects as icons, you view their
names in a tabular, or table, format. With Agent Query you can:
» On the main console menu bar, click Tools => Agent Query.
The Agent Query window appears.
Menu bar
SELECT box
WHERE box
Button bar
• menu bar
• SELECT box
• WHERE box
• Query box and its buttons
• button bar
Menu Bar
• File menu
• Quick Query menu
6-4 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
File Menu
The table below lists the function of each item on the File menu.
Items on the Quick Query menu allow you to use queries for
often-needed information. The table below lists the function of each item
on the Quick Query menu.
Help Menu
This part of the Agent Query window allows you to select one or more
objects for creating customized queries:
• computers
• applications
• instances
• parameters
The objects you choose appear in the SELECT statement in the Query
box.
WHERE Box
This part of the Agent Query window allows you to specify conditions
for objects you chose in the SELECT box, narrowing the conditions for
your search. The conditions you can specify are different for each object.
Query Box
This area of the Agent Query window displays the SQL-like queries you
created by using either the Quick Query menu selections or the
SELECT and WHERE boxes.
When more than one query statement is in the Query box, a message
appears. For example, the following message means you are viewing the
first of four query statements.
6-6 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Query Box Buttons
Add Up
Located on the right side of the Query box, these buttons allow you to
erase (reset), combine (by adding queries), or delete queries, as well as
display combined queries one at a time.
Button Bar
The table below describes functions of the buttons on the Agent Query
window.
Whether you create queries with the Quick Query menus or the
SELECT and WHERE boxes in the Agent Query window, the Query
Results window displays results that match your query.
Menu bar
Query box
Query Results
table
Button bar
Status line
• menu bar
• Query box
• Query Results table
• button bar
• status line
Menu Bar
• File menu
• Edit menu
• View menu
• the Actions menu
6-8 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
File Menu
The table below lists the functions of items on the File menu.
Edit Menu
Items on this menu allow you to work with rows in the Query Results
table. The table below describes the functions of the Edit menu.
The table below describes the functions of items on the View menu.
6-10 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Actions Menu
Query Box
The Query box displays the last issued query. The results of this query
are in the Query Results table.
The Query Results table shows the monitored objects you specified in
your query, plus any other conditions you defined (for example, all
computers whose status is alarm).
• Use the horizontal scroll bar to move left and right. This allows you
to view undisplayed columns.
• Use the scroll arrows or scroll box to move up and down. This allows
you to view undisplayed rows.
6-12 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Button Bar
The table below describes the functions of items on the button bar in the
Query Results window.
Status Line
The status line is at the bottom of the Query Results window. It displays
messages as you perform activities. For example, when a query is in
progress, the status line displays the following message.
This type of message appears for only a few seconds. When the query is
complete, the status line shows statistics about the items (such as number
of objects) in the Query Results table.
No
Perform management
activities for the selected
objects
6-14 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Examples of Using Agent Query
The table below gives examples of how you can take advantage of Agent
Query’s capabilities.
About Queries
Queries are created using SQL-like statements. However, you do not
have to know SQL to create queries. When you use Quick Query or the
SELECT and WHERE boxes, the appropriate statements appear in the
Query box with the proper format.
All queries begin with a SELECT statement. This statement indicates the
type of objects you want to find (computers, applications, instances, or
parameters).
Query Structure
In this query, the PATROL Agent will look for all monitored Unix
computers that are in OK, warning, alarm, or disconnected states.
Options
You can create a query in one of two ways:
6-16 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
• using the items on the Quick Query menu
• using the SELECT and WHERE boxes of the Agent Query window
Tasks
This section describes how to
Summary: With Quick Query, you don’t construct SELECT and WHERE statements
separately; it’s automatically done for you.
Options
The table below lists the options available for using Quick Query.
» Choose Quick Query => Select All => Computers => in Warning &
Alarm.
The query box displays the following message and the resulting query:
6-18 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Query 1 of 1. Results of Queries will be combined.
SELECT Computers FROM PATROL
WHERE
Computers-Status IN (‘Warn’, ‘Alarm’)
This query will search for all computers that are in warning and alarm
states.
Note
Quick Query automatically combines query statements. For more
information, see “Modifying Queries with the Query Box Buttons” on
page 6-30.
Summary: The example query in this task is the same one used in “Creating a
Query with Quick Query” on page 6-18. This task illustrates how using
the SELECT and WHERE boxes to create queries differs from using
Quick Query. By using this method, you can construct SELECT and
WHERE statements separately.
You can choose one or more objects for the SELECT statement.The table
below describes the check boxes in the SELECT box of the Agent
Query window.
Note
To deselect an object, click the check box. The check mark disappears.
Each object has a properties tab in the WHERE box. When you click a
properties tab, a properties dialog appears that allows you to specify
conditions for the objects you want to query. The following tables list and
describe the property elements for each object.
6-20 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Property Elements for the Computers Tab
6-22 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Property Elements for the Instances Tab
Step 1 In the SELECT box of the Agent Query window, click the check box of
the objects (Computers, Applications, Instances, or Parameters) that
you want to query. For example, click Computers.
The Query box displays the SELECT statement. In this example, the
statement is
This statement will query all the computers from all PATROL Agents.
The next step narrows the criteria for the query.
Step 2 In the WHERE box, click the tab of the object (Computers,
Applications, Instances, or Parameters) that you want to use to narrow
the search criteria. For example, click the Computers tab.
6-24 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
The property elements for Computers appear. By default, the Name
button is selected. The LIKE and Use Wildcards ‘*?’ property elements
are also selected by default.
• To enter object names, use the elements for the Name button.
• To indicate other conditions, click the button of your choice:
WHERE
Computers-Status IN (‘Warn’,’Alarm’)
This query will search for all computers that are in warning and
alarm states.
Options
Tasks
This section describes how to:
6-26 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Modifying a Query with Quick Query
Summary: This task describes how to change a query using Quick Query menu
items.
» Choose the appropriate items from the Quick Query menus. In this
example, choose Quick Query => Select All => Computers => that
are Disconnected.
The SELECT and WHERE boxes reflect your choices. The query
statement changes to
Summary: The example query in this task is the same one used in “Creating a
Query with Quick Query” on page 6-18. This task illustrates how using
the SELECT and WHERE boxes to create queries differs from using
Quick Query. By using this method, you can construct SELECT and
WHERE statements separately.
Before issuing the query, you want to include more objects (this will
change the SELECT statement) and more conditions (this will change the
WHERE statement).
Step 2 In the SELECT box, click the check box of the object you want to
include. For this example, click Applications. The SELECT statement
changes:
This query would search for all computers in warning and alarm, plus all
applications.
Step 3 Make any changes to conditions in the WHERE box. In this example,
click the Applications tab.
6-28 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Step 4 Click the button name of property elements you want to change. In this
example, click the Status button.
Step 5 Click the appropriate check boxes. In this example, click Warn and
Alarm.
Summary: You can combine, delete, and erase queries using the buttons in the
Query box.
Step 1 Be sure a query appears in the Query box. In this example, you will add
another query statement and combine it with the following query:
Note
When only one query statement is in the Query box, the following
message appears above the query: Query 1 of 1. Results of
queries will be combined.
Step 2 Click the Add button. In this example, you are ready to add a second
query, so the message line changes to:
This means the combined results of both query statements will be in the
Query Results table.
appears in the Query box, indicating that you can now add a query to
your previous one.
Step 3 Use the SELECT and WHERE boxes or the Quick Query menus to
create a new query.
6-30 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
3.A In the SELECT box, add an object for the new query. For this
example, click the Applications check box. The SELECT
statement changes to:
• Click the Status button, then click the OK, Warn, Alarm,
and Offline check boxes.
This query will search for applications named NT_CPU that are
in OK, warning, alarm, or offline states.
Note
You can display queries one at a time by using the Move Up or Move
Down buttons.
Step 1 Use the Move Up or Move Down buttons to find the query you want to
delete.
Step 2 Use the Move Up or Move Down buttons to find the query you want to
erase.
Step 4 Use the elements of the SELECT and WHERE boxes or the Quick Query
menus to create a new query.
6-32 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Issuing a Query
When all objects and conditions are specified for a query, issue the query
to PATROL Agents.
Task
This section describes how to issue a query from the Agent Query
window.
Summary: This task details how to issue a query to the PATROL Agent for the first
time.
Step 3 The Query Results window opens. The results of the query appear in the
Query Results table.
Note
While the query is in progress. the Stop button overlays the Update
button. To halt the query, click Stop. The Query Results table will list all
objects found before you stopped the query.
6-34 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Using Query Results
After you issue a query, you can use items on the Edit and View menus
of the Query Results window to work with objects that matched the
query.
Tip
Remember: You must select objects in the Query Results table before
you can perform any object management activities.
Tasks
This section describes how to
Summary: Selecting rows in Query Results table allows you to customize the
display of objects or to eliminate unwanted objects in the table. Before
you can perform any object management activities, you must select rows
in the table.
Note
You can also double-click a row to select it; single-click to deselect the
row.
Options
Many options are available for selecting objects in table rows. The tables
that follow list all the options.
6-36 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Select By Options for Computers
Step 1 To select an object, use the Edit menus. In this example, choose Edit =>
Select By => Application.
Step 2 Use the Edit menus to specify conditions. In this example, you want to
select rows according to object state, so you choose Edit => Select
By => Status => Offline.
All table rows containing objects with an Offline state are highlighted.
• To work with the objects in the highlighted rows, choose Edit =>
Delete Unselected.
6-38 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
• To work with the objects in rows that are not highlighted, choose
Edit => Delete Selected.
Step 2 Select LIKE to include or NOT LIKE to exclude the text you will type in
the text box.
Step 3 Type the name of the object you want to include or exclude.
• Click use wildcards ’*?’ to use the asterisk (*) or question mark (?)
as wildcards.
The rows containing object names matching the search are highlighted.
Summary: You can arrange rows in the table by sorting according to object name,
type, or status. You can sort in ascending order (from a to z) or in
descending order (from z to a), by clicking on the column headings or by
using the menu commands. Both methods are explained in this section.
Set the sort criteria and sort events by clicking on a column heading. The
headings sort the events according to the sort criteria you have selected
(whichever column heading is selected, indicated by the column heading
text being white). Clicking again on the column heading that is already
selected toggles the sort criteria from ascending to descending or vice
versa and re-sorts the data.
Figure 6-6 illustrates the sorting of the data in the Query Results table
with the column headings.
6-40 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Figure 6-6 Sorting Query Results
Note
Any updates to the table will not be sorted automatically. To update the
display, you must re-sort the column.
A menu appears.
Note
Any updates to the table will not be sorted automatically.
6-42 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Setting the Display of Table Columns
Summary: You can set the display of columns in the Query Results table. This
enables you to always view a specified number of columns as you scroll
to the columns on the right side of the table.
A menu appears.
Step 2 Determine the number of columns you always want to be able to see
when you scroll to the right.
Step 3 In the Query Results table, use the horizontal scroll bar to move to the
columns on the right.
The fixed columns on the left do not move out of view as you scroll to
the right.
Summary: You can resize a column in the Query Results table. You can increase or
decrease column size.
Step 1 Move the cursor to the right line next to the column name at the top of
the table.
Step 3 Hold the left mouse button down and drag the column to the right (to
increase) or left (to decrease) to change the size of the column.
6-44 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Scheduling a Query for Reissue
Summary: You can designate timed intervals to reissue a query to the PATROL
Agent. After you enable the function, reissuing the query becomes
automatic. This updates the data in the Query Results table.
— Enter the days, hours, or minutes for the timed interval and click
OK.
6-46 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Disabling Scheduled Reissue of Queries
Summary: You can disable automatic requery to the PATROL Agents. This also
disables updates to the data in the Query Results box.
Summary: You can reissue a query whenever you want by using the Update button
in the Query Results window.
Note
While the query is in progress, the Stop button overlays the Update
button. To halt the query, click Stop. The Query Results table will list all
objects found before you stopped the query.
6-48 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Hiding a Query
Summary: You can hide the query statements that appear in the Query box of the
Query Results window. This allows you to expand the Query Results
table.
Summary: You can work with multiple queries and their results in separate Query
Results windows. This can be useful when, for example, you want to
work with Oracle database issues in one window and Lotus Notes issues
in another.
The Agent Query window reappears, displaying the last query you
issued from that window.
Step 2 Use either the Quick Query menu items or the SELECT and WHERE
boxes to create another query.
Now you can perform separate activities with the contents of the Query
Results table in the new Query Results window.
6-50 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Managing Objects
Many object management activities that you can perform with Agent
Query enable you to work with a number of objects at once, rather than
one at a time.
Note
Other chapters of this guide give details of management activities you
can perform that are not available from menus within Agent Query.
Tasks
This section describes how to
Summary: You can add objects to containers by copying or moving them. You can
add objects to graphs by copying them.
Step 1 In the Query Results table, select the rows with the objects you want to
add to a container or graph.
6-52 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Desired Task Dialog to Select
choose the name of the container or select the name of the container from
graph the list below the text box and select
Copy to Container or Move to
Container for the selected objects
create a container or graph for the type the name of the new container
selected objects or graph in the text box
The results you see depend on your actions in the dialog box:
Step 2 Select one or more disconnected computers in the Query Results table.
6-54 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Disconnecting Computers from PATROL Agents
Step 2 Select one or more connected computers in the Query Results table.
Summary: You can quickly find the container for one or more objects in the Query
Results table.
• Select the row and choose Actions => Locate from the context
menu.
Locating...done.
Note
If an object you select does not have a container, a message on the status
line at the bottom of the Query Results window lets you know.
6-56 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Opening Containers, Gauges, and Graphs
Summary: You can open containers for any object in the Query Results table. You
can open gauges and graphs for parameters. The procedure that follows
uses parameters.
If you want to work with gauges and graphs, be sure you queried for
parameters.
Step 1 Select one or more parameters that use gauges or graphs in the Query
Results table. (The Attributes column lists whether the parameter has a
gauge or graph.)
The window for the gauge or graph is opened. You can perform any
necessary management activities.
Summary: You can create charts for parameters you select in the Query Results
table.
A chart window is open. Lines for each selected parameter appear in the
window.
6-58 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Snoozing Alarms
Summary: You can set the snooze time for selected objects in alarm state in the
Query Results table.
Step 1 From the Query Results table, select one or more objects in alarm.
A menu appears.
• Use the Alarm Snooze menu to select the snooze time for the alarm:
— Enter the days, hours, or minutes you want to snooze the alarm
and click OK.
Snoozing...Done.
Step 4 Go to the main console window. The icon for the object in alarm no
longer flashes red.
6-60 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Resetting Alarms
The icon for the object in alarm state is flashing red again.
Saving Queries
You can save a query to a file (with or without its results) to avoid having
to redefine it each time you want to use it. This allows you to use the
query again.
6-62 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Saving a Query in the Agent Query Window
Summary: This task describes how to save the query, not the query and its results.
Step 1 Be sure the query you want to save appears in the Query box of the
Agent Query window.
Step 3 Choose the folder and file name for the query. Use the *.qry extension
for easy identification of the file.
The full path name of the file appears in the title bar of the Agent Query
window.
Note
If you click Save while this file name appears, this file will contain any
changes you make. To clear the file name from the Agent Query
window’s title bar, you must close the window.
The next time you want to use the query, you can load the file.
Summary: You can save both the query and its results from the Query Results
window.
Step 1 From the Query Results window, choose File => Save As.
Step 2 Choose the folder and file name for the query results. Use the *.qry
extension for easy identification of the file.
The Query Results window reappears. The full path name for the *.qry
file is displayed in the title bar.
Note
If you click Save while the file name appears, this file will contain any
changes you make. To clear the file name from the title bar, you must
close the window or open another Query Results window (by clicking
New Query).
The next time you want to use the query and its results, you can load the
file.
6-64 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Exporting Query Results to a Text File
Summary: This task describes how to export the contents of the Query Results table
to a text file (*.txt). The table’s columns will be in tabular format in the
text file.
Step 1 From the Query Results window, choose File => Export.
Step 2 Choose the folder and file name for the query results. The default
extension is *.txt.
The contents of the Query Results table and the query (if it’s displayed in
the Query box) are saved to a text file, allowing you to view, edit, or print
that file.
Note
Tasks
This section describes how to
6-66 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Using a Saved Query
Summary: This task describes how to load a query that you saved, not the query
results.
Step 1 From the Agent Query window, choose File => Open.
The full path name of the file appears in the title bar of the Agent Query
window.
The Query Results window appears. The table lists the objects matching
the query.
Summary: You can reuse saved query results by loading a previously saved *.qry
file.
Step 1 From the Query Results window, choose File => Load.
The full path name of the file appears in the title bar of the Query Results
window.
The Query Results table contains the latest results of the query. You can
now perform any necessary management activities.
6-68 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Saving Changes to Query Files
Summary: You can save changes you make to query (*.qry) files after you make
modifications. The actions for saving changes are the same for each
window.
Note
As long as the file path name of the *.qry file appears in the title bar, all
saved changes will be written to that file.
Summary: You can close the Agent Query function from either window.
Step 2 Repeat Step 1 until you close all Query Results windows.
The results of your action depend on whether the Agent Query window
is closed (in cases where more than one Query Results window is open):
• If the Agent Query window is open, you return to the Agent Query
window.
• If the Agent Query window is not open, you exit the Agent Query
function.
To Close the Agent Query Window and Exit the Agent Query Function
6-70 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
7
Management of Events 7
7-2 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
PEM Operations
You can use the PEM to manage events that occur on objects that are
being monitored by a PATROL Agent. Using PEM, you can perform
these tasks:
In the context of PATROL, an event is any state change that takes place
for a monitored object on one or more hosts. Monitored objects can
include computers, applications, or parameters.
Using the PEM, you can access events stored in the event history
repository. You can choose to view any of the stored events. You can
supply filtering criteria so that the PEM displays only the events that
match your criteria.
Figure 7-1 shows the architecture of the PEM and how events are
handled by PEM.
Using the PATROL Event Manager From the PATROL Console, open a PEM
window for all monitored hosts or for a
selected host. The PEM window allows you
to filter, view, and act upon events that have
been stored in event history repositories.
Event Event
From a single PATROL Console, you can
open multiple PEM windows and manage
events for computers (hosts) running
PATROL Agents.
7-4 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
PEM Graphical Components
The main components for the PEM include the following graphical
elements:
• PEM window
• Event Details dialog box
• Filter Window dialog box
• Event Repository Statistics window
• Window Statistics dialog box
PEM Window
You can access the PEM window from either the toolbar in the main
console window or from a selected computer’s pop-up menu. The
majority of event management operations are carried out from the PEM
window. You can view event summary details and perform actions on
events from this window. In addition, the events listed in the PEM
window are color-coded by event type so that you can easily distinguish
one type from another. Table 7-1 lists event types and their associated
colors in the PEM window.
Note
Colors will vary depending on the display capabilities of your system.
Table 7-2 lists tasks you can perform by using the menu bar items in the
PEM window. Detailed instructions for performing these tasks are
provided later in this chapter.
7-6 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Table 7-2 PEM Window Menu Bar (Part 2 of 2)
Figure 7-3 shows the toolbar icons in the PEM window and explains how
they are used.
Delete Event
Close Event
Acknowledge Event
Detail (view event details)
Sort Descending (sort events)
Sort Ascending (sort events)
7-8 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Event Details Dialog Box
This dialog box displays detailed information about a single event. You
can view expert advice and enter event diary information for an event, or
Web browser to view additional information. (Refer to “Display of Event
Information and Details” on page 7-18 for more detailed information.)
You select which events you view by using the Filter Window dialog box
to create view filters. Additionally, you control which events are
forwarded from PATROL Agents to the PEM window by defining
persistent filters for PATROL Agents. Refer to “Filtered View of Events”
on page 7-26 for more detailed information on the differences between
standard view filters and persistent filters.
7-10 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Event Repository Statistics Window
The Event Repository Statistics window displays summary event
information for all hosts connected to your PATROL Console.
Table 7-3 lists tasks you can perform using the menu bar items in the
Event Repository Statistics window. Detailed instructions for performing
these tasks are provided later in this chapter.
Figure 7-7 shows the toolbar icons in the Event Repository Statistics
window and explains how they are used.
7-12 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Window Statistics Dialog Box
You can access the Window Statistics dialog box from the PEM window.
The Window Statistics dialog box summarizes the total number of events
that have been forwarded to the PEM window since it was first accessed
or since the counters have been cleared. This dialog box lists the host
with the worst instance (highest incidence) for each type of event.
Summary: In these tasks you will open a PEM window for multiple hosts and for a
specific host.
Use the scroll bar on the right side of the PEM window to scroll through
events that are out of view.
One of the first things you will do in the PEM window is to rearrange
events so that you can view them and work with them more easily. You
can set the sort criteria and sort events by clicking on a column heading.
As new events are displayed, you can re-sort the event view by clicking
on the Sort Ascending or Sort Descending buttons. These buttons
re-sort the events according to the sort criteria you have selected
(whichever column heading is selected, indicated by the column heading
text being white). Clicking again on the column heading that is already
selected toggles the sort criteria from ascending to descending or vice
versa.
7-14 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
For more detailed information about sorting events, refer to “Setting a
Persistent Filter” on page 7-32.
» Choose File => Save Events to save the contents of the PEM window in
a text (.txt) file in the location of your choice.
If you save an events file over a previous file by the same file name, you
will receive a warning that you are about to overwrite the previous file. If
you choose to overwrite the previous file, the previous file is saved as a
.bak file.
7-16 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Viewing Specific Events in the PEM Window
From the PEM window View pull-down menu, you can quickly isolate
Alarm and Warning events with the following actions:
In addition, you can restrict the view of events displayed in the window
or modify a persistent filter by using the PEM filtering feature. See
“Filtered View of Events” on page 7-26.
The event information that you can view with the PEM depends upon
which PATROL KMs you have loaded on a monitored host and how you
have defined the PEM’s persistent.
A PEM window displays events for a single computer. You can open one
or more PEM windows from the PATROL Console to view events from
different PATROL Agents.
7-18 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Displaying Events for a Specific Host
Summary: Although the PEM window displays events for a single computer, the
PEM window can be use to view events for all monitored computers
(hosts) that have been defined for your PATROL Console. With the
PATROL Console, you can open a PEM window for each host that you
are interested in. This task describes how to display events for each
host.
You must be connected to one or more hosts. For more information about
connecting to hosts from your PATROL Console, refer to the PATROL for
Microsoft Windows User Guide—Understanding the Basics of PATROL.
Step 1 Right-click a host icon on your PATROL desktop (that is, the
PatrolMainMap window).
The PEM window for the selected host appears. You can either view all
the specified events for the monitored host or change the view filter for
this PEM window to view only events of particular interest. (See optional
Step 3 and Step 4 below.)
Step 3 If you want to set filter criteria for viewing events, perform these actions:
3.B Select or type the desired filter criteria in the resulting Filter
Window dialog box.
3.C Click OK to apply the filter and return to the PEM window to
view filtered events.
Step 5 Choose File => Exit this window to close the PEM window.
Once you have selected events for viewing, you can perform additional
tasks.
Task Where to Go
perform various tasks on events to page 7-36
help you manage them
sort events in the PEM window page 7-34
learn more about setting filters page 7-26
display event details page 7-21
7-20 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Displaying and Working with Event Details
Summary: When viewing events from the PEM window, you see only a portion of
the details available for an event. In this task, you will access the Event
Details dialog box to view all details for an event. You can also view the
detailed information and record entries as needed in an event diary.
• You are connected to one or more hosts. For more information about
connecting to hosts from your PATROL Console, refer to the
PATROL for Microsoft Windows User Guide—Understanding the
Basics of PATROL.
• Click once on an event to select it, and then click the Detail toolbar
icon ( ).
• Right-click an event in the list and select Details from the context
menu.
Note
Right-clicking an event and selecting Locate from the context menu
displays the container of the object that triggered the event on the
PATROL desktop.
A separate dialog box displays expert advice for the event class to
which the selected event belongs. If the expert advice contains an
address to a URL on the World Wide Web, you can highlight the
URL and click WWW for PATROL to launch your default Web
browser and display the Web page specified by the URL. For detailed
information about expert advice, see “How to Manage Events” on
page 7-36.
Note
You can add or modify the expert advice for any event class(es) in any
event catalog only with a PATROL Developer Console.
A text entry box appears in which you can type comments, including
URLs to Web pages. For detailed information about creating diary
entry, see “Making an Entry in the Event Diary” on page 7-38.
• Highlight a World Wide Web URL in the Event Diary and click the
WWW button. PATROL launches your default Web browser and
displays the Web page specified by the URL.
Step 3 Click OK to close the Event Details dialog box. Any changes you have
made will be saved.
7-22 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Figure 7-10 Event Details Dialog Box
The Event Details dialog box displays the following information items
for the selected event:
Table 7-5 Information Items of the Event Details Dialog Box (Part 1 of 3)
Item Description
Status shows the current event status
You can filter events according to their status.
Type indicates the event type
You can filter events according to their type.
Severity displays the numerical severity of the event
Severity is defined for events at the event class
level. You can filter events on the basis of severity.
The lowest severity is 1 and the highest severity is
5.
If, for example, you set the filter severity at 1, then
all events with a severity of 1 through 5 will be
displayed. If you set the filter severity at 4, then all
events with a severity of 4 or 5 will be displayed.
Time Outstanding shows the amount of time elapsed since the event
occurred
Item Description
ID shows the sequential number the PATROL Agent
creates for every event
Event Class shows the name (sometimes represented by a
number) of the event class to which this event
belongs.
For more detailed information about creating event
catalogs and event classes and about defining
application classes, refer to the PATROL for
Microsoft Windows User Guide—Customizing
PATROL.
Escalation shows the amount of time after which the event will
be escalated unless someone closes or
acknowledges the event
Escalation actions are OS commands.
Time shows the day, date, and time the event occurred
Node shows the node where the event originated
This is usually a computer host name but is PEM if
the event has been generated by the PATROL
Event Manager from a PATROL Console.
Origin shows the name of the monitored object that
triggered the event
The object can be a computer instance, an
application instance, or a parameter.
Owner indicates who is assigned as the owner of this
particular event class
The default is Patrol. With a PATROL Developer
Console, you can create or modify your own event
classes and add them to an event catalog. If you
edit an event class, you can determine who will be
the owner of that specific class of events.
For example, if the PEM is integrated with a Help
desk facility, a trouble ticket can be automatically
created and assigned to the event owner.
Handled By shows the name of the person who last performed
an action on an event
Actions include acknowledging, closing, entering
diary information for, or deleting an event.
7-24 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Table 7-5 Information Items of the Event Details Dialog Box (Part 3 of 3)
Item Description
Event Catalog shows the name of the event catalog, which is a
collection of event classes
Events that are part of the standard event catalog
are standard with PATROL and have a numeric
event class code for optimization purposes. You can
create an event catalog for any application class
and associate event classes with the catalog.
For more information about event catalogs, event
classes, and application classes, refer to the
PATROL for Microsoft Windows User
Guide—Customizing PATROL.
Life Expectancy controls whether an event is stored in the event
history repository
If an event has a life expectancy of Stored, it will be
stored. If it has a life expectancy of Delete if closed,
it will not be stored if it is closed. If an event’s life
expectancy is Delete if information, it will not be
stored if it is an information event.
The default event life expectancy is Stored. Events
that are written to the event history repository
remain there until the repository is full, at which
time the oldest events are deleted first to make
room for new events.
Event Description gives a brief description of the nature of the event
From the PEM Filter Window dialog box, you can
enter descriptive text in the Pattern field as filter
criteria.
Event Diary shows a chronological listing of comments and
actions taken on this event
For detailed information about adding comments in
this window, see “Making an Entry in the Event
Diary” on page 7-38. PATROL time-stamps any
comments that are added to the diary.
Once you have opened an Event Details dialog box, you can perform
these tasks:
Task Where to Go
add event diary information for page 7-38
a particular event
create expert advice PATROL for Microsoft Windows
User Guide—Customizing
PATROL
• a persistent filter
• a view filter
The persistent filter determines which events to forward to the PEM from
the PATROL Agent’s event history repository. The persistent filter can be
saved and used in your next session. The view filter helps you create a
selective view of the events that have been forwarded from the PATROL
Agent. You set up a view filter for your current session.
Persistent Filter
A persistent filter can be modified and set up from the Filter Window
dialog box. Click the Set Filter toolbar icon ( ) in the PEM window to
access the Filter Window dialog box. An example Filter Window dialog
box is shown in Figure 7-11 on page 7-28. The persistent filter remains in
effect as long as the PATROL Agent maintains its connection with the
PATROL Console.
7-26 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
A Persistent Filter Criteria dialog box displays the view filter criteria that
you choose in the Filter Window dialog box to select the events currently
shown in the PEM window. Choose View => Show Persistent Filter to
display the Persistent Filter Criteria dialog box. You cannot modify any
of the information in the Persistent Filter Criteria dialog box.
View Filter
You can create a custom view filter for your current PEM session by
selecting criteria for events to be forwarded from the PATROL Agent to
the PATROL Console. Each time you alter your selection of events for
viewing from the PEM Filter Window dialog box, the PEM stores this
customized View Filter for reuse. The PEM stores the five most recent
View Filters for reuse during a PEM session.
You can use the Set Filter toolbar icon at the top of the PEM window to
display the Filter Window dialog box, where you can select or deselect
filter criteria.
7-28 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Setting a View Filter
Summary: In this task, you will create a custom filter for your current PEM session
by using the Filter Window dialog box to select criteria for viewing and
acting on events.
• You are connected to one or more hosts. For more information about
connecting to hosts from your PATROL Console, refer to the
PATROL for Microsoft Windows User Guide—Understanding the
Basics of PATROL.
The Filter Editor dialog box appears, similar to the one shown in Figure
7-11 on page 7-28. Click Help for detailed descriptions of the
information fields.
Step 2 Check Absolute Time to view events that took place between a specific
start time and end time. Clear Absolute Time to view events that took
place during a past period of time relative to the current time.
Step 3 In the Filter Window dialog box, indicate the start and end dates and
times for the events you want to view.
3.A Highlight the start or end month, day, year, hour, minute, or
second you want to change. If you removed the check from the
Absolute time option in Step 2, highlight the Rollback time and
Range.
BMC Software, Inc., Confidential and Proprietary Information
The start (or Rollback) date and time default to the age of the
oldest event in the event history repository (or repositories, for a
PEM window showing events for multiple hosts). The end date
and time (or Range time from Rollback date and time) default to
the age of the newest event in the event history repository (or
repositories).
Step 4 Select or type the remaining event filter criteria in the Filter Window
dialog box.
Include an asterisk wildcard character in entries for the Node, Origin, and
Pattern fields to view events that match multiple criteria.
7-30 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Step 6 Click OK to save and apply the view filter and return to the PEM
window.
The events that match the view filter criteria are displayed in the PEM
window.
Once you have filtered your event view, you can perform these tasks:
Task Where to Go
perform various tasks on events to page 7-36
help you manage them
sort events in the PEM window page 7-14
Summary: In this task, you will use the PEM Filter Window dialog box to set the
persistent filter that governs which events are forwarded from PATROL
Agents.
• You are connected to one or more hosts. For more information about
connecting to hosts from your PATROL Console, refer to the
PATROL for Microsoft Windows User Guide—Understanding the
Basics of PATROL.
Step 1 Click the Set Filter toolbar icon to open the Filter Window dialog box.
Step 2 Select the filter criteria that you want to retain and click Make
Persistent.
The view filter criteria that you selected will be saved and sent to the
PATROL Agent as the persistent filter for the PEM window.
Once you have set a persistent filter, you can perform these tasks:
Task Where to Go
perform various tasks on events to page 7-36
help you manage them
sort events in the PEM window page 7-14
7-32 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Viewing a Persistent Filter
Summary: In this procedure you will display the Persistent Filter dialog box, which
shows the persistent filter currently in use.
Note
As you hover the cursor over the column headings, the cursor changes to
either an arrow facing up or an arrow facing down. The arrow facing up
indicates that the sort criteria for that column is set for ascending order,
while the arrow facing down indicates that descending order is set.
7-34 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Sorting Events in the PEM Window
Summary: In this task, you will sort events viewed in the PEM window.
PEM window
Sort Sort
1 3
or
Column Heading
(Mouse)
Click on a column heading to sort events in
either ascending or descending order. As new
events occur, they are displayed at the bottom
of the PEM window. Click either the Sort
Ascending or the Sort Descending toolbar
button to re-sort events. Click again on the
column heading to toggle the sort criteria
between ascending and descending order.
• You are connected to one or more hosts. For more information about
connecting to hosts from your PATROL Console, refer to the
PATROL for Microsoft Windows User Guide—Understanding the
Basics of PATROL.
Step 1 Click on a PEM window column heading. The events are sorted
accordingly.
Note
After a sorting operation, all new events are placed at the bottom of the
event list as they occur. Events are not re-sorted automatically.
Step 2 Click either the Sort Ascending or Sort Descending toolbar icon to
re-sort events by using the most recent column selection.
Once you have sorted your event view, you can perform these tasks:
Task Where to Go
perform various tasks on events to page 7-36
manage them
Note
You can create expert advice only from a PATROL Developer Console.
For information on how to provide expert advice to other PATROL users,
see the PATROL for Microsoft Windows User Guide—Customizing
PATROL.
7-36 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
• change the event status to acknowledged, closed, or deleted to
coordinate problem resolution within a group of PATROL operators
When you acknowledge, close, or delete an event, all users viewing the
event are notified in real time. The Event Diary is updated to indicate the
name of the person changing the event status. This update allows many
operators to work together in a distributed environment. Figure 7-12
shows how real-time updates can be made in a multiuser environment.
The same event “e” is viewed by three users connected to the same PATROL Agent
from a console or from a PEM window. Additionally, PATROL event “e” can generate a
Remedy Trouble Ticket “e#.” If any user acknowledges, closes, or deletes event “e,” all
connected consoles are notified in real time.
PATROL PEM
“e” “e”
(event) (event)
PEM
PATROL Remedy
“e”
(event)
Event Remedy
Repositor Database
“e” “e#”
Summary: In this task, you will make entries in the PEM Event Diary. You can enter
a comment in the Event Diary for an event at any time.
Before you make an entry into the PEM Event Diary, make sure
• You are connected to one or more hosts. For more information about
connecting to hosts from your PATROL Console, refer to the
PATROL for Microsoft Windows User Guide—Understanding the
Basics of PATROL.
• You have a Event Details dialog box open to make an entry in the
Event Diary. For a description of how to open an Event Details
dialog box, see “Displaying and Working with Event Details” on
page 7-21.
Step 1 From the Event Details dialog box, click Diary to open the Event Diary
dialog box.
The Event Diary text editor dialog box, similar to the one in Figure 7-13,
is displayed.
7-38 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Figure 7-13 Event Diary Text Editor Dialog Box
Step 2 Enter your comments in the text editor entry field. If available, enter a
World Wide Web address to provide a link to additional information for
other PATROL operators.
The text editor field automatically supports word wrap, but the display
field on the Event Details dialog box where your comments appear does
not. You can either type your entry so that it displays only one line, or
you can press Enter occasionally to create new lines, which makes your
entry more readable in the Event Details dialog box.
Step 3 Click OK to save your entry and store it in the Event Diary.
Your comment is stored in the Event Diary with the current date and user
name. If you want to restrict your view to only those events that you are
responsible for, use the Pattern field on the Filter Window dialog box to
filter events that match your user name.
Task Where to Go
perform tasks on events, such as PATROL for Microsoft
creating expert advice or defining new Windows User
event classes Guide—Customizing
PATROL
acknowledge, close, or delete an event page 7-41
7-40 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Acknowledging, Closing, or Deleting a Single Event
When you acknowledge an event, you imply that you accept the
responsibility for taking action on it.
When you close an event, you imply that the event has been examined
and that the problem causing the event has been dealt with.
When you delete an event, you imply that the event is no longer
important enough to keep a record of it.
• You are connected to one or more hosts. For more information about
connecting to hosts from your PATROL Console, refer to the
PATROL for Microsoft Windows User Guide—Understanding the
Basics of PATROL.
Step 1 From a PEM window, select the event (the event is highlighted).
Acknowledge Event
1 3
Close Event
(Mouse)
Delete Event
The Status column entry is changed for the selected event, and the event
is moved to the bottom of the list.
If you want to continue managing events, you can choose one of the
following tasks.
Task Where to Go
perform tasks on events, such as PATROL for Microsoft
creating expert advice or defining new Windows User
event classes Guide—Customizing
PATROL
make an entry in the event diary page 7-38
perform matching operations on events page 7-43
7-42 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Performing Matching Operations
Summary: In this task, you will simultaneously close, acknowledge, or delete all
events listed in a PEM window that match the current filter criteria.
These are called matching operations.
• You are connected to one or more hosts. For more information about
connecting to hosts from your PATROL Console, refer to the
PATROL for Microsoft Windows User Guide—Understanding the
Basics of PATROL.
Step 1 Use the PEM window to select all the events on which you want to
perform a matching operation. You can choose View => Show Persistent
Filter. (Refer to “Filtered View of Events” on page 7-26 for more
information about filtering events.)
Note
Make sure that your filter does not include Response events. Matching
operations do not work for Response events. Response events require
individual attention.
Step 2 From the following PEM window menu options, choose the matching
operation you want to perform:
Matching operations are executed on all events that match your current
filter criteria.
If you want to continue managing events, you can perform these tasks:
Task Where to Go
perform tasks on events, such as PATROL for Microsoft
creating expert advice or defining new Windows User
event classes Guide—Customizing
PATROL
make an entry in the event diary page 7-38
acknowledge, close, or delete an event page 7-41
7-44 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
— total in this window
— total open, acknowledged, closed, and deleted
— totals of each type (alarm, warning, state change, error, and
information)
• time recorded for the earliest and the most recent event
You can identify any recorded event by an event notification ID and the
event time. The PATROL Agent assigns a unique numerical event ID to
each event it records in the event history repository. The agent increments
the event ID number by 1 for each new event. The difference between the
smallest and largest ID numbers indicates how many events have been
recorded.
Summary: In this task, you will display an Event Repository Statistics window for
the PATROL Agent machines (hosts) to which your PATROL Console is
connected. The report provides communications status information;
summary information about alarms, warnings, escalation events, and
error events; and information about state changes.
You must be connected to one or more hosts. For more information about
connecting to hosts from your PATROL Console, refer to the PATROL for
Microsoft Windows User Guide—Understanding the Basics of PATROL.
Step 1 From the PATROL Console main window, choose Tools => Event
Repository Statistics.
Step 2 Scroll the Event Repository Statistics window left and right to see all the
summary information for each PATROL Agent that your console is
connected to, or scroll up and down through the list of Agents.
7-46 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Step 3 To close the Event Repository Statistics window, click OK.
Column Description
PATROL Agent the machine name and UDP port number of all the agents
your PATROL Console is monitoring
Status the PATROL Agent communications status:
• OK means that statistics can be obtained
• Not OK means that a report from the Agent cannot be
generated, possibly because of communication errors
Last Update the date and time the statistics for this host were last
obtained
Total the total number of events in this agent's event history
repository
Open the total number of events with a status of Open
Ack'd the total number of events with a status of Acknowledged
Closed the total number of events with a status of Closed
Escal'd the total number of events with a status of Escalated
Deleted the total number of events with a status of Deleted
Alarm the number of events of type Alarm
Warning the number of events of type Warning
Error the number of events of type Error
State the number of events of type State Change
Info the number of events of type Information
Response the number of events of type Response
Summary: In this task, you will display an Event Repository Statistics report for all
the events listed in the PEM window that is currently open.
• You are connected to one or more hosts. For more information about
connecting to hosts from your PATROL Console, refer to the
PATROL for Microsoft Windows User Guide—Understanding the
Basics of PATROL.
Step 1 From the PEM window menu bar, choose Options => Window
Statistics.
7-48 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Figure 7-16 PEM Window Statistics Report
7-50 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Index
Index
Index 1
annotated data points 2-23 to manage PATROL Agent 5-4
application discovery
enabling automatic discovery 5-4
application instance C
alarm state 1-4
deactivated status 1-4 cache, parameters 2-4
filtered status 1-4 charting server
icon state 1-3 to 1-4 See PATROL Console Charting Server
offline state 1-4 charts
OK state 1-4 annotated data points 2-23
refreshing parameters 2-51 axes properties 2-38
states 1-3 chart chart properties 2-39 to 2-41
warning state 1-4 creating 6-58
applications creating folder for 2-21
Agent Query 6-20 data history 2-26
enabling automatic discovery 5-3 data point coordinates 2-32
managing objects 3-2 to 3-7 data series properties 2-45 to 2-46
overriding discovery properties 2-53 to data statistic displays 2-31
2-54 display options 2-28
running commands/tasks on 4-3 files used 2-13
running menu items against 4-6 gridline properties 2-41 to 2-42
architecture, PEM 7-3 legend properties 2-43 to 2-45
arguments and running of commands 4-4, main window 2-12 to 2-13
4-7 manipulating data using 2-20 to 2-28,
attributes, overriding of parameter 2-55 2-28 to 2-39
optional chart views 2-29 to 2-30
parameter types available 2-9 to 2-11
B plotting data 2-27
removing parameters 2-24
Boolean parameters 1-5, 1-6 rotating in 3-D 2-33
built-in commands saving 2-22
available 4-13 tasks and menu commands 2-15 to 2-19
in OS commands 4-9, 4-15 time period plots 2-27
parameter recovery 1-8 title properties 2-42
PATROL Agent setup 1-10 zoom feature 2-34
running 4-15 children
state change actions 1-10 object relationship 3-1
built-in macro variables classes
parameter recovery 1-8 computer/application 4-6
PATROL Agent setup 1-10 event 1-11
state change actions 1-10 closing and exiting
BMC Software, Inc., Confidential and Proprietary Information
2 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
Agent Query 6-70 finding objects 6-56
PEM 7-41, 7-42, 7-51 opening 6-57
collector parameters 2-7
command dialog 4-7 to 4-12
accessing 4-7 D
commands
argument prompting 4-7 data point coordinates 2-32
arguments passed at run time 4-4 data statistic displays 2-31
built-in 4-13 date range for view filter 7-29
built-in, PSL 1-8, 1-10 date range in view filter 7-29
checking PSL syntax 4-13 deactivated status 1-4, 1-6
escalation 1-11 deleting
event class 1-11 events 7-41
events 1-11 deleting events 7-41
methods of using 4-2 to 4-15 Desktop tree, parameter icon states 1-5
notification 1-11 dialog boxes
output 4-16 Event Details 7-21
PATROL Agent 1-11 event details 7-8, 7-21 to 7-25
PATROL Agent setup 1-8, 1-10 Event Diary 7-38
PATROL Console 1-8, 1-9 Event Diary text editor 7-39
PATROL Script Language (PSL) 4-12 Filter Editor 7-9, 7-26 to 7-33
running 4-2 Filter Window 7-9
types 4-3 Search and Select 6-39
with built-in macro variables 4-7 Window Statistics 7-12
writing with text editor 4-11 Windows Statistics 7-12
computer classes Diary push button 7-8, 7-25, 7-38
running menu items against 4-6 discovery properties, overriding of
computer instances application 2-53 to 2-54
refreshing parameters 2-51 display methods
computers Agent Query 6-3 to 6-13, 6-35
icon states 1-2 to 1-6 annotated date points 2-23
object management 3-1, 3-2 to 3-8 Console Charting Server 2-12 to 2-13
Quick Query 6-18 multiple agent statistics 7-46 to 7-48
running commands/tasks on 4-3 output from commands/tasks 4-16
running menu items against 4-6 parameter icon states 1-5
select options with queries 6-37 parameters 2-9
connections, computers to agents 6-54 PEM 7-4 to 7-17, 7-18 to 7-26, 7-46
consumer parameters 2-7 system output 4-4
containers table columns in queries 6-43 to 6-44
adding objects 6-52 displaying
Index 3
event information and details 7-18 to information items 7-50
7-26 Event Repository Statistics window 7-47
event statistics for multiple hosts 7-46 description 7-10
events for a specific host 7-19 displaying 7-46
events for multiple hosts 7-14 information items 7-47
Expert Advice 7-22 events
PEM window statistics report 7-49 acknowledge 1-11
acknowledging 7-41
classes 7-24
E close 1-11
closing 7-41
entry color coding in PEM 7-5
making in Event Diary 7-38 commands 1-11
error messages 1-7 definition 7-2
escalation commands 1-11 delete 1-11
event deleting 7-41
ID in a Window Statistics report 7-50 details 7-21
ID in Event Details dialog 7-24 displaying information 7-18 to 7-25
Event Catalog 7-25 escalate 1-11
event commands 1-11 escalation 7-24
Event Description 7-25 event details dialog box 7-8, 7-21 to
Event Details dialog box 7-25
accessing 7-21 Event Diary 7-38 to 7-39
description 7-8 event messages 1-7
information items 7-23 filters 7-26
working with 7-23 generating statistics 7-44 to 7-49
Event Diary handling 7-24
accessing 7-8, 7-9, 7-22, 7-38 life expectancy 7-25
adding comments to 7-22 managing 7-16
definition 7-25 with matching operations 7-16
making an entry 7-38 node 7-24
using 7-25, 7-38 to 7-39 origin 7-24
Event Diary text editor dialog box 7-39 owner 7-24
event filter PATROL Event Manager (PEM)
persistent 7-26 event messages 1-7
view 7-27 severity 7-23
event history repository 7-3 sorting 7-14, 7-34 to 7-36
Event Repository Statistics status 1-11, 7-23, 7-50
menu bar for window 7-11 summary statistics 7-12
Event Repository Statistics report time 7-24
displaying 7-49
BMC Software, Inc., Confidential and Proprietary Information
4 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
time outstanding 7-23 graphs. See also charts
types 7-23 grouping of
viewing 7-17 computers/applications/parameters 3-2
viewing specific 7-17
Expert Advice 7-22
H
F hidden applications 1-4
hiding queries 6-49
filter criteria for matching operations 7-43 history
Filter Window dialog box icon states 1-6
accessing 7-27 parameters 2-5, 2-26, 2-47 to 2-49
description 7-9 History Loader 2-48
using 7-26 to 7-33 hosts. See computers 1-12
filter, application 1-4
filter, event 7-26
filter, persistent 7-32 I
filter, view 7-31
folders icon state 1-3, 1-5
creating 3-4 icons
graph 2-21 computer/application 1-2 to 1-6
managing objects 3-4 to 3-8 parameter 2-6
folders, deleting 3-8 InfoBoxes 1-7
instances
icon states 1-4
G refreshing parameters for 2-51, 2-52
inverting x- and y-axis 2-30
gauge parameter 1-5
gauges, opening 6-57
generating K
event statistics for a PEM window 7-17
event statistics reports 7-44 KM. See PATROL KMs
graph parameter 1-5
graphs
adding objects 6-52 L
annotated data points 2-23
creating folder for 2-21 legend, chart 2-29
opening 6-57 logarithmic y-axis 2-29
parameter types available 2-9, 2-10 to
2-11
time period plots 2-27
BMC Software, Inc., Confidential and Proprietary Information
Index 5
M output messages pending 1-3
output, command/task 4-16
macro variables, built-in overriding parameters 2-55
parameter recovery 1-8
Make Persistent push button 7-28, 7-32
managing events P
with matching operations 7-16
param.hist file 2-47
matching operations, PEM 7-37
parameter 2-49
menu commands
parameters
objects 4-5
Boolean 1-5, 1-6
PEM 7-6
charts and graphs for 2-9 to 2-46
role of 1-9
deactivated status 1-6
monitored objects 7-3
history 2-47 to 2-48
history data 2-5
N icon states 1-5
manipulating 2-49
new data status 1-3 object management 3-2 to 3-7
no history status 1-6 overriding 2-55
notification commands 1-11 overriding discovery 2-53
overview 2-3 to 2-8
recovery action 1-8
O viewing information on 2-8, 2-11
warning and alarm 1-8
objects parent 3-1
adding to containers/graphs 6-52 PATROL Agent
and Agent Query 1-12, 6-36 to 6-42, commands 1-10 to 1-11
6-51 to 6-53 configuration file 2-4
creating charts 6-58 events 1-7, 7-44
finding object’s container 6-56 management 5-1 to 5-7
hierarchy management 3-1 to 3-8 monitoring load 5-2
icon states 1-2, 1-3, 1-5 parameters role 2-3
menu commands 4-5 prerequisites for tuning 5-2
moving to a folder 3-6 setup commands 1-10
queries 6-5 startup and shutdown command 1-11
removing from a folder 3-7 state change actions 1-10
offline state 1-4, 1-5 tasks to manage 5-3
OK state 1-3, 1-4, 1-5 tuning 5-1
OS (operating system) commands 4-4, 4-6, work load parameters 5-2
4-8 work rate 5-2
PATROL Console
BMC Software, Inc., Confidential and Proprietary Information
6 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
and state change actions 1-10 persistent filter, PEM
error messages 1-7 description 7-26
startup and shutdown command 1-11 setting 7-28
PATROL Console Charting Server viewing 7-33
chart axes properties 2-38 to 2-39 polling cycles
chart chart properties 2-39 to 2-41 parameters 2-3
chart data series properties 2-45 to 2-46 property elements
chart gridline properties 2-41 to 2-42 applications tab 6-21
chart legend properties 2-43 to 2-45 computers tab 6-21
chart title properties 2-42 instances tab 6-23
files used 2-13 parameters tab 6-23
main window 2-12 to 2-13 PSL. See PATROL Script Language
manipulating data using 2-20 to 2-28,
2-28 to 2-37
tasks and menu commands 2-15 to 2-19 Q
PATROL desktop 7-14
PATROL Event Manager (PEM) queries
displaying information/details 7-18 to deleting with Query Box buttons 6-31
7-25 erasing with Query Box buttons 6-32
filtering 7-26 to 7-33 exporting to text file 6-65
generating statistics 7-44 to 7-50 hiding 6-49
graphical components 7-4 to 7-13 modifying 6-26 to 6-31
managing 7-36 to 7-44 object management 6-51 to 6-64
operations and tasks 7-2 to 7-3 reissuing 6-45 to 6-48
sorting 7-34 to 7-36 results 6-6 to 6-13, 6-50, 6-64 to 6-65
toolbar 7-7 saving 6-61 to 6-64, 6-69
PATROL KM tree queries (Agent Query)
and parameter icons 1-5 capabilities of 1-12
PATROL KMs creating 6-15 to 6-25
and error messages 1-7 issuing 6-32 to 6-34
and PEM 7-18 overview 6-3 to 6-13
and Service Reporting process and examples 6-13 to 6-15
commands 1-9 queries (Quick Query)
event information 7-18 using 6-18 to 6-19
History Loader 2-48
menus 1-9
PATROL Script Language (PSL) R
parameters 1-8, 2-3
running 4-3, 4-7, 4-8, 4-12 ranges
PatrolMainMap 7-14 alarm 2-3
recovery action, parameter 1-8
BMC Software, Inc., Confidential and Proprietary Information
Index 7
recovery actions information 7-46
parameter 1-8, 1-10 statistics
refreshing parameters for instances 2-51 to charts 2-31
2-52 generating for a PEM window 7-17
reissue of queries 6-45 to 6-48 PEM 7-10 to 7-13, 7-44 to 7-50
summary event 7-12, 7-44
stoplight parameter 1-5, 1-6
S suspended parameter, icon state 1-6
system knowledge module 5-2
saving System Output window 1-9, 4-4, 4-16
charts and graphs 2-22
queries 6-61 to 6-64, 6-69
schedules, parameter 2-3 T
search and select dialog box 6-39
select by options, Agent Query 6-36 to 6-38 tables, column displays in Agent Query 6-43
select rows to 6-44
in Query Results table 6-38 task commands 1-9
using Search and Select dialog box 6-39 Task Output window 4-16
SELECT statements 6-16 to 6-32 tasks
Service Reporting methods of using 4-2 to 4-15
and PATROL KMs output 4-16
setting parameter shortcut menu 2-8
persistent filter 7-32 PATROL Agent management 5-3 to 5-7
setup commands PATROL Console Charting Server 2-15
PATROL Agent 1-10 to 2-19
vs. startup and shutdown commands role of 1-9
1-11 text editor and running commands 4-11
shortcuts 3-9 to 3-11 text parameter 1-5
shutdown commands thresholds for parameters 2-3
PATROL Agent 1-11 time range for view filter 7-29
snoozed parameter, icon state 1-6 title properties
snoozed status 1-6 of charts 2-42
sorting tuning of PATROL Agent 5-1 to 5-3
PEM 7-14, 7-34 to 7-36
query results 6-40 to 6-42
sorting events 7-14, 7-34 to 7-36 U
SQL statements 6-16
standard parameters 2-6, 2-7 updating parameters 2-3
startup commands, PATROL Agent 1-11 user preferences 1-11
state change actions 1-10 user-defined commands 4-3
state changes 7-3
BMC Software, Inc., Confidential and Proprietary Information
8 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
V
value history 2-49
view filter, PEM 7-26 to 7-31
void state 1-2
W
warnings, icon states 1-3, 1-4, 1-5
WHERE statements 6-16 to 6-32
window displays
Agent Query 6-3 to 6-13, 6-34, 6-63 to
6-65
parameter icon states 1-5
PATROL Console Charting Server 2-10
to 2-11
PEM 7-4 to 7-17, 7-46 to 7-50
System Output 4-4, 4-16
Window Statistics dialog box 7-12
window statistics reports, PEM 7-49 to 7-50
windows
Event Repository Statistics 7-10
PatrolMainMap 7-14
Index 9
BMC Software, Inc., Confidential and Proprietary Information
10 PATROL Console for Microsoft Windows User Guide—Monitoring and Managing with PATROL
END USER LICENSE AGREEMENT
NOTICE
BY OPENING THE PACKAGE, INSTALLING, PRESSING "AGREE" OR "YES" OR USING THE PRODUCT, THE ENTITY OR
INDIVIDUAL ENTERING INTO THIS AGREEMENT AGREES TO BE BOUND BY THE FOLLOWING TERMS. IF YOU DO NOT
AGREE WITH ANY OF THESE TERMS, DO NOT INSTALL OR USE THE PRODUCT, PROMPTLY RETURN THE PRODUCT TO
BMC OR YOUR BMC RESELLER, AND IF YOU ACQUIRED THE LICENSE WITHIN 30 DAYS OF THE DATE OF YOUR ORDER
CONTACT BMC OR YOUR BMC RESELLER FOR A REFUND OF LICENSE FEES PAID. IF YOU REJECT THIS AGREEMENT,
YOU WILL NOT ACQUIRE ANY LICENSE TO USE THE PRODUCT.
This Agreement ("Agreement") is between the entity or individual entering into this Agreement ("You") and BMC Software Distribution,
Inc., a Delaware corporation located at 2101 CityWest Blvd., Houston, Texas, 77042, USA or its affiliated local licensing entity ("BMC").
"You" includes you and your Affiliates. "Affiliate" is defined as an entity which controls, is controlled by or shares common control with
a party. THIS AGREEMENT WILL APPLY TO THE PRODUCT, UNLESS (1) YOU AGREED TO A WEB BASED LICENSE
AGREEMENT WITH BMC WHEN ORDERING THE PRODUCT, IN WHICH CASE THAT WEB BASED LICENSE AGREEMENT
GOVERNS THE USE OF THE PRODUCT, OR (2) IF YOU DID NOT AGREE TO A WEB BASED LICENSE AGREEMENT WITH BMC
WHEN ORDERING THE PRODUCT AND YOU HAVE A WRITTEN LICENSE AGREEMENT WITH BMC, THEN THAT WRITTEN
AGREEMENT GOVERNS THE USE OF THE PRODUCT. THE ELECTRONIC AGREEMENT PROVIDED WITH THE PRODUCT AS
PART OF THE INSTALLATION OF THE PRODUCT WILL NOT APPLY. In addition to the restrictions imposed under this Agreement,
any other usage restrictions contained in the Product installation instructions or release notes shall apply to Your use of the Product.
PRODUCT AND CAPACITY. "Software" means the object code version of the computer programs provided, via delivery or electronic
transmission, to You. Software includes computer files, enhancements, maintenance modifications, upgrades, updates, bug fixes, and
error corrections.
"Documentation" means all written or graphical material provided by BMC in any medium, including any technical specifications,
relating to the functionality or operation of the Software.
"License Capacity" means the licensed capacity for the Software with the pricing and other license defining terms, including capacity
restrictions, such as tier limit, total allowed users, gigabyte limit, quantity of Software, and/or other capacity limitations regarding the
Software. For licenses based on the power of a computer, You agree to use BMC’s current computer classification scheme, which is
available at http://www.bmc.com or can be provided to You upon request.
ACCEPTANCE. The Product is deemed accepted by You, on the date that You received the Product from BMC.
LICENSE. Subject to the terms of this Agreement, as well as Your payment of applicable fees, BMC grants You a non-exclusive,
non-transferable, perpetual (unless a term license is provided on an order) license for each copy of the Software, up to the License
Capacity, to do the following:
(a) install the Software on Your owned or leased hardware located at a facility owned or controlled by You in the country where You
acquired the license;
(b) operate the Software solely for processing Your own data in Your business operations; and
(c) make one copy of the Software for backup and archival purposes only (collectively a "License").
If the Software is designed by BMC to permit you to modify such Software, then you agree to only use such modifications or new
software programs for Your internal purposes or otherwise consistent with the License. BMC grants You a license to use the
Documentation solely for Your internal use in Your operations.
LICENSE UPGRADES. You may expand the scope of the License Capacity only pursuant to a separate agreement with BMC for such
expanded usage and Your payment of applicable fees. There is no additional warranty period or free support period for license
upgrades.
(b) distribute or provide the Software to any third party (including without limitation, use in a service bureau, outsourcing environment,
or processing the data of third parties, or for rental, lease, or sublicense); or
(c) provide a third party with the results of any functional evaluation or benchmarking or performance tests, without BMC’s prior written
approval, unless prohibited by local law.
TRIAL LICENSE. If, as part of the ordering process, the Product is provided on a trial basis, then these terms apply: (i) this license
consists solely of a non-exclusive, non-transferable evaluation license to operate the Software for the period of time specified from BMC
or, if not specified, a 30 day time period ("Trial Period") only for evaluating whether You desire to acquire a capacity-based license to
the Product for a fee; and (ii) Your use of the Product is on an AS IS basis without any warranty, and BMC, ITS AFFILIATES AND
RESELLERS, AND LICENSORS DISCLAIM ANY AND ALL WARRANTIES (INCLUDING, WITHOUT LIMITATION, THE IMPLIED
WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT) AND HAVE NO
LIABILITY WHATSOEVER RESULTING FROM THE USE OF THIS PRODUCT UNDER THIS TRIAL LICENSE ("Trial License").
BMC may terminate for its convenience a Trial License upon notice to You. When the Trial Period ends, Your right to use this Product
automatically expires. If You want to continue Your use of the Product beyond the Trial Period, contact BMC to acquire a
capacity-based license to the Product for a fee.
TERMINATION. This Agreement shall immediately terminate if You breach any of its terms. Upon termination, for any reason, You must
uninstall the Software, and either certify the destruction of the Product or return it to BMC.
OWNERSHIP OF THE PRODUCT. BMC or its Affiliates or licensors retain all right, title and interest to and in the BMC Product and all
intellectual property, informational, industrial property and proprietary rights therein. BMC neither grants nor otherwise transfers any
rights of ownership in the BMC Product to You. BMC Products are protected by applicable copyright, trade secret, and industrial and
intellectual property laws. BMC reserves any rights not expressly granted to You herein.
CONFIDENTIAL AND PROPRIETARY INFORMATION. The BMC Products are and contain valuable confidential information of BMC
("Confidential Information"). Confidential Information means non-public technical and non-technical information relating to the BMC
Products and Support, including, without limitation, trade secret and proprietary information, and the structure and organization of the
Software. You may not disclose the Confidential Information to third parties. You agree to use all reasonable efforts to prevent the
unauthorized use, copying, publication or dissemination of the Product.
WARRANTY. Except for a Trial License, BMC warrants that the Software will perform in substantial accordance with the Documentation
for a period of one year from the date of the order. This warranty shall not apply to any problems caused by software or hardware not
supplied by BMC or to any misuse of the Software.
EXCLUSIVE REMEDY. BMC’s entire liability, and Your exclusive remedy, for any defect in the Software during the warranty period or
breach of the warranty above shall be limited to the following: BMC shall use reasonable efforts to remedy defects covered by the
warranty or replace the defective Software within a reasonable period of time, or if BMC cannot remedy or replace such defective copy
of the Software, then BMC shall refund the amount paid by You for the License for that Software. BMC’s obligations in this section are
conditioned upon Your providing BMC prompt access to the affected Software and full cooperation in resolving the claim.
DISCLAIMER. EXCEPT FOR THE EXPRESS WARRANTIES ABOVE, THE PRODUCT IS PROVIDED "AS IS." BMC, ITS
AFFILIATES AND LICENSORS SPECIFICALLY DISCLAIM ALL OTHER WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE
IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. BMC
DOES NOT WARRANT THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR FREE, OR THAT
ALL DEFECTS CAN BE CORRECTED.
DISCLAIMER OF DAMAGES. IN NO EVENT IS BMC, ITS AFFILIATES OR LICENSORS LIABLE FOR ANY SPECIAL, INDIRECT,
INCIDENTAL, PUNITIVE OR CONSEQUENTIAL DAMAGES RELATING TO OR ARISING OUT OF THIS AGREEMENT, SUPPORT,
AND/OR THE PRODUCT (INCLUDING, WITHOUT LIMITATION, LOST PROFITS, LOST COMPUTER USAGE TIME, AND DAMAGE
OR LOSS OF USE OF DATA), EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, AND IRRESPECTIVE OF ANY
NEGLIGENCE OF BMC OR WHETHER SUCH DAMAGES RESULT FROM A CLAIM ARISING UNDER TORT OR CONTRACT
LAW.
LIMITS ON LIABILITY. BMC’S AGGREGATE LIABILITY FOR DAMAGES IS LIMITED TO THE AMOUNT PAID BY YOU FOR THE
LICENSE TO THE PRODUCT.
SUPPORT. If Your order includes support for the Software, then BMC agrees to provide support (24 hours a day/7 days a week)
("Support"). You will be automatically re-enrolled in Support on an annual basis unless BMC receives notice of termination from You
as provided below. There is a free support period during the one year warranty period.
(a) Support Terms. BMC agrees to make commercially reasonable efforts to provide the following Support: (i) For malfunctions of
supported versions of the Software, BMC provides bug fixes, patches or workarounds in order to cause that copy of the Software to
operate in substantial conformity with its then-current operating specifications; and (ii) BMC provides new releases or versions, so long
as such new releases or versions are furnished by BMC to all other enrolled Support customers without additional charge. BMC may
refuse to provide Support for any versions or releases of the Software other than the most recent version or release of such Software
made available by BMC. Either party may terminate Your enrollment in Support upon providing notice to the other at least 30 days prior
to the next applicable Support anniversary date. If You re-enroll in Support, BMC may charge You a reinstatement fee of 1.5 times what
You would have paid if You were enrolled in Support during that time period.
(b) Fees. The annual fee for Support is 20% of the Software’s list price less the applicable discount or a flat capacity based annual fee.
BMC may change its prices for the Software and/or Support upon at least 30 days notice prior to Your support anniversary date.
VERIFICATION. If requested by BMC, You agree to deliver to BMC periodic written reports, whether generated manually or
electronically, detailing Your use of the Software in accordance with this Agreement, including, without limitation, the License Capacity.
BMC may, at its expense, audit Your use of the Software to confirm Your compliance with the Agreement. If an audit reveals that You
have underpaid fees, You agree to pay such underpaid fees. If the underpaid fees exceed 5% of the fees paid, then You agree to also
pay BMC’s reasonable costs of conducting the audit.
EXPORT CONTROLS. You agree not to import, export, re-export, or transfer, directly or indirectly, any part of the Product or any
underlying information or technology except in full compliance with all United States, foreign and other applicable laws and regulations.
GOVERNING LAW. This Agreement is governed by the substantive laws in force, without regard to conflict of laws principles: (a) in
the State of New York, if you acquired the License in the United States, Puerto Rico, or any country in Central or South America; (b) in
the Province of Ontario, if you acquired the License in Canada (subsections (a) and (b) collectively referred to as the "Americas
Region"); (c) in Singapore, if you acquired the License in Japan, South Korea, Peoples Republic of China, Special Administrative
Region of Hong Kong, Republic of China, Philippines, Indonesia, Malaysia, Singapore, India, Australia, New Zealand, or Thailand
(collectively, "Asia Pacific Region"); or (d) in the Netherlands, if you acquired the License in any other country not described above.
The United Nations Convention on Contracts for the International Sale of Goods is specifically disclaimed in its entirety.
ARBITRATION. ANY DISPUTE BETWEEN YOU AND BMC ARISING OUT OF THIS AGREEMENT OR THE BREACH OR
ALLEGED BREACH, SHALL BE DETERMINED BY BINDING ARBITRATION CONDUCTED IN ENGLISH. IF THE DISPUTE IS
INITIATED IN THE AMERICAS REGION, THE ARBITRATION SHALL BE HELD IN NEW YORK, U.S.A., UNDER THE CURRENT
COMMERCIAL OR INTERNATIONAL, AS APPLICABLE, RULES OF THE AMERICAN ARBITRATION ASSOCIATION. IF THE
DISPUTE IS INITIATED IN A COUNTRY IN THE ASIA PACIFIC REGION, THE ARBITRATION SHALL BE HELD IN SINGAPORE,
SINGAPORE UNDER THE CURRENT UNCITRAL ARBITRATION RULES. IF THE DISPUTE IS INITIATED IN A COUNTRY
OUTSIDE OF THE AMERICAS REGION OR ASIA PACIFIC REGION, THE ARBITRATION SHALL BE HELD IN AMSTERDAM,
NETHERLANDS UNDER THE CURRENT UNCITRAL ARBITRATION RULES. THE COSTS OF THE ARBITRATION SHALL BE
BORNE EQUALLY PENDING THE ARBITRATOR’S AWARD. THE AWARD RENDERED SHALL BE FINAL AND BINDING UPON
THE PARTIES AND SHALL NOT BE SUBJECT TO APPEAL TO ANY COURT, AND MAY BE ENFORCED IN ANY COURT OF
COMPETENT JURISDICTION. NOTHING IN THIS AGREEMENT SHALL BE DEEMED AS PREVENTING EITHER PARTY FROM
SEEKING INJUNCTIVE RELIEF FROM ANY COURT HAVING JURISDICTION OVER THE PARTIES AND THE SUBJECT MATTER
OF THE DISPUTE AS NECESSARY TO PROTECT EITHER PARTY’S CONFIDENTIAL INFORMATION, OWNERSHIP, OR ANY
OTHER PROPRIETARY RIGHTS. ALL ARBITRATION PROCEEDINGS SHALL BE CONDUCTED IN CONFIDENCE, AND THE
PARTY PREVAILING IN ARBITRATION SHALL BE ENTITLED TO RECOVER ITS REASONABLE ATTORNEYS’ FEES AND
NECESSARY COSTS INCURRED RELATED THERETO FROM THE OTHER PARTY.
U.S. GOVERNMENT RESTRICTED RIGHTS. The Software under this Agreement is "commercial computer software" as that term is
described in 48 C.F.R. 252.227-7014(a)(1). If acquired by or on behalf of a civilian agency, the U.S. Government acquires this
commercial computer software and/or commercial computer software documentation subject to the terms of this Agreement as
specified in 48 C.F.R. 12.212 (Computer Software) and 12.211 (Technical Data) of the Federal Acquisition Regulations ("FAR") and its
successors. If acquired by or on behalf of any agency within the Department of Defense ("DOD"), the U.S. Government acquires this
commercial computer software and/or commercial computer software documentation subject to the terms of this Agreement as
specified in 48 C.F.R. 227.7202 of the DOD FAR Supplement and its successors.
MISCELLANEOUS TERMS. You agree to pay BMC all amounts owed no later than 30 days from the date of the applicable invoice,
unless otherwise provided on the order for the License to the Products. You will pay, or reimburse BMC, for taxes of any kind, including
sales, use, duty, tariffs, customs, withholding, property, value-added (VAT), and other similar federal, state or local taxes (other than
taxes based on BMC’s net income) imposed in connection with the Product and/or the Support. This Agreement constitutes the entire
agreement between You and BMC and supersedes any prior or contemporaneous negotiations or agreements, whether oral, written or
displayed electronically, concerning the Product and related subject matter. No modification or waiver of any provision hereof will be
effective unless made in a writing signed by both BMC and You. You may not assign or transfer this Agreement or a License to a third
party without BMC’s prior written consent. Should any provision of this Agreement be invalid or unenforceable, the remainder of the
provisions will remain in effect. The parties have agreed that this Agreement and the documents related thereto be drawn up in the
English language. Les parties exigent que la présente convention ainsi que les documents qui s’y rattachent soient rédigés en anglais.
*17611*