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)