HP Systems Insight Manager 6.0 Command Line Interface Guide

mxtool -s -f filename
mxtool -r [-f filename|-c category|-t toolname ] [-x force]
mxtool -l d|f|n|t [-c category...|-t toolname... ]
mxtool -lf [-b encoding ] [-c category...|-t toolname... ]
mxtool
Description
The mxtool enables you to add, list, modify or remove tools.
• mxtool -a -f filename
This command enables you to add tools. Tool information is provided in a tool definition file (see
mxtool(4)) that enables you to add one or more tools.
If you are an administrative rights user (see mxuser(1)), HP SIM will accept the owner value specified
for a tool in the tool definition file. If an owner is not specified, the tool is enabled in all toolboxes that
contain it.
If you are not an administrative rights user, HP SIM ignores the owner specification, sets the tool's owner
field to your user ID, ignores the value of the toolbox enabled flag, and enables only the All Tools
toolbox.
When the owner field is specified, HP SIM ignores the toolbox enabled flag and disables the tool in
all of the specified toolboxes with the exception of All Tools . To enable the tool in all of the specified
toolboxes, an administrative rights user must modify the tool's definition by removing the owner field
from the tool. By default, when an administrative rights user removes the owner field, the toolbox
enabled flag is set to true . An administrative 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 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 95