HP Systems Insight Manager 5.3 Command Line Interface reference guide

These commands allow you to modify system group information. As with adding system groups, the
group can be specified on the command line or in an XML file in the format described in the
mxngroup(4) manpage. When you modify a system group, HP SIM updates the authorization
information for any authorizations associated with the modified system group.
• mxngroup -r -g groupname
mxngroup -r -f filename
These commands allow you to remove a system group. You can specify an individual system group or
an XML file containing multiple system groups. The file must be formatted as described in the
mxngroup(4) manpage. When an HP SIM full configuration rights user removes a system group, the
authorizations associated with the group are removed.
• mxngroup [-l d|f|m|n] [-g groupname... ]
mxngroup [-l d|f|m|n] [-n [ member... ] ]
These commands allow you to list system group names and attributes. The -l option indicates that
system group information is to be listed.
• d specifies a detailed listing of system group names and attributes.
• f results in a listing that matches the XML file format defined in mxngroup(4).
• m specifies a combined list of system group members, one member per line.
• n lists system group names, one per line.
The set of system groups that gets listed can be constrained in two ways:
• -g lets you specify the names of the desired groups.
• -n lists system groups that contain all of the specified members.
The default is to list all system groups.
• mxngroup -l f [-g groupname... ] [-b encoding ]
mxngroup -lf [-n [ member... ] ] [-b encoding ]
These commands allow you to list system group information in 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.
XML file support
mxngroup allows full configuration rights users to add, modify, or remove system groups by specifying an
XML file containing a list of system groups and system group attributes. See the Examples section and the
mxngroup(4) manpage for more information.
XML input files are processed in two passes:
1. The first pass attempts to parse the XML file and generate a list of system groups to process. This pass
ensures that the XML file is formatted correctly, that the system group names are valid, and the system
group objects contain valid information. During the first pass, if an error is detected, HP SIM interrupts
the process, issues an error message, and leaves the database unchanged.
2. If the XML file is successfully processed in the first pass, HP SIM attempts to process the system group
list collected during the first pass. During the second pass, HP SIM processes the system group list until
it processes the entire list or it encounters a logic error, such as specifying a duplicate system group
during an add, or specifying a nonexistent system group during a modify or remove.
If an error occurs during the second pass, HP SIM interrupts processing and issues an error message.
If the input file contains valid system group data prior to the invalid data, that data is processed
completely, and the database is updated. Data subsequent to the invalid data is not processed.
Options
-a
46 Command descriptions