Systemwalker Centric Manager 使用手引書 監視機能編 - UNIX共通 - - Microsoft(R) Windows(R) 2000/ Microsoft(R) Windows Server(TM) 2003 -

4.2.3 メッセージ説明の登録

メッセージ説明の登録では、[監視イベント:対処]ダイアログボックス、または、[監視イベント:返答]ダイアログボックスの[メッセージ説明]欄に表示する情報の定義方法を説明します。メッセージを特定するキーワードと、そのメッセージに対応するメッセージ説明の格納先の関係を定義します。

メッセージ説明を登録する方法は、定義画面から登録する方法とCSV入力によるコマンドからの登録ができます。

■定義画面から登録する

1. [イベント監視の動作環境設定（全体）]ダイアログボックスを表示します。呼び出し方法は、“[イベント監視の動作環境設定（全体）]ダイアログボックスを表示する”を参照してください。
2. [メッセージ説明]タブを選択します。

   →[メッセージ説明一覧]には、登録されているメッセージ説明の[格納先](ファイル/ヘルプデスク)、およびメッセージ説明格納先[ファイル名]または[帳票コード]、[キーワード]が表示されます。

3. メッセージ説明の追加・更新・削除の処理を行います。
   1. 更新、または、削除したい場合は、[メッセージ説明一覧]から、対象とする定義を選択します。
   2. 実行したい処理のボタンをクリックします。
   3. 以下の項目を入力します。

      [メッセージ説明の特定方法]

      • 追加または更新するメッセージ説明の格納先を選択します。
      • メッセージ説明の格納先をヘルプデスクとする場合、検索方法に応じて[ヘルプデスクに格納されている帳票コードを採用]または[ヘルプデスクの検索機能]を選択します。その場合、ヘルプデスクの環境が設定されている必要があります。
      • [ヘルプデスクの検索機能]を選択した場合、検索のキーは、メッセージのソース名およびイベントIDになります。詳細は、“ヘルプデスクの検索機能”を参照してください。

      [メッセージ説明格納先ファイル名]

      [ファイルに格納されているメッセージを採用]をチェックした場合、[メッセージ説明格納先ファイル名]を入力します。メッセージ説明格納先ファイルとして扱えるファイルは、文字コードがWindows版はSJIS、UNIX版はOSのLANG(文字コード)と同じ文字コードで作成した、テキストファイルです。

      [帳票コード]

      [ヘルプデスクに格納されている帳票コードを採用]をチェックした場合、[メッセージ説明の特定方法]として追加する[帳票コード]を入力します。

      [キーワード]

      [ファイルに格納されているメッセージを採用]または[ヘルプデスクに格納されている帳票コードを採用]をチェックした場合、メッセージ説明を特定するための[キーワード]を正規表現で入力します。

   4. [メッセージ説明設定(追加)]または[メッセージ説明設定(更新)]ダイアログボックスで[OK]ボタンをクリックし、メッセージ説明設定を追加または更新します。
4. [イベント監視の動作環境設定（全体）]ダイアログボックスで、次のどれかのボタンをクリックして、サーバ環境の定義を終了します。
   • [OK]ボタン

     変更した内容を定義ファイルに反映し終了します。

   • [キャンセル]ボタン

     変更した内容を定義ファイルに反映せずに終了します。

   • [更新]ボタン

     変更した内容が定義ファイルに反映されます。

   【Linux版またはSolaris版の場合】

   定義画面でUTF-8固有文字、または、全角文字を指定すると、以下の現象となります。

   • UTF-8固有文字が含まれている文字列（パス名）は、定義できません。また、[参照]ボタンをクリックしディレクトリ一覧を表示したときに、UTF-8固有文字が含まれる場合、正しく表示されません。
   • 全角文字を使用した場合、EUC環境と比較して指定可能文字数が減少します。

   “CSV入力によりコマンドから定義する”を参照し、コマンドで定義を行ってください。UTF-8固有文字を指定した場合は、定義はできますが、定義画面では正しく表示されません。

メッセージ説明は、[メッセージ説明一覧]の先頭から順番に検索されて表示されます。したがって、[メッセージ説明一覧]内のメッセージの位置が後ろになるほど、検索に時間がかかることになります。このため、一覧内のメッセージの位置をカスタマイズするために、以下のボタンが用意されています。

• [上移動]ボタンをクリックすると、選択している項目が一つ上へ移動します。
• [下移動]ボタンをクリックすると、選択している項目が一つ下へ移動します。

■CSV入力によりコマンドから定義する

コマンドにより現在のメッセージ説明定義を出力し、それを編集・追加することで、大量の定義を行うことができます。

1. メッセージ説明定義のCSV入出力コマンド(mpopmescsv)を使用し、現在のメッセージ説明定義を、meth.csvに出力します。

   mpopmescsv -o meth.csv

   
   
2. 上記で出力された定義(meth.csv)を、必要に応じて編集します。
3. メッセージ説明定義のCSV入出力コマンドを使用し、編集した結果をSystemwalkerに反映します。

   mpopmescsv -i meth.csv

入出力するCSVファイルは以下のような内容です。
例）

#Define Server Environment - Message Descpription
"MESSAGE","FILE","/opt/app/meth1.txt","^UX:app","/c"
"MESSAGE","CODE","tbl0001","^UX:HELP","/c"
"MESSAGE","SEARCH","","","/e"

メッセージ説明定義のCSV入出力コマンド(mpopmescsv)、メッセージ説明定義のCSVファイル形式の詳細については、“Systemwalker Centric Manager リファレンスマニュアル”を参照してください。

更新した定義はすぐに有効となります。また、本コマンドでメッセージ説明定義を入力した場合、既存の定義は上書きされます。既存の定義もそのまま残したい場合は、既存の定義に新規の定義を追加する必要があります。

注意事項/制限事項

• 入力ファイルの文字コードは、Systemwalkerの動作環境のものとあわせる必要があります。また、出力ファイルの文字コードは、Systemwalkerの動作環境と同じもので出力されます。
• 本コマンドでメッセージ説明定義を入力した場合、既存の定義は上書きされる。
• 入力定義に誤りがなければ、Systemwalkerに定義が設定される。
• メッセージ説明定義は定義順序（上下関係）を意識した定義であるため、CSVデータを作成する際には、定義順序を意識する必要があります。