HP Systems Insight Manager 7.0 Command Line Interface Guide

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 Systems Insight Manager administrative 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
The mxngroup command enables administrative 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, Systems Insight Manager interrupts the process, issues an error message, and
leaves the database unchanged.
2. If the XML file is successfully processed in the first pass, Systems Insight Manager attempts to
process the system group list collected during the first pass. During the second pass, Systems
Insight Manager 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, Systems Insight Manager 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.
mxngroup 59