NAME
mxcollection - add, list, modify, or remove collections and members of
collections in Systems Insight Manager
SYNOPSIS
mxcollection -a -f filename (add collection)
mxcollection -a mem -f filename (add memebers to existing collections
via
mxcollection -m mem -f (modify properties of members in collections
mxcollection -d collectionname (delete collection)
mxcollection -r mem -f filename (remove members in collections via xml
mxcollection -ln (list collection names in hierachical tree
mxcollection -lf collectionname [-b encoding] (list members of the
specified collection
DESCRIPTION
The mxcollection command allows a Systems Insight Manager user to add,
list, modify or remove collections in Systems Insight Manager.
IMPORTANT NOTE: In earlier releases of HP Systems Insight Manager,
categories could be created and manipulated with the mxquery command.
With this release, collections are an extension of categories, and are
managed with the mxcollection command. mxcollection allows you to
choose members individually by name. You must continue to use mxquery
to specify the search attributes when creating and managing queries.
The first form of mxcollection (mxcollection -a -f filename) allows
the user to add collections and members in collections. Systems,
queries and other collections are possible members of collections.
The information regarding the collection is provided in a collection
schema file (see mxcollection(4)) and allows the user to add one or
more Systems Insight Manager collections.
During an add operation, Systems Insight Manager only adds collections
whose names do not reference collections and node groups currently in
the Systems Insight Manager repository. If Systems Insight Manager
detects a duplicate name, Systems Insight Manager will skip the
duplicate collection, but continue to add all non-duplicate
collections. Skipping duplicate collections in this case does not
affect the exit code.
The second form of mxcollection (mxcollection -a mem -f filename)
allows the user to add one or more memebers to existing collections.
When modifying a collection, the user must either be the collection's
owner or be a full rights user.
The third form of mxcollection (mxcollection -m mem -f filename)
allows the user to modify the properties of one or more Systems
Insight Manager collection members. When modifying a collection and
its contents, the user must either be the collection's owner or be a
full rights user.
The third form of mxcollection (mxcollection -d collectionname) allows
the user to delete Systems Insight Manager collections. Only a full
rights user or the collection owner may delete a collection. If the
user specifies a collection name that does not correspond to a
collection in Systems Insight Manager, Systems Insight Manager
notifies the user that it cannot delete the collection. Collections
can not be deleted if they are used by Tasks, Report, Authorization,
or the Banner Status area. Collections can not be deleted if they
still contain members in them.
The forth form of mxcollection (mxcollection -r mem -f filename)
allows the user to remove members from the specified collection. Only
a full rights user or the collection owner may remove contents of a
collection. Queries or sub-collections can not be removed from the
specified collection if they are not members of other collections.
The fifth form of mxcollection (mxcollection -ln) allows the user to
list all Systems Insight Manager collection names in a tree
hierachical form.
The sixth form of mxcollection (mxcollection -lf collectionname)
writes to stdout a complete Systems Insight Manager collection
definition (see mxcollection(4)) for the specified Systems Insight
Manager collection.
Options
mxcollection recognizes the following options:
-a -f Indicates that one or more Systems Insight Manager
collections, specified in a collection definition
file, are to be added.
-a mem Indicates that one or more Systems Insight Manager
members are to be added to collections defined in
the specified collection definition file.
-m mem Indicates that one or more Systems Insight Manager
collection members are to be modified by the
definition in the specified collection definition
file.
-d Indicates that the specified Systems Insight
Manager collection is to be deleted.
collectionname Specifies the name of the Systems Insight Manager
collection to be deleted or listed.
-lf Displays a file-formatted listing of Systems
Insight Manager collections.
-ln Displays the names of Systems Insight Manager
collections in a tree hierachical form.
-b encoding Specifies the character encoding for an XML file
when used in conjunction with the -lf option.
RETURN VALUE
Upon completion, mxcollection returns:
0 The operation completed successfully.
-1 An error occured during operation.
AUTHOR
mxcollection was developed by the Hewlett-Packard Company.
SEE ALSO
mxcollection(4)