HP Systems Insight Manager 7.0 Command Line Interface Guide

mxcollection -lf existcollname [-b encoding ]
mxcollection -mv existcollname -from fromparentcollname -to toparentcollname
[-branch sysbranch|evbranch ]
mxcollection -cp existcollname -name newcollname -to toparentcollname [-branch
sysbranch|evbranch ]
mxcollection -a combo newcombocollname -syscoll systemcollname -evcoll
eventcollname -parent toparentcollname [-branch sysbranch|evbranch ]
Description
The mxcollection command enables you to add, list, modify, copy or delete collections.
NOTE: In earlier Systems Insight Manager releases, categories were created and manipulated
with mxquery . In Systems Insight Manager 5.0 and later, collections are an extension of
categories, and are managed with mxcollection, which 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, Systems Insight Manager 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,
Systems Insight Manager 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 Systems Insight Manager 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 31