HP Systems Insight Manager 6.0 Command Line Interface Guide

• 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, HP SIM 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, HP SIM 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 HP SIM domain.
Options
-a
Add one or more tools specified in a tool definition file.
-r
Remove one or more tools.
-m
Replace one or more tool definitions with the definitions in the specified tool definition file.
-i
Ignore changes to toolboxes in the tool definitions. This option is only valid with -m.
-s
Scan the specified tool definition file for syntax errors without performing any other
operations.
-c category
Specify a tool category. Specifying an undefined category name causes mxtool to return
an empty tool list and a return value of SUCCESS. Specifying a category name that violates
the rules for category names (see mxtool(4)), results in an invalid name return value.
-t toolname
96 Command descriptions