HP Systems Insight Manager 5.3 Command Line Interface reference guide

• mxtoolbox -r toolboxname
This command allows a full rights user to remove a single toolbox from the database.
• mxtoolbox -r -f filename
This command allows 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 allows a full rights user to list HP SIM 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 HP SIM'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 HP SIM 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 allows a full configuration 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, HP SIM interrupts the process, issues an error
message, and leaves the database unchanged.
If the XML file is successfully processed in the first pass, HP SIM attempts to process the toolbox list collected
during the first pass. During the second pass, HP SIM 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, HP SIM 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
Add a toolbox.
-d description
Specify a toolbox description.
-e t|f
94 Command descriptions