HP Systems Insight Manager 7.0 Command Line Interface Guide

mxtool
Adds, lists, modifies, or removes tools in Systems Insight Manager.
Synopsis
mxtool -a -f filename
mxtool -m [-i] -f filename [-x force]
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)), Systems Insight Manager 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, Systems Insight Manager 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, Systems Insight Manager 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, Systems Insight Manager adds only tools whose names do not
reference existing tools. If a duplicate tool is detected, Systems Insight Manager will notify
you and continue to add all non-duplicate tools. Skipping duplicate tools does not affect the
return value. During the add operation, Systems Insight Manager 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. Systems Insight Manager 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 Systems
Insight Manager 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.
112 Command descriptions