HP Systems Insight Manager 6.3 Command Line Interface Guide

Description
The mxtoolbox command enables you to add, rename, describe, disable, enable, remove, and
list toolboxes.
NOTE: The All Tools toolbox is a special toolbox added by the system, and cannot be modified.
Only an administrative rights user can add, modify, or remove toolboxes. Any user can list toolbox
information.
• mxtoolbox -a toolboxname [-d description ] [-e t|f]
This command enables you to add a single toolbox. Optionally, you can provide a toolbox
description and enable or disable the toolbox.
To add a toolbox, you must provide a toolbox name that is less than or equal to 16 characters
in length, and starts with an alphabetic character followed by alphanumeric characters.
Embedded blank characters, underscores (_), or dashes (-) are allowed. If you have full
configuration rights, you can add up to 32 toolboxes.
Toolboxes are enabled by default. To explicitly enable a toolbox, you must have full rights
and enter t after -e. To disable a toolbox enter f after -e. When a toolbox is enabled, tools
associated with it can be authorized using the toolbox. When the toolbox is disabled, tools
associated with it cannot be authorized using the toolbox.
• mxtoolbox -a [-f filename ]
This command enables a full rights user to add multiple toolboxes based on the information
provided in a file. The file must be formatted in the XML format defined for toolboxes. See
mxtoolbox(4) for additional information.
• mxtoolbox -m toolboxname [-N new_toolboxname ] [-d description ]
[-e t|f]
This command enables a full rights user to modify a single toolbox. You can modify the name,
description, and enablement of the toolbox.
• mxtoolbox -m [-f filename ]
This command enables a full rights user to modify multiple toolboxes based on the information
provided in a file. The file must be formatted in the XML format defined for toolboxes. See
mxtoolbox(4) for additional information.
• mxtoolbox -r toolboxname
This command enables a full rights user to remove a single toolbox from the database.
• mxtoolbox -r -f filename
This command enables a full rights user to remove multiple toolboxes based on information
provided in a file. The file must be formatted in the XML format defined for toolboxes. See
mxtoolbox(4) for additional information.
• mxtoolbox [-l n|t]
This command enables a full rights user to list Systems Insight Manager toolbox names or to
view the details of all toolboxes. When invoked with no options, mxtoolbox gives a columnar
listing of the names of all toolboxes. This is the same as invoking the command with the n
argument. When invoked with the t argument, the system lists the toolboxes in tabular format,
displaying the toolbox name, its enablement value, and the toolbox description.
• mxtoolbox -lf [-b encoding ]
This command lists Systems Insight Manager's toolboxes in an XML file.
mxtoolbox 117