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

Page 80

Advertising
background image

Table 8 Tool types (continued)

Description

Name

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.

An MSA tool executes typically on the CMS and can work
with multiple target systems. When launched, the MSA

Multiple-system-aware command tool

process is created once and then passed to all targets on
the list. An XWindows tool is an example of an MSA tool.

A WLA tool typically launches in a separate browser (by
default) or in the same frame as HP SIM and is specified

Web launch tool or Web page tool in the GUI

by a universal resource locator (URL). Web-launch
applications that do not share HP SIM 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

Application launch tool or CMS Tool in the GUI

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

Environment variables for custom tools

NOTE:

If your user-defined variables have the same names as the HP SIM environment variables,

the HP SIM 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 HP SIM
server-level notices, or the type of trap that caused the notice.

NOTICESTATE. An internal value used by HP SIM, 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

80

HP SIM custom tools

Advertising