HP Systems Insight Manager 7.2 Command Line Interface Guide

mxcollection -m mem -f filename
mxcollection -d existcollname
mxcollection -r mem -f filename
mxcollection -ln
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 HP SIM releases, categories were created and manipulated with mxquery
. In HP SIM 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, 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.
• mxcollection 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 31