Environment variables for custom tools – HP Systems Insight Manager User Manual

Page 67

Advertising
background image

Description

Name

by a universal resource locator (URL). Web-launch applications
that do not share Systems Insight Manager certificates should be
executed in a separate frame.

An application launch tool is a batch file, script, or executable
that runs on the CMS and can reference environment variables

Application launch tool OR CMS Tool in the GUI

specified by the tool to access device or event information. An
example of an application launch tool would be one that performs
a task that is tied to the contents of an “Exchange Servers” list
which returns three devices (A, B, and C). The tool will run three
times (in the context of A, B, and C).

Environment variables for custom tools

NOTE:

If your user-defined variables have the same names as the Systems Insight Manager environment

variables, the Systems Insight Manager environment variables override the user-defined variables.

DOS environment variables are supported in custom tool parameters and work as parameters on the New
Custom Tool

page or the Manage Custom Tools page. Unless you use DOS environment variables in a

batch or script file, you must surround them with double percent (%) signs. For example, to pass in the
NOTICELABEL environment variable as a parameter on the parameter line, enter %%NOTICELABEL%%. If
you use DOS environment variables in a batch file or script file, use only a single percent (%) sign before
and after the environment variable name.

NOTICELABEL. Type of notice. A small string that contains discovered system, other Systems Insight Manager
server-level notices, or the type of trap that caused the notice.

NOTICESTATE. An internal value used by Systems Insight Manager, indicating whether the notice is cleared.

NOTICEPLAINTEXT. A text description of the notice that contains details about the notice (In Progress, Cleared,
or Not Cleared).

NOTICERAWDATA. The raw data from the notice is passed as a string. This is a small pipe (|) delimited
set of variables and might be useful for some simple parsing rules.

NOTICESEVERITYSTR. A verbose description of the notice severity, which can be Critical, Informational,
Major, Minor, Unknown, Warning, or Normal.

NOTICESEVERITY. The integer value of the NOTICESEVERITYSTR which can be one of the following:

0, Unknown

1, Normal

2, Warning

3, Minor

4, Major

5, Critical

100, Informational

NOTICEQUERYNAME. The collection name based on how the notice was generated. This value can say
one of the following:

This system or event meets the following search criteria: +QueryName

;

This system or event now meets the following search criteria: +QueryName;

This system or event no longer meets the following search criteria:

+QueryName;

DEVICENAME. The name of the

system

that caused the notice.

DEVICEIPADDRESSCOUNT. The number of IP addresses that are mapped to this system.

DEVICEIPADDRESS%d . Based on the count, %d is an integer that shows the actual IP address. For example:

IF, DEVICEIPADDRESSCOUNT = 2

General concepts

67

Advertising