名称

      mxcategoryitem - Systems Insight Managerレポート カテゴリ ファイル形式


構文

      mxcategoryitem


説明

      mxcategoryitem コマンドは、拡張マークアップ言語(XML)形式で記述さ
      れたレポートおよびレポート カテゴリ情報の読み込みおよび書き込みをサポ
      ートしています。この機能を利用して、Systems Insight Manager環境内でレ
      ポートまたはレポート カテゴリを追加または削除することが可能です。

      各ファイルには、1つまたは複数のレポートまたはレポート カテゴリの定義を
      記述できます。


    文書型定義
      文書型定義(DTD)ファイルは、XMLファイルの規則を定義したものです。この
      規則には、有効な要素タグ、属性、XMLファイル内の要素の出現回数などがあ
      ります。レポートDTDファイルの名前は、mxcategoryitem.dtdであり、その内
      容を以下に示します。マンページの書式上、DTDの内容は実際のファイルと同
      じように表示されないことがあります。


       <?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
       >

    要素
      DTDで定義されているとおり、レポート カテゴリXMLファイルには以下の要素
      を記述できます。


      レポート カテゴリXMLファイルの1行目は、次のように記述しなければなりま
      せん。

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

      encoding-value パラメータは、有効なエンコード値に置き換えます。有効な
      エンコード値は、次のWebサイトにあります。


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

      XMLヘッダ行が指定されていない場合は、システムのデフォルトのエンコード
      は、"UTF-8"になります。


      "categoryList"要素はレポート カテゴリXMLファイルに1度だけ記述され、レ
      ポート情報リストを囲っている必要があります。 "categoryList"要素には、
      いくつかの"category"要素を含めることができます。



      "category"要素は、レポートXMLファイルに0回以上記述する必要があります。

      "catName"属性は必須で、固有のカテゴリ名を指定します。

      "displayFlag"属性は必須で、レポート カテゴリの表示タイプを指定します。
      カテゴリ レポートを表示する場合は、常に"1"に設定する必要があります。


      "queryType"属性は必須です。常に"1"に設定する必要があります。

      "editFlag"属性は必須で、レポート カテゴリを編集できるかを指定します。
      "0"を指定するとレポート カテゴリは編集できません。 "1"を指定するとレ
      ポート カテゴリは編集できます。この属性は内部で使用します。

      "categoryId"属性はオプションで、固有のレポート カテゴリIDを指定しま
      す。 XMLファイルに既存のレポート カテゴリを表示している場合、システム
      は常に"id"属性を出力します。 "categoryId"属性を指定する必要はありませ
      ん。


      "plugin"属性はオプションです。"0"は、システム カテゴリ定義レポートを指
      定します。


      "displayOrder"属性はオプションで、レポート カテゴリのデフォルトの表示
      順序を指定します。


      "dbViewColName"属性は必須です。hpmxItemテーブルのDbViewColNameを指定し
      ます。


      "dbViewName"属性は必須です。hpmxItemテーブルのDbViewNameを指定します。


      "displayName"属性は必須属性で、レポート カテゴリ表示名を指定します。
      "displayName"CMS内で固有のものでなければなりません。

      "displayLocale"属性は必須です。レポート カテゴリ表示の言語ロケールを指
      定します。


      "displayOrder"属性はオプションで、将来的に使用するものです。

      "groupLocale"属性は必須です。グループ レポート表示の言語ロケールを指定
      します。


      "parent"属性は必須です。レポート カテゴリのセットのグループ名を指定し
      ます。

      "child"属性は必須です。個載れリースでは、""(例 child="")に設定されて
      いる必要があります。


      "sourceType"属性は必須です。常に"0"に設定する必要があります。

      "sourceHandler"要素は必須です。常に"<sourceHandler></sourceHandler>"に
      設定する必要があります。

      "itemName"属性は必須です。項目の名前を指定します。

      "displayFlag"属性は必須で、レポート カテゴリの表示タイプを指定します。
      カテゴリ レポートを表示する場合は、常に"1"に設定する必要があります。


      "operation"要素はオプションです。指定すると、属性"op"、"opName"、およ
      び"opHandler"が必要です。


      "operation"要素が定義されていると、"op"属性が必要になり、オペレーショ
      ンの代わりに文字列を指定します。


      "operation"要素が定義されていると、"opName"属性が必要になり、オペレー
      ション名またはマッピング テーブル名の代わりに文字列を指定します。


      "operation"要素が定義されていると、"opHandler"属性が必要になり、オペ
      レーションを扱うための完全に確認されたクラス名を指定します。


      "dbType"属性はオプションで、サポートされているデータベース タイプ
      (MSSQL = 1、POSTGRESQL = 10、ORACLE = 100)を指定します。すべてのデー
      タベースをサポートする場合は、"dbType=111"と指定します。


      "version"要素はオプションです。指定すると、属性"major"および"minor"が
      必要です。

      "version"要素が定義されていると、"major"属性が必要になり、XMLファイル
      のメジャー バージョンを指定します。


      "version"要素が定義されていると、"minor"属性が必要になり、XMLファイル
      のマイナー バージョンを指定します。


    コメント
      XMLファイルには、コメントを記述することができます。コメントは、"<!--"
      で始まり、 "-->"で終了しなければなりません。コメントは開始タグと終了タ
      グの間で、複数行にわたって記述できます。

    
      本セクションでは、レポート カテゴリXMLファイルの例をいくつか示します。

      この例は、インベントリを報告する"Installed Controllers 12th floor"およ
      び"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>


制限事項

      本コマンドは、CMS上でのみ実行できます。


著者

      mxcategoryitem は、HPにより開発されました。


参照(HP-UX)

      mxreport(1M)、mxreport(4)


参照(Linux)

      mxreport(8)、mxreport(4)