名称
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)