HP Systems Insight Manager 6.0 Command Line Interface Guide

• 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, 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
Add a group.
-m
Modify a group.
-r
Remove a group.
-l d
Display a detailed screen-viewable list of system group information.
-l f
mxngroup 49