HP Systems Insight Manager 7.0 Command Line Interface Guide

This option forces a tool into the system when used with -m -f, and specifies the

forced removal of a tool when used with -r -f.

NOTE: When duplicate options are specified, the last instance of the option is used. For example,

if you enter -f file1 -f file2, mxauth uses file2.

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.

Return values

MeaningValue

Successful completion.0

Command line syntax error.2

Invalid name.21

Systems Insight Manager repository error.102

The CMS is not initialized.222

Unable to connect to the session manager.249

Remote exception.250

Examples

Example 1

To add the tools defined in the file /home/user1/defs/mytooldef, enter mxtool -a -f

/home/user1/defs/mytooldef.

Example 2

To modify tools based on the file /home/user1/defs/mytoolmods, enter mxtool -m -f

/home/user1/defs/mytoolmods.

Example 3

To forcefully modify tools based on the file /home/user1/defs/mytoolmods, enter mxtool

-m -f /home/user1/defs/mytoolmods -x force.

Example 4

To remove the tool badtool, enter mxtool -r -t badtool.

Limitations

This command can only be run on the CMS.