HP Systems Insight Manager 5.3 Command Line Interface reference guide

-b encoding
Specify the character encoding for the XML file. This is used with -l f.
-u username
Specify the user for the authorization. This option does not support user groups.
-R toolboxname
Specify the toolbox name for the authorization. Enclose toolbox names with embedded
spaces in quotation marks.
-n nodename
Specify the node name for the authorization. The wildcard character (*) is supported for
nodename.
-g groupname
Specify the node group name for the authorization. The wildcard character (*) is supported
for groupname. This option does not support user groups.
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 and 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.1
Error in a file operation.2
Nonexistent user, toolbox, node, or node group error.3
Invalid name.21
Database error.102
The CMS is not initialized.222
Unable to connect to the session manager.249
Examples
Example 1
To add the authorizations in the file my_auths.xml, enter mxauth -a -f my_auths.xml.
The contents of my_auths.xml might look like:
<?xml version="1.0" encoding="UTF-8"?>
<auth-list>
<node-authorization user-name="user1"
toolbox-name="webadmin"
node-name="node1.corp.com" />
<node-authorization user-name="user2"
toolbox-name="operator"
node-name="node1.corp.com" />
Example 1 21