付録J.4　JP1/SESイベントをJP1イベントに変換する

■ 定義する内容

拡張属性マッピング設定ファイルには，対象となるJP1/SESイベントを絞り込むためのイベントフィルター，およびJP1/SESイベントに付加する拡張属性とメッセージを定義します。

■ 格納場所

拡張属性マッピング設定ファイルは，JP1/Baseがインストールされたマシン上の次のディレクトリに作成します。

Windowsの場合

イベントサーバインデックスで指定されたディレクトリ\sesmap\

初期設定のイベントサーバインデックスでは次のようになります。

インストール先フォルダ\conf\event\servers\default\sesmap\

UNIXの場合

イベントサーバインデックスで指定されたディレクトリ/sesmap/

初期設定のイベントサーバインデックスでは次のようになります。

/etc/opt/jp1base/conf/event/servers/default/sesmap/

sesmapディレクトリは，標準インストールの状態では存在しません。まずsesmapディレクトリを作成し，その直下に，次の形式のファイル名を持つテキストファイルを作成してください。

会社名_製品名_map.conf

「製品名」は，「シリーズ名_製品名」とすることもできます。JP1イベント発行時の「PRODUCT_NAME」に指定する値の「/」を「_」に変更してファイル名に使用することをお勧めします。また，標準提供ファイル名称用に「hitachi」を使用しているため，「会社名」には「hitachi」以外の名称を使用してください。

なお，拡張属性マッピング設定ファイルは複数作成することもできます。sesmapディレクトリの直下に異なる名称の複数の拡張属性マッピング設定ファイルを作成すれば，それらのファイルの定義に基づいて，該当するJP1/SESイベントが変換されます。複数の拡張属性マッピング設定ファイルを作成した場合，それらの定義は，ファイル名の昇順に解析されます。

注意事項

sesmapディレクトリには，定義ファイル以外のファイルは格納しないでください。

バックアップファイルやモデルファイルを格納している場合，それらのファイルにより変換が行われることがあります。

■ 形式

拡張属性マッピング設定ファイルは，マッピング設定ブロックの集合体です。マッピング設定ブロックの形式を次に示します。

[コメント]
map
[フィルターブロック]
[メッセージ指定]
[拡張属性指定1]
[拡張属性指定2]
       ：
[拡張属性指定n]
end-map
[コメント]

コメントは，「#」で開始する改行を含まない行です。コメントは，マッピング設定ブロックとマッピング設定ブロックの間に記述できますが，マッピング設定ブロックの内部には記述できません。

「map」および「end-map」は，それぞれ，マッピング設定ブロックの開始および終了を宣言します。

マッピング設定ブロックを構成するほかの要素について，次に説明します。

filter
イベントフィルター
end-filter

B.MESSAGE区切り文字 メッセージ文字列

E.拡張属性名 区切り文字 拡張属性値

■ 注意事項

• 拡張属性マッピング設定ファイルでは，1レコードが最大1,024バイトに制限されます。

• フィルターブロック，メッセージ指定，拡張属性指定はそれぞれ省略できますが，指定する場合はこの順番に指定してください。誤った順番で指定した場合，または拡張属性指定以外のブロックを2回以上指定した場合は，そのマッピング設定ブロック全体が無効になります。

• フィルターブロックで定義するフィルターに日本語文字列を指定した場合，その文字コードとJP1/SES形式で登録されたイベントの文字コードが異なると，そのイベントは変換されません。

• 拡張属性マッピング設定ファイルでは，除外条件はサポートされていません。フィルターブロックで定義するフィルターに除外条件を指定しないでください。

■ 定義例