HP Systems Insight Manager 6.0 Command Line Interface Guide

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
Remove the specified toolbox.
External influences
For HP-UX or Linux, LANG determines the default encoding that the system will use to output XML data if no
encoding is specified on the command line. If LANG is not specified or null, or LANG does not correspond
to a recognized encoding, it defaults to C (see lang (5)). In this case, use the -b option to specify the
encoding of the XML data.
100 Command descriptions