HP Systems Insight Manager 5.3 Command Line Interface reference guide

• mxcollection -d existcollname
This command allows you to delete collections. When deleting a collection, you must be the collection
owner or a full configuration 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.
• mxcollection -r mem -f filename
This command allows you to remove members from a collection. To remove collection members, you
must be the collection owner or a full configuration rights user. Queries and sub-collections cannot be
removed from the specified collection if they are not members of other collections.
• 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
Systems or Events list in the System and Event Collections panel. If a value is not specified, the
default is the system branch.
Options
-a
Add one or more collections that are specified in a collection definition file.
-a mem
Add one or more members to the collections defined in the specified collection definition
file.
-m mem
Modify one or more collection members defined in the specified collection definition file.
-r mem
Remove one or more collection members defined in the specified collection definition file.
-d existcollname
Delete the specified collection.
26 Command descriptions