HP Systems Insight Manager 5.2 Update 2 Technical Reference Guide

Viewing tool definition files
You can view the XML code, which are tool definition files, below the table of custom tools by clicking View
Tool Definition from the Manage Custom Tools.
To display the tool definition files:
1. Select Tools→Custom Tools→Manage Custom Tools. The Manage Custom Tools page appears.
2. Select a tool, and then click View Tool Definition The XML code appears.
Related topics
• Custom tools
• Managing custom tools
Removing and restoring custom tools
Removing a tool
The Remove a Tool tool, removes another tool from the menu for all users in HP Systems Insight Manager
(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 the 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. See
“Scheduling a task” for more information about scheduling a task.
To remove tools using the command line, enter
mxtool -r -t badtool
where badtool is 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
where /home/user1/defs/ is the folder of the user restoring the tool and mytooldef is 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 Systems Insight Manager (HP SIM)
environment variables, the HP SIM environment variables override the user-defined variables.
DOS environment variables are supported in the custom tool parameters and work as parameters on the
New Custom Tool page or the Manage Custom Tools page. However, they must be surrounded by
double percent (%) signs. For example, to pass in the NOTICELABEL environment variable as a parameter,
it should be entered as %%NOTICELABEL%% on the parameter line. The environment variables can also be
accessed from a batch file or script file. To use them in a batch file or a script file, only a single percent (%)
sign should precede and succeed the environment variable name. See “Custom tools reference” for a list of
other substitutable variables.
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
334 Tools that extend management