HP Systems Insight Manager 7.0 Command Line Interface Guide

You cannot add tools with the modify option. If there is a tool in the tool definition file that
does not exist, Systems Insight Manager will notify you and then modify the existing tools
specified in the tool definition file. Skipping undefined tools does not affect the return value.
During the modify operation, you cannot remove the All Tools toolbox from any tool.
Only an administrative rights user can add or modify a tool that is multiple-system aware,
such as Ignite.
Only an administrative rights user can delete a tool.
All tools must contain the revision attribute. The revision attribute is used to confirm that the
tool defined in the tool definition file is of a greater revision than the existing tool. The tool
revision attribute is used when modifying a tool. If a revision is not provided, a revision of
1.0 is assigned to the tool when it is added. To ignore the tool revision attribute in the modified
tool definitions, specify the -x force option.
• mxtool -s -f filename
This command lets you scan a tool definition file for syntax errors without actually adding or
modifying the tool.
• mxtool -r [-f filename|-c category|-t toolname ] [-x force]
This command enables you to remove tools. Only an administrative rights user can remove a
tool. If you enter a tool name that does not exist, Systems Insight Manager notifies you that it
cannot find the tool, and will attempt to remove the next tool in the list. Skipping undefined
tools does not affect the return value. If a task has been created using the tool, attempts to
remove it are not successful. If you specify the -x force option, Systems Insight Manager
ignores the task dependencies of the tool and removes it. You can specify tools as a list of
tool names, a list of categories, or a tool definition file.
• mxtool -l d|f|n|t [-c category...|-t toolname... ]
This command enables you to list tools or view specific tool definitions.
— With no options or the n qualifier, the names of all registered tools are listed.
— With the d qualifier, a detailed screen-viewable list of tools is displayed.
— With the f qualifier, mxtool writes a complete tool definition (see mxtool(4)) for each
tool to stdout.
— With the t qualifier, a tabular listing showing some attributes of all registered tools is
displayed.
— The -c option constrains the output to one or more tool categories.
— The -t option constrains the output to specific tools.
• mxtool -lf [-b encoding ] [-c category...|-t toolname... ]
This command lists the tools in an XML file.
Optionally, you can specify the character encoding of the XML file. The value for the character
encoding must match a valid character encoding. If no encoding is specified, the system
attempts to write the file in the encoding currently defined on the system. See http://
www.iana.org/assignments/character-sets for the list of valid character sets.
• mxtool
This command lists the names of all tools currently configured in the Systems Insight Manager
domain.
Options
-a
Add one or more tools specified in a tool definition file.
mxtool 113