名称
mxngroup - Systems Insight Managerシステム グループ ファイルの形式
構文
mxngroup
説明
mxngroup コマンドは、拡張マークアップ言語(XML)形式で記述されたシステ
ム グループ情報の読み込みおよび書き込みをサポートしています。この機能
を利用して、Systems Insight Manager環境内で複数のシステム グループを追
加、変更、または削除することが可能です。各ファイルには、1つまたは複数
のシステム グループの定義を記述できます。
文書型定義
文書型定義(DTD)ファイルは、XMLファイルの規則を定義したものです。この
規則には、有効な要素タグ、属性、XMLファイル内の要素の出現回数などがあ
ります。ユーザDTDファイルの名前は、userlist.dtdであり、その内容を以下
に示します。マンページの書式上、DTDの内容は実際のファイルと同じように
表示されないことがあります。
<?xml version="1.0" encoding="UTF-8" ?>
<!-- READ THIS FIRST! This file is intentionally formatted with a
right margin set at 70. This allows the DTD file to be pasted
directly into the mxngroup(4) man page file. Please respect this
constraint when editing this file. After edits are final for
a given release, please paste the final DTD version in the
mxngroup(4) man page to keep the documentation current. -->
<!-- The node-group-list element consists of 0 or more node group
elements. -->
<!ELEMENT node-group-list ( node-group )* >
<!-- The node-group element has the following attributes: -->
<!-- The name attribute specifies the nodegroup name and is required.
-->
<!-- The guid attribute specifies the nodegroup GUID and is optional.
-->
<!-- The node-group element is composed of the following elements: -->
<!-- The description element may optionally appear once and specifies
the node group description. -->
<!-- The member-node element may appear zero or more times and
specifies the node group's member nodes. -->
<!-- The attribute element may appear zero or more times and specifies
the node group's client attributes. -->
<!ELEMENT node-group ( description?, member-node*, attribute* ) >
<!ATTLIST node-group name CDATA #REQUIRED
guid NMTOKEN #IMPLIED >
<!ELEMENT description ( #PCDATA ) >
<!-- The member-node element is an empty element with one attribute.
The value attribute specifies the node name and is required. -->
<!ELEMENT member-node EMPTY >
<!ATTLIST member-node value CDATA #REQUIRED >
<!-- The attribute element specifies the name value pairs that
comprise client attributes. The client attribute name is
specified using the name attribute and the client attribute value
is specified as the PCDATA of the element. -->
<!ELEMENT attribute ( #PCDATA ) >
<!ATTLIST attribute name 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"になります。
"node-group-list"要素はユーザXMLファイルに1度だけ記述され、システム グ
ループ情報リストを囲っている必要があります。 "node-group-list"要素に
は、0個以上の"node-group"要素を含めることができます。 "node-group-
list"要素に"node-group"要素が含まれていない場合、関連するmxngroupコマ
ンドを実行しても何の効果もありません。
"node-group"要素は、ノード グループXMLファイルに1回以上記述する必要が
あります。 "node-group"要素には3つの属性があります。
"node-group"属性は必須属性で、システム グループ名を指定します。
"guid"属性は任意属性で、グローバルに一意のシステム グループの識別子を
指定します。この値はシステムが割り当てるため、新たなノード グループを
追加する場合、システムはこの属性を無視します。
"node"要素には、いくつかの任意要素を含めることができます。
"description"要素は各"node"要素ごとに1度だけ記述できます。 "member-
node"および"attribute"要素はゼロ回以上記述できます。各要素は、DTDファ
イルに定義された順序で記述しなければなりません。
"description"要素は、システム グループの説明を指定します。
"member-node"要素は空要素で、"value"属性が必要です。 "value"属性はシス
テム グループのシステムのノード名を指定します。
"attribute"要素は、システム グループと関連付ける一連のクライアント属性
を指定します。各"attribute"要素は"name"属性を含み、この属性によりクラ
イアント属性、およびクライアント属性の値を指定する"value"要素が識別さ
れます。
コメント
XMLファイルには、コメントを記述することができます。コメントは、"<!--"
で始まり、 "-->"で終了しなければなりません。コメントは開始タグと終了タ
グの間で、複数行にわたって記述できます。
例
本セクションでは、システム グループXMLファイルの例をいくつか示します。
次の例は、説明を含むシステム グループを記述したファイルを示していま
す。メンバは含みません。
<?xml version="1.0" encoding="UTF-8"?>
<node-group-list>
<node-group name="group1">
<description>An empty system group.</description>
</node-group>
</node-group-list>
次の例は、2つのシステム グループを含むファイルを示しています。最初のシ
ステム グループは説明を含み、メンバは含みません。 2番目のシステム グ
ループは説明と1つのメンバを含んでいます。
<?xml version="1.0" encoding="UTF-8"?>
<node-group-list>
<node-group name="group1">
<description>An empty system group.</description>
</node-group>
<node-group name="group2">
<description>A group with one system.</description>
<member-node value="node.dom1.corp.com" />
</node-group>
</node-group-list>
制限事項
本コマンドは、CMS上でのみ実行できます。
著者
mxngroup は、HPにより開発されました。
参照(HP-UX)
mxngroup(1M)
参照(Linux)
mxngroup(8)