HP Systems Insight Manager 6.0 Command Line Interface Guide

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 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 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.
mxtoolbox 99