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)