HP Systems Insight Manager 7.1 Command Line Interface Guide

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 enables 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 an administrative rights user. Administrative rights users can modify the entire
tool definition. Tool owners without administrative 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, an administrative 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 administrative rights wants to modify
the tool, an administrative rights user must modify the tool definition to set the tool owner field
to the user name of the user without administrative rights. Additionally, mxtool ignores any
changes made to a tool's toolboxes by a user without administrative 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 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, 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.
114 Command descriptions