HP Systems Insight Manager 7.1 Command Line Interface Guide
Embedded blank 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.
118 Command descriptions