HP Systems Insight Manager 6.3 Command Line Interface Guide

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 system 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.
• mxcollection -r mem -f filename
• reorder mem -f file-name filename
This command enables you to remove members from a specified collection in an .xml file.
Only a full rights user or the collection owner can remove contents from a collection. Queries
cannot be removed from the specified collection if they are not members of other collections.
• 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 -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.
mxcollection 27