HP Systems Insight Manager 7.2 Command Line Interface Guide

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, 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
Specify the toolbox enablement (t is enabled and f is disabled).
-f filename
Specify the filename that contains information about users to be added, modified
or removed (see mxuser(4)).
-l n
Display a columnar list of the names of all enabled and disabled toolboxes. This
produces the same result as not specifying any options.
-l t
Display a tabular list of toolbox attributes for all toolboxes.
-lf
Specify that the system should generate the toolbox information in XML format.
-b encoding
Specify the character encoding of an XML file when used with -lf.
-m toolboxname
Modify a specified toolbox.
-N new_toolboxname
Define a new toolbox name for the specified toolbox.
-r
mxtoolbox 119