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

Page 76

Advertising
background image

Table 7 Tool types

Description

Name

An SSA tool executes on a selected target and is only
aware of the target system environment. In executing an
SSA tool, the Systems Insight Manager

Distributed Task

Facility

(DTF) of the CMS uses SSH to send one or more

files to the target system, which then executes the tool. An
example of an SSA tool would be a tool that wraps a
common Unix command such as ls. cat, or cp.

Single-system-aware command tool OR Remote Tool in the
GUI

An MSA tool executes typically on the CMS and can work
with multiple target systems. When launched, the MSA
process is created once and then passed to all targets on
the list. An XWindows tool is an example of an MSA tool.

Multiple-system-aware command tool

A WLA tool typically launches in a separate browser (by
default) or in the same frame as Systems Insight Manager
and is specified by a universal resource locator (URL).
Web-launch applications that do not share Systems Insight
Manager certificates should be executed in a separate
frame.

Web launch tool or Web page tool in the GUI

An application launch tool is a batch file, script, or
executable that runs on the CMS and can reference
environment variables 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).

Application launch tool or CMS Tool in the GUI

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

76

Systems Insight Manager custom tools

Advertising