NAME

      mxcollection - Systems Insight Manager global protocol settings file


SYNOPSIS

      mxcollection


DESCRIPTION

      The mxcollection command supports adding, listing, modifying, or
      deleting collections and members of collections in the eXentisible
      Markup Language (XML) format defined by the followint XSD schema:

      <?xml version="1.0" encoding="UTF-8"?>
      <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" targetNamespace="http://www.hp.com/hpsim5.0.0.0" xmlns:h="http://www.hp.com/hpsim5.0.0.0">
	<xs:element name="collection-list">
	  <xs:complexType>
	    <xs:sequence>
	      <xs:element maxOccurs="unbounded" ref="h:collection"/>
	    </xs:sequence>
	  </xs:complexType>
	</xs:element>
	<xs:element name="collection">
	  <xs:complexType>
	    <xs:sequence>
	      <xs:element minOccurs="0" maxOccurs="unbounded" ref="h:member"/>
	    </xs:sequence>
	    <xs:attribute name="name" use="required" type="xs:string" />
	    <xs:attribute name="type" use="required">
	      <xs:simpleType>
		  <xs:restriction base="xs:string">
		      <xs:enumeration value="system"/>
		      <xs:enumeration value="event"/>
		  </xs:restriction>
	      </xs:simpleType>
	  </xs:attribute>
	      <xs:attribute name="parent" use="optional" type="xs:string" />
	  </xs:complexType>
	</xs:element>
	<xs:element name="member" >
	  <xs:complexType>
	    <xs:attribute name="default-view" use="optional" type="xs:string"/>
	    <xs:attribute name="display-status" use="optional">
	      <xs:simpleType>
		  <xs:restriction base="xs:integer">
		      <xs:enumeration value="-1" />
		      <xs:enumeration value="0" />
		      <xs:enumeration value="1" />
		  </xs:restriction>
	      </xs:simpleType>
	    </xs:attribute>
	    <xs:attribute name="hidden" use="optional" type="xs:boolean"/>
	    <xs:attribute name="name" use="required" type="xs:string" />
	    <xs:attribute name="type" use="required">
	      <xs:simpleType>
		<xs:restriction base="xs:string">
		     <xs:enumeration value="node" />
		      <xs:enumeration value="query" />
		      <xs:enumeration value="collection" />
		  </xs:restriction>
	      </xs:simpleType>
	    </xs:attribute>
	  </xs:complexType>
	</xs:element>
      </xs:schema>

      Please note that if the "parent" attribute for the 'collection'
      element specified in the XML file is not specified for the
      'mxcollection -a -f <filename>' command, the new collection will be
      added to the 'Shared' branch of the collection hierarchy tree for
      users who have the priviledge to modify the Shared collection.

      An example XML document to add collections and members 'mxcollection
      -a -f <filename>' that satisfies the above schema is:

      <?xml version="1.0" encoding="UTF-8" ?>
      <collection-list xmlns="http://www.hp.com/hpsim5.0.0.0">
	  <collection name="cupertino site" type="system" parent="Systems by Type">
	    <member name="All Servers" type="query" display-status="0" default-view="tableview" hidden="false" />
	    <member name="ovwpc600" type="node" display-status="0" default-view="tableview" hidden="false" />
	  </collection>
	  <collection name="building 45" type="system" parent="cupertino site">
	    <member name="All Enclosures" type="query" display-status="0" default-view="tableview" hidden="false" />
	    <member name="All Racks" type="query" display-status="0" default-view="tableview" hidden="false" />
	  </collection>
      </collection-list>

      An example XML document for adding members to an existing collection
      "mxcollection -a mem -f <filename>" that satisfies the above schema
      is:

      <?xml version="1.0" encoding="UTF-8"?>
      <collection-list xmlns="http://www.hp.com/hpsim5.0.0.0">
	<collection name="building 45" type="system">
	  <member name="All Servers" display-status="0" type="query" default-view="tableview" hidden="false" />
	  <member name="HP BladeSystem" display-status="-1" type="collection" default-view="tree" hidden="false" />
	</collection>
      </collection-list>

      An example XML document for modifying members properties "mxcollection
      -m mem -f <filename>" that satisfies the above schema is:

      <?xml version="1.0" encoding="UTF-8"?>
      <collection-list xmlns="http://www.hp.com/hpsim5.0.0.0">

	<collection name="building 45" type="system">
	  <member name="All Enclosures" display-status="0" type="query" default-view="treeview" hidden="false" />
	</collection>
      </collection-list>

      An example output for 'mxcollection -ln' that satisfies the above
      schema is:

      Systems
	Shared
	  Systems by Type
	    All VSE Resources
	    HP BladeSystem
	      Global Spare
	      Maintenance
	    Storage Systems
	  Systems by Status
	  Systems by Operating System
	  Clusters by Type
	  Clusters by Status
	  System Functions
      Events
	Shared
	  Events by Severity
	  Login Events
	  Service Events


AUTHOR

      mxcollection was developed by the Hewlett-Packard Company.


SEE ALSO for HP-UX

      mxcollection(1M)


SEE ALSO for Linux

      mxcollection(8)