HP Systems Insight Manager 6.0 Command Line Interface Guide

If you do not specify any options, as shown in the first example, all your incomplete jobs appear.
• The –l n option lists job IDs only.
• The -l t option lists job information in a tabular format, providing task name, job ID, HP SIM user,
HP SIM tool name, and the job state. The –i and –j options are mutually exclusive.
• Use the –i option to display the data for any job associated with for one or more task names.
• Use the –j option to display information for one or more job IDs.
The -j option is not needed in conjunction with -l n, because the -l n option only displays job IDs.
• Use the –d date option to limit displaying information to those jobs that completed after the date
parameter. You must use the following format for the date parameter:
“Month/day/year hour:minute AM | PM”
For the CLI to interpret the string as one parameter, including the embedded spaces, you must use the
quotation marks shown in the example. In the third example, the -l d option displays detailed
information about the job ID listed with the –j option. You can use specify one job, and the command
displays the completion status of each target system, as well as stdout, and stderr information.
Managing users and authorizations
In HP SIM, an authorization is comprised of three components: the user, the set of systems the user is
managing, and the set of tools the user can use on the set of systems. This section discusses using the CLI to
manage users, toolboxes, and authorizations.
Managing users
The mxuser command enables you to add, modify, remove, or list users in HP SIM. A full description for
mxuser exists in the mxuser man page, and a full description of the XML syntax required to manage users
with an XML file exists in the mxuser(4) man page.
The mxuser –a user command adds the user with the login name of user to HP SIM. The user must exist as
a user on the operating system to log in to HP SIM, but does not need to exist to be added to HP SIM. In
this example, the user has limited access rights and no authorizations.
• The –d description option enables you to provide a description of the user, such as the user role, like
Database Administrator, or HPUX Server Manager. For example:
# mxuser –a Jane –d “HPUX Administrator”
• The –p full CMSSecurity | limited | none option enables you to specify the rights of the
user. A full rights user has unlimited access HP SIM capabilities. A limited rights user can create tools
in HP SIM, and none rights user, has access to the listing options of HP SIM commands.
• The –C source option is useful when creating several users with the same authorizations. For more
information, see “Managing authorizations”.
• The –g userGroup option can replace user in the –a option to create a user group. Use the –d and
–p options to provide a description and access rights for the group.
• The –m user option, used in conjunction with –d and –p, enables you to modify the description and
access rights of the user. In the example above, to modify Jane’s description, the command will look
like:
# mxuser –m Jane –d “Database Administrator”
Using –m –g userGroup, in conjunction with –d and –p, modifies the characteristics of group userGroup.
• The mxuser –r user and mxuser –r –g userGroup commands remove a user and a group,
respectively, deleting all authorizations for the user and the group.
• The –f file option enables you to add, modify, or remove multiple users and user groups. File contains
XML syntax, allowing multiple entries to be processed. Use this option with –a, –m, and –r options,
replacing the user name or user group name with –f file. Another benefit to using a file is that you can
define more characteristics for the users and groups.
For example, you can specify e-mail and phone contact information for each user. For details on the
XML syntax, see the mxuser(4) man page.
126 Infrastructure management using CLI