HP Systems Insight Manager 6.0 Command Line Interface Guide

enables you to choose members individually by name. You can continue using mxquery to manage collections
that are created by specifying member attributes.
• mxcollection -a -f filename
This command enables you to add collections and collection members. Possible collection members
include systems, queries, and other collections. Collection information is provided in an XML file, and
you can add multiple collections with a single file. See the mxcollection(4) manpage and the
Examples section for information about the required XML file format.
During an add operation, HP SIM adds only collections whose names do not reference existing collections
and node groups in the database. If a duplicate name is detected, the duplicate collection is skipped,
and all non-duplicate collections are added. Skipping duplicate collections does not affect the return
value.
• mxcollection -a mem -f filename
This command enables you to add members to existing collections. When modifying a collection, you
must be the collection owner or an administrative rights user.
• mxcollection -m mem -f filename
This command enables you to modify the properties of collection members. When modifying a collection
and its contents, you must be the collection owner or an administrative rights user.
• mxcollection -d existcollname
This command enables you to delete collections. When deleting a collection, you must be the collection
owner or an administrative rights user. If you specify a nonexistent collection name, HP SIM notifies
you that it cannot delete the collection. Collections cannot be deleted if they are used by tasks, reports,
authorizations, or the banner status area. Collections with members cannot be deleted.
• reorder mem -f file-name filename
This command enables you to reorder the members of the collection through the file. To reorder the
collection the xml file must be modified with the updated reordered collection members.
• mxcollection -ln
This command lists all HP SIM collections in a hierarchical tree. This command does not list collections
that were added by attributes. Use mxquery -ln to list these collections.
• mxcollection -lf existcollname [-b encoding ]
This command writes a complete definition of the specified collection to stdout in XML format.
• mxcollection -mv existcollname -from fromparentcollname -to toparentcollname
[-branch sysbranch|evbranch ]
This command moves an existing collection from its current parent collection to another parent collection.
The -branch option lets you specify whether the new parent collection is in the Systems or Events
list in the System and Event Collections panel.
NOTE: You can move collections within the Systems list or the Events list, but you cannot move
collections from one list to another.
• mxcollection -cp existcollname -name newcollname -to toparentcollname
[-branch sysbranch|evbranch ]
This command copies an existing collection, renames it, and assigns it to an existing parent collection.
Use -branch to specify whether the parent collection is in the Systems or Events list in the System
and Event Collections panel.
• mxcollection -a combo newcombocollname -syscoll systemcollname -evcoll
eventcollname -parent toparentcollname [- branch sysbranch|evbranch ]
This command adds a new combination collection with the specified name, system collection and event
collection to an existing parent collection. You must specify an event collection that was created by
attributes in the GUI. The -branch option lets you specify whether the parent collection is in the
24 Command descriptions