HP Systems Insight Manager 5.3 Command Line Interface reference guide

from the tool. By default, when a full configuration rights user removes the owner field, the toolbox
enabled flag is set to true . A full configuration rights user can set the toolbox enabled flag to false to
explicitly disable the tool in all toolboxes except All Tools .
During an add operation, HP SIM adds only tools whose names do not reference existing tools. If a
duplicate tool is detected, HP SIM will notify you and continue to add all non-duplicate tools. Skipping
duplicate tools does not affect the return value. During the add operation, HP SIM assigns the All Tools
toolbox to every tool by default.
• mxtool -m [-i] -f filename [-x force]
This command allows you to modify the definition of one or more tools. Tool information is provided
in a tool definition file (see mxtool(4)). When modifying a tool, you must be the tool owner or a full
configuration rights user. Full configuration rights users can modify the entire tool definition. Tool owners
without full configuration rights can modify most tool attributes, but they cannot modify the owner
attribute or the tool's toolboxes. HP SIM ignores the value of the toolbox enabled flag in the input file
and sets the toolbox enabled flag in the tool to false . By specifying the -i option, a full configuration
rights user can direct HP SIM to ignore changes to toolboxes in the modified tool definitions.
If the owner field of the tool is not set, and a user without full configuration rights wants to modify the
tool, a full configuration rights user must modify the tool definition to set the tool owner field to the user
name of the user without full configuration rights. Additionally, mxtool ignores any changes made to
a tool's toolboxes by a user without full configuration rights.
You cannot add tools with the modify option. If there is a tool in the tool definition file that does not
exist, HP SIM 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 a full configuration rights user can add or modify a tool that is multiple-system aware, such as
Ignite.
Only a full configuration 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 allows you to remove tools. Only a full configuration 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 allows 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.
90 Command descriptions