Systemwalker Centric Manager リファレンスマニュアル - UNIX/Windows(R)共通 -

2.3.23.1 メッセージ変換定義のCSV形式

■使用用途

イベントコリレーション定義のCSVファイルにおいて、メッセージ変換定義を設定するための形式です。

■ファイル形式

メッセージ変換定義は以下の形式で設定します。

定義形式のバージョン
メッセージ変換の定義
　　：

■パラメタ

定義形式のバージョン:

メッセージ変換定義の形式のバージョンを1行目に設定します。以下の文字列で固定です。
“vl=1.00"

　

メッセージ変換の定義:

メッセージ変換の定義は、以下の項目をカンマ区切りで指定します。2048個まで定義することができます。

列	項目名	最大長(B)	値の形式	備考
1	行番号	5	1〜2048の値を指定します。変換定義が無効の場合、番号の前に“;”を指定します。
2	コメント	255	変換定義に設定するコメントを設定します。コメント内に改行を含むことができます。	任意
3	発生ホスト名	128	イベントの発生ホスト名を特定するための条件を設定します。 空欄: 特定しない - : 自システム = : すべての他システム ホスト名: 正規表現文字列で指定可能
4	メッセージ	2048	変換するメッセージを特定するための条件を設定します。 空欄: 特定しない テキスト: 正規表現文字列で指定可能
5	変換方法	4	メッセージの変換方法を指定します。 NONE: メッセージ変換しない ALL: 全文置き換え ADD: メッセージの追加 PART: 文字列の置き換え KEY: キーワード抽出
6	キーワード定義	2048	変換方法としてPARTを指定した場合は、変換元のメッセージに含まれる文字列を指定します。KEYを指定した場合は、キーワード抽出用の定義を指定します。 ALL/ADDを指定した場合は無効です。
7	変換定義	2048	変換方法として、ALL/ADD/KEYを指定した場合は、変換後のテキストを指定します。PARTを指定した場合は、変換後の文字列を指定します。

キーワード定義:

キーワード定義は以下のように設定します。

変換方法にPART(文字列の置き換え)を指定した場合

変換を行う元メッセージに含まれる文字列を指定します。

変換方法にKEY(キーワード抽出)を指定した場合

以下の形式でキーワードを抽出するための定義を指定します。複数のキーワードを抽出する場合、カンマで区切って指定します。最大10個まで指定することができます。

形式:　"元メッセージ内の文字列"=マクロ名

元メッセージ内の文字列:

元メッセージ内のキーワードとして検索する文字列を""で囲んで指定します。キーワード文字列内に二重引用符を含む場合は、二重引用符の前に“\”を指定してください。

マクロ名:

キーワードの後ろの文字列を代入するマクロ名を指定します。省略可能です。

例) "JobNetComment="=%KEY0,"JobName="=,"Code="=%KEY1

変換定義:

変換定義は以下のように設定します。

変換方法にALL(全文置き換え)を指定した場合

変換後のメッセージの全文を設定します。

変換方法にADD(メッセージの追加)を指定した場合

変換後のメッセージを設定し、元メッセージを設定する位置にマクロ名を指定します。以下のマクロを指定できます。

%MSG- 元のメッセージ全文

%HOST- イベントの発生ホスト名

例) ハード装置の異常を検出しました。(%MSG)

変換方法にPART(文字列の置き換え)を指定した場合

変更後の文字列を指定します。

変換方法にKEY(キーワード抽出)を指定した場合

変換後のメッセージを設定し、キーワード定義で抽出した文字列を設定する位置をマクロ名で指定します。以下のマクロを指定できます。

%KEY0〜%KEY9- キーワード定義で抽出した文字列

%MSG- 元のメッセージ全文

%HOST- イベントの発生ホスト名

例) 業務が異常終了しました。業務=%KEY0 コード=%KEY1

■参照

イベントコリレーション定義のCSVファイル

mpaoscrdef(イベントコリレーション定義のCSV反映コマンド)

mpaoscrcsv(イベントコリレーション定義のCSV出力コマンド)

■注意事項

• 特定できない条件について

  以下の特定する条件を指定することはできません。

  ・発生ホスト名において、“-”,“=”という名前のホスト名

• 定義項目内の改行コードについて

  項目の説明で“改行コードを含むことができる”と記述していない項目については、定義内に改行コードを含むことはできません。

• ファイルの文字コードについて

  CSVファイル内に全角文字を指定する場合は、SJISコードで指定してください。

■使用例

vl=1.00
1,,-,^UX:apagt: ERROR:,KEY,"""CODE=""=%KEY0","ERROR OCCURED %KEY0"
2,,,,ADD,,MSG=%MSG