HP Systems Insight Manager 5.3 Command Line Interface reference guide

• mxuser -r username
mxuser -r -g usergroupname
mxuser -r -f filename
mxuser -r -gf -f filename
These commands enable full rights or CMSSecurity rights users to remove specified users or user groups.
This form of the command can only remove one user or group at a time. All authorizations for the
specified user or group are removed. HP SIM must have at least one full configuration rights user, so
the last full configuration rights user cannot be removed. To remove more than one user or group at a
time, use -f filename to specify an input file. See mxuser(4) for more information.
• mxuser [-l d|f|n|t] [ username... ]
This command lists HP SIM user information. Specifying no options provides a list of user names with
no other information. This listing is the same as the -l n option. The -l d option provides a detailed
screen-viewable list of the users. The -l f option provides the list in an XML file. The output of the XML
file is valid input for -f. The -l t option provides a tabular list of users with detailed information.
• mxuser [-l dg|fg|ng|tg] [ usergroupname... ]
This command lists user group information. Specifying no options provides a list of user group names
with no other information. This listing is the same as the -l option with the ng qualifier. The -l
option with the dg qualifier provides a detailed screen-viewable list. The -l option with the fg qualifier
provides the list in an XML file. The output of the XML file is valid input for -fg. The -l option with
the tg qualifier provides a tabular listing of users with detailed information.
• mxuser -lf [-b encoding ] [ username... ]
This command saves user information to an XML file.
Optionally, you 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.
NOTE: For backward compatibility with Service Control Manager 3.0, the -p option also supports the
Trusted and Untrusted User +T and -T options. The +T option creates a user with, or modifies a user to full
configuration rights. The -T option creates a user with, or modifies a user to limited configuration rights.
XML file support
The mxuser command enables full configuration or CMSSecurity rights users to add, modify, or remove HP
SIM users by specifying an XML file containing a list of users and user attributes.
Using an XML input file enables you specify additional information that is not included in the command line
options. This information includes a user's full name, e-mail address, and phone number. HP SIM processes
the input file in two passes.
The first pass attempts to parse the XML file and generate a list of users to process. This pass ensures that
the XML file is formatted correctly, that the user names are valid, and the user objects contain valid information.
During the first pass, if an error is detected, the process is interrupted, an error message is issued, and the
database is left unchanged.
If the XML file is successfully processed in the first pass, HP SIM attempts to process the user list collected
during the first pass. HP SIM processes the user list until it processes the entire list, or until the a logic error
is encountered, such as specifying a duplicate user during an add, specifying a nonexistent user during a
modify, or attempting to remove the last full configuration rights user.
If an error occurs during the second pass, HP SIM interrupts processing and issues an error message. If the
input file contains valid user 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
mxuser 99