HP Systems Insight Manager 5.3 Technical Reference Guide

Removing and restoring custom tools
Removing a tool
The Remove a Tool tool removes a tool from the menu for all users in HP SIM. The tool name must match the
name in the tool definition file.
CAUTION: This tool can remove any tool, including tools supplied by HP.
To remove a tool from HP SIM:
1. Select Options→Remove a Tool. The Remove a Tool page appears.
2. Under Parameters, add information using standard tool parameters. Tool name is the only required
field.
3. Click Run Now to run the task immediately, or click Schedule to schedule when the task runs. For more
information about scheduling a task, see “Scheduling a task”.
To remove tools using the command line, enter
mxtool -r -t badtool
Replace badtool with the name of the tool you want to delete. See mxtool(1M) for more information.
Restoring a tool
To restore a tool using the command line, enter:
mxtool -a -f /home/user1/defs/mytooldef
Replace /home/user1/defs/ with the folder of the user restoring the tool and mytooldef with the tool
to be restored. See mxtool(1M) for more information.
Related topics
• Custom tools
• Custom tools reference
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. For a list of other substitutable environment variables, see “Custom
tools reference”.
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
340 Tools that extend management