HP Systems Insight Manager 7.0 Command Line Interface Guide

• 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.
Optionally, a full rights user can specify the character encoding of the XML file. The value for
the character encoding must match a valid character encoding. If no encoding is specified,
the system attempts to write the file in the encoding currently defined on the system. See http://
www.iana.org/assignments/character-sets for the list of valid character sets.
Toolbox attributes
The following attributes define an Systems Insight Manager toolbox:
• toolboxname. The name of the toolbox must start with an alphabetic character, may have
embedded spaces, and its maximum length is 16 characters. Toolbox names are not case
sensitive.
• description. The toolbox description. The maximum length is 128 characters.
• enablement. The state of enablement of the toolbox. A disabled toolbox prevents execution
of any tool on behalf of the disabled toolbox.
XML file support
The mxtoolbox command enables an administrative rights user to add, modify, or remove
toolboxes by specifying an XML file containing a list of toolboxes and toolbox attributes.
XML input files are processed in two passes.
The first pass attempts to parse the XML file and generate a list of toolboxes to process. This pass
ensures that the XML file is formatted correctly, that the toolbox names are valid, and the toolbox
objects contain valid information. During the first pass, if an error is detected, Systems Insight
Manager interrupts the process, issues an error message, and leaves the database unchanged.
If the XML file is successfully processed in the first pass, Systems Insight Manager attempts to process
the toolbox list collected during the first pass. During the second pass, Systems Insight Manager
processes the toolbox list until it processes the entire list or encounters a logic error, such as
specifying a duplicate toolbox during an add, specifying a nonexistent toolbox during a modify,
or attempting to remove the All Tools toolbox.
If an error occurs during the second pass, Systems Insight Manager interrupts processing and issues
an error message. If the input file contains valid toolbox data prior to the invalid data, that data
is processed completely and the database is modified. All data subsequent to the invalid data is
ignored.
Options
-a
mxtoolbox 117