NAME

      mxcategoryitem - Systems Insight Manager report category file format


SYNOPSIS

      mxcategoryitem


DESCRIPTION

      The mxreport command supports reading and writing report and report
      category information in the eXtensible Markup Language (XML) format.
      You can use this capability to add or remove reports or report
      categories in the Systems Insight Manager environment.  Each file may
      contain the definitions of one or more reports or one or more report
      categories.

    Document Type Definition
      The Document Type Definition (DTD) file defines the constraints for an
      XML file. These constraints include the valid element tags,
      attributes, and the cardinality of elements in an XML file. The report
      DTD file is named mxcategoryitem.dtd and is included in the following
      paragraph. Note that due to man page formatting, the DTD contents may
      not appear the same as in the file.

       <?xml version="1.0" encoding="UTF-8"?>
       <!ELEMENT category (version?, group, input, displayName, dbViewName, item+, privilege)>
       <!ATTLIST category
	 catName CDATA #REQUIRED
	 displayFlag CDATA #REQUIRED
	 queryType CDATA #REQUIRED
	 editFlag CDATA #REQUIRED
	 categoryId CDATA #IMPLIED
	 plugin CDATA #IMPLIED
	 displayOrder CDATA #IMPLIED
       >
       <!ELEMENT categoryList (category+)>
       <!ELEMENT dbViewColName (#PCDATA)>
       <!ELEMENT dbViewName (#PCDATA)>
       <!ELEMENT displayName (#PCDATA)>
       <!ATTLIST displayName
	 displayLocale CDATA #REQUIRED
       >
       <!ELEMENT displayOrder (#PCDATA)>
       <!ELEMENT group EMPTY>
       <!ATTLIST group
	 groupLocale CDATA #IMPLIED
	 parent CDATA #REQUIRED
	 child CDATA #REQUIRED
       >
       <!ELEMENT input (sourceHandler, source+)>
       <!ATTLIST input
	 sourceType CDATA #REQUIRED
       >
       <!ELEMENT item (operation*, displayName, dbViewName, dbViewColName, displayOrder, privilege)>
       <!ATTLIST item
	 itemName CDATA #REQUIRED
	 displayFlag CDATA #REQUIRED
       >
       <!ELEMENT operation EMPTY>
       <!ATTLIST operation
	 op CDATA #REQUIRED
	 opName CDATA #REQUIRED
	 opHandler CDATA #REQUIRED
       >
       <!ELEMENT privilege (#PCDATA)>
       <!ELEMENT source (#PCDATA)>
       <!ATTLIST source
	 dbType CDATA #IMPLIED
       >
       <!ELEMENT sourceHandler EMPTY>
       <!ELEMENT version EMPTY>
       <!ATTLIST version
	 major CDATA #REQUIRED
	 minor CDATA #REQUIRED
       >

    Elements
      As defined in the DTD, the report category XML file may contain the
      following elements.

      The first line of a report category XML file must be in the following
      format:

      <?xml version="1.0" encoding="encoding-value" ?>

      where the user substitutes a recognized encoding value for the
      encoding-value parameter.	 The recognized encoding values may be found
      at the following web site:

      http://www.iana.org/assignments/character-sets

      If no XML header line is specified, the system defaults encoding to
      "UTF-8".

      The "categoryList" element must appear once in a report XML file and
      wraps the list of report category information. The "categoryList"
      element may contain one or more "category" elements.

      The "category" element may appear zero or more times in a report XML
      file.

      The "catName" attribute is required and specifies the unique category
      name.

      The "displayFlag" attribute is required and specifies the display type
      of a report category.  It is required to be set to "1" to always
      display the report category.

      The "queryType" attribute is required.  It should always be set to a
      value of "1".

      The "editFlag" attribute is required and specifies whether the report
      category can be edited.  A value of "0" indicates that a report
      category is not editable.	 A value of "1" indicates that a report
      category can be edited.  This attribute is for internal use.

      The "categoryId" attribute is optional and specifies the unique report
      category ID. The system always outputs the "id" attribute when listing
      an existing report category to an XML file. The user does not need to
      specify the "categoryId" attribute.

      The "plugin" attribute is optional.  A value of "0" specifies a
      system-defined report category.

      The "displayOrder" attribute is optional and specifies the default
      display order for report categories.

      The "dbViewColName" attribute is required.  It specifies the
      DbViewColName in the hpmxItem table.

      The "dbViewName" attribute is required.  It specifies the DbViewName
      in the hpmxItem table.

      The "displayName" attribute is mandatory and specifies the report
      category display name.  The "displayName" must be unique in the CMS.

      The "displayLocale" attribute is required.  It specifies the language
      locale of the report category display.

      The "displayOrder" attribute is optional and is for future use.

      The "groupLocale" attribute is required.	It specifies the language
      locale of the report group display.

      The "parent" attribute is required.  It specifies the group name of a
      set of report categories.

      The "child" attribute is required.  It must be set to "" (e.g.
      child="") for this release.

      The "sourceType" attribute is required.  It must always be set to "0".

      The "sourceHandler" element is required.	It must always be set to
      "<sourceHandler></sourceHandler>".

      The "itemName" attribute is required.  It specifies the name of an
      item.

      The "displayFlag" attribute is required and specifies the display type
      of a report category.  It is required to be set to "1" to always
      display the report category.

      The "operation" element is optional.  If specified, then the
      attributes "op", "opName" and "opHandler" are required.

      If the "operation" element is defined, the "op" attribute is required
      and specifies a string to represent the operation.

      If the "operation" element is defined, the "opName" attribute is
      required and specifies the operation name or a mapping table name.

      If the "operation" element is defined, the "opHandler" attribute is
      required and specifies the fully qualified classname to handle the
      operation.

      The "dbType" attribute is optional and specifies the supported
      database type (MSSQL = 1, POSTGRESQL = 10, ORACLE = 100).	 Support for
      all databases is specified by "dbType=111".

      The "version" element is optional.  If specified, then the attributes
      "major" and "minor" are required.	 If the "version" element is
      defined, the "major" attribute is required and specifies the major
      version of the XML file.

      If the "version" element is defined, the "minor" attribute is required
      and specifies the minor version of the XML file.

    Commenting
      Comments may be included in XML files.  The comment must begin with
      the characters "<!--" and end with the characters "-->". Comments may
      span multiple lines within the beginning and ending character tags.

    Examples
      This section contains some examples of report category XML files.

      This example shows a file containing the definition of report
      categories named "Installed Controllers 12th floor" and "Inventory
      12th floor".

      <?xml version="1.0" encoding="UTF-8"?>
      <categoryList>
	   <category catName="Inventory 12th floor" displayFlag="1" queryType="1" editFlag="1" categoryId="1" plugin="0">
		<version major="1" minor="0"/>
		<group groupLocale="en_US" parent="General" child=""/>
		<input sourceType="0">
		     <sourceHandler/>
		     <source dbType="111">
      CREATE VIEW R_Inventory_12th_floor
      AS
      SELECT devices.DeviceKey, devices.Name AS DeviceName, IPAddress.IPAddress, devices.ProductName,
			    DB_DeviceInfoEx.SerialNumber, DB_DeviceInfoEx.AssetTag, DB_DeviceInfoEx.TotalMemory AS MemorySize,
			    DB_DeviceInfoEx.ROMVersion, DB_DeviceInfoEx.OSName, DB_DeviceInfoEx.OSVendor,
			    IPAddress.IPAddressNumber AS IPLongValue, DC_ProliantHost.ServerRole,
			    CIM_ComputerSystem.dc_SystemLocation AS Location,
			    CIM_ComputerSystem.PrimaryOwnerContact AS DeviceOwner,
			    devices.ProductType AS ProductType,
			    devices.OverallStatus AS DeviceStatus,
			    CIM_OperatingSystem.LastBootUpTime AS DeviceBootTime, CIM_ComputerSystem.SnapshotID
      FROM	DB_DeviceInfoEx RIGHT OUTER JOIN
			    devices LEFT OUTER JOIN
			    CIM_ComputerSystem LEFT OUTER JOIN
			    CIM_OperatingSystem ON CIM_ComputerSystem.NodeID = CIM_OperatingSystem.NodeID AND
			    CIM_ComputerSystem.SnapshotID = CIM_OperatingSystem.SnapshotID LEFT OUTER JOIN
			    DC_ProliantHost ON CIM_ComputerSystem.NodeID = DC_ProliantHost.NodeID AND
			    CIM_ComputerSystem.SnapshotID = DC_ProliantHost.SnapshotID ON
			    devices.DeviceKey = CIM_ComputerSystem.NodeID LEFT OUTER JOIN
			    IPAddress ON devices.DeviceKey = IPAddress.DeviceKey and IPAddress.ipindex = 0 ON
			    DB_DeviceInfoEx.DeviceKey = devices.DeviceKey
	       </source>
		</input>
		<displayName displayLocale="en_US">Inventory 12th floor</displayName>
		<dbViewName>R_Inventory_12th_floor</dbViewName>
		<item itemName="System Name" displayFlag="1">
		     <displayName displayLocale="en_US">System Name</displayName>
		     <dbViewName>R_Inventory1</dbViewName>
		     <dbViewColName>DeviceName</dbViewColName>
		     <displayOrder>1</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="IP Address" displayFlag="1">
		     <displayName displayLocale="en_US">IP Address</displayName>
		     <dbViewName>R_Inventory_12th_floor</dbViewName>
		     <dbViewColName>IPAddress</dbViewColName>
		     <displayOrder>2</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="System Status" displayFlag="1">
		     <displayName displayLocale="en_US">System Status</displayName>
		     <dbViewName>R_Inventory_12th_floor</dbViewName>
		     <dbViewColName>DeviceStatus</dbViewColName>
		     <displayOrder>3</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="Product Type" displayFlag="1">
		     <displayName displayLocale="en_US">Product Type</displayName>
		     <dbViewName>R_Inventory_12th_floor</dbViewName>
		     <dbViewColName>ProductType</dbViewColName>
		     <displayOrder>4</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="Product Model" displayFlag="1">
		     <displayName displayLocale="en_US">Product Model</displayName>
		     <dbViewName>R_Inventory_12th_floor</dbViewName>
		     <dbViewColName>ProductName</dbViewColName>
		     <displayOrder>5</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="Serial Number" displayFlag="1">
		     <displayName displayLocale="en_US">Serial Number</displayName>
		     <dbViewName>R_Inventory_12th_floor</dbViewName>
		     <dbViewColName>SerialNumber</dbViewColName>
		     <displayOrder>6</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="Asset Tag" displayFlag="1">
		     <displayName displayLocale="en_US">Asset Tag</displayName>
		     <dbViewName>R_Inventory_12th_floor</dbViewName>
		     <dbViewColName>AssetTag</dbViewColName>
		     <displayOrder>7</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="Memory Size (KB)" displayFlag="1">
		     <displayName displayLocale="en_US">Memory Size (KB)</displayName>
		     <dbViewName>R_Inventory_12th_floor</dbViewName>
		     <dbViewColName>MemorySize</dbViewColName>
		     <displayOrder>8</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="ROM Version" displayFlag="1">
		     <displayName displayLocale="en_US">ROM Version</displayName>
		     <dbViewName>R_Inventory_12th_floor</dbViewName>
		     <dbViewColName>ROMVersion</dbViewColName>
		     <displayOrder>9</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="Operating System Name" displayFlag="1">
		     <displayName displayLocale="en_US">Operating System Name</displayName>
		     <dbViewName>R_Inventory_12th_floor</dbViewName>
		     <dbViewColName>OSName</dbViewColName>
		     <displayOrder>10</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="Operating System Vendor" displayFlag="1">
		     <displayName displayLocale="en_US">Operating System Vendor</displayName>
		     <dbViewName>R_Inventory_12th_floor</dbViewName>
		     <dbViewColName>OSVendor</dbViewColName>
		     <displayOrder>11</displayOrder>
		     <privilege>0</privilege>

		</item>
		<item itemName="Server Role" displayFlag="1">
		     <displayName displayLocale="en_US">Server Role</displayName>
		     <dbViewName>R_Inventory_12th_floor</dbViewName>
		     <dbViewColName>ServerRole</dbViewColName>
		     <displayOrder>12</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="Location" displayFlag="1">
		     <displayName displayLocale="en_US">Location</displayName>
		     <dbViewName>R_Inventory_12th_floor</dbViewName>
		     <dbViewColName>Location</dbViewColName>
		     <displayOrder>13</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="System Owner" displayFlag="1">
		     <displayName displayLocale="en_US">System Owner</displayName>
		     <dbViewName>R_Inventory_12th_floor</dbViewName>
		     <dbViewColName>DeviceOwner</dbViewColName>
		     <displayOrder>14</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="System Boot Up Time" displayFlag="1">
		     <displayName displayLocale="en_US">System Boot Up Time</displayName>
		     <dbViewName>R_Inventory_12th_floor</dbViewName>
		     <dbViewColName>DeviceBootTime</dbViewColName>
		     <displayOrder>15</displayOrder>
		     <privilege>0</privilege>
		</item>
		<privilege>0</privilege>
	   </category>
	   <category catName="Installed Controllers 12th floor" displayFlag="1" queryType="1" editFlag="1" categoryId="1" plugin="0">
		<version major="1" minor="0"/>
		<group groupLocale="en_US" parent="General" child=""/>
		<input sourceType="0">
		     <sourceHandler/>
		     <source dbType="111">
      CREATE VIEW R_InstalledBoards12
      AS
      SELECT devices.DeviceKey, devices.Name AS DeviceName, CIM_PhysicalElement.Name AS BoardName,
		     CIM_PhysicalElement.Model AS BoardModel, CIM_PhysicalElement.Version AS BoardRevision,
		     CIM_PhysicalElement.dc_FirmwareRevision AS BoardFirmware, CIM_PhysicalElement.SerialNumber AS BoardSerial,
		     CIM_PhysicalElement.Slot_Number AS Slot, CIM_PhysicalElement.SnapshotID, CIM_PhysicalElement.dc_HWLocation AS Location,
		     CIM_PhysicalElement.Tag
      FROM  CIM_PhysicalElement LEFT OUTER JOIN
		     devices ON CIM_PhysicalElement.NodeID = devices.DeviceKey
      WHERE (NOT (CIM_PhysicalElement.Name IS NULL)) AND (CIM_PhysicalElement.Tag NOT LIKE '%Drive%') AND
		     (CIM_PhysicalElement.Tag NOT LIKE '%Blade%') AND (CIM_PhysicalElement.Tag NOT LIKE '%Power%') AND
		     (NOT (CIM_PhysicalElement.Tag LIKE N'%Connector%')) AND (NOT (CIM_PhysicalElement.Tag LIKE N'%Storage%')) AND
		     (NOT (CIM_PhysicalElement.Name LIKE N'%bridge%')) AND (NOT (CIM_PhysicalElement.Name LIKE N'%PROCESSOR%')) AND
		     (NOT (CIM_PhysicalElement.Name LIKE N'%Other%')) AND (NOT (CIM_PhysicalElement.Tag LIKE N'%EISA Board 0%')) OR
		     (CIM_PhysicalElement.Tag NOT LIKE '%Drive%') AND (CIM_PhysicalElement.Tag NOT LIKE '%Blade%') AND
		     (CIM_PhysicalElement.Tag NOT LIKE '%Power%') AND (NOT (CIM_PhysicalElement.Tag LIKE N'%Connector%')) AND
		     (NOT (CIM_PhysicalElement.Tag LIKE N'%Storage%')) AND (NOT (CIM_PhysicalElement.Model IS NULL)) AND
		     (NOT (CIM_PhysicalElement.Tag LIKE N'%EISA Board 0%')) OR
		     (CIM_PhysicalElement.Tag LIKE N'%Controller%')
	       </source>
		</input>
		<displayName displayLocale="en_US">Installed Controllers 12th floor</displayName>
		<dbViewName>R_InstalledBoards12</dbViewName>
		<item itemName="System Name" displayFlag="1">
		     <displayName displayLocale="en_US">System Name</displayName>
		     <dbViewName>R_InstalledBoards12</dbViewName>
		     <dbViewColName>DeviceName</dbViewColName>
		     <displayOrder>1</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="Slot" displayFlag="1">
		     <displayName displayLocale="en_US">Slot</displayName>
		     <dbViewName>R_InstalledBoards12</dbViewName>
		     <dbViewColName>Slot</dbViewColName>
		     <displayOrder>2</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="Board Name" displayFlag="1">
		     <displayName displayLocale="en_US">Board Name</displayName>
		     <dbViewName>R_InstalledBoards12</dbViewName>
		     <dbViewColName>BoardName</dbViewColName>
		     <displayOrder>3</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="Board Revision" displayFlag="1">
		     <displayName displayLocale="en_US">Board Revision</displayName>
		     <dbViewName>R_InstalledBoards12</dbViewName>
		     <dbViewColName>BoardRevision</dbViewColName>
		     <displayOrder>4</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="Board Model" displayFlag="1">
		     <displayName displayLocale="en_US">Board Model</displayName>
		     <dbViewName>R_InstalledBoards12</dbViewName>
		     <dbViewColName>BoardModel</dbViewColName>
		     <displayOrder>5</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="Board Firmware" displayFlag="1">
		     <displayName displayLocale="en_US">Board Firmware</displayName>
		     <dbViewName>R_InstalledBoards12</dbViewName>
		     <dbViewColName>BoardFirmware</dbViewColName>
		     <displayOrder>6</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="Board Serial Number" displayFlag="1">
		     <displayName displayLocale="en_US">Board Serial Number</displayName>
		     <dbViewName>R_InstalledBoards12</dbViewName>
		     <dbViewColName>BoardSerial</dbViewColName>
		     <displayOrder>7</displayOrder>
		     <privilege>0</privilege>
		</item>
		<item itemName="Location" displayFlag="1">
		     <displayName displayLocale="en_US">Location</displayName>
		     <dbViewName>R_InstalledBoards12</dbViewName>
		     <dbViewColName>Location</dbViewColName>
		     <displayOrder>8</displayOrder>
		     <privilege>0</privilege>
		</item>
		<privilege>0</privilege>
	   </category>
      </categoryList>


LIMITATIONS

      This command may only be run on the CMS.


AUTHOR

      mxreport was developed by the Hewlett-Packard Company.


SEE ALSO for HP-UX

      mxreport(1M), mxreport(4)


SEE ALSO for Linux

      mxreport(8), mxreport(4)