重大度変更定義ファイル(jcochsev.conf)

形式

DESC_VERSION=バージョン情報

#重大度変更定義パラメーター

def 定義名1
   cnd
       イベント条件
   end-cnd
   sev 重大度
end-def

def 定義名2
   cnd
       イベント条件
   end-cnd
   sev 重大度
end-def

ファイル

jcochsev.conf(重大度変更定義ファイル)

jcochsev.conf.model(重大度変更定義ファイルのモデルファイル)

格納先ディレクトリ

Windowsの場合
物理ホストのとき

Consoleパス¥conf¥chsev¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥chsev¥

UNIXの場合
物理ホストのとき

/etc/opt/jp1cons/conf/chsev/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/chsev/

説明

イベントの重大度変更機能で,重大度を変更するJP1イベントの条件と変更後の重大度を定義するファイルです。イベントの重大度変更機能は,このファイルの定義に従い,イベント条件に一致するJP1イベントの重大度を変更します。このファイルは,JP1/IM - Managerの動作する言語コードで記述してください。

このファイルの最大サイズは,17メガバイト(17,825,792バイト)です。

重大度変更定義ファイルのパラメーターには,次の2種類があります。

定義の反映時期

イベントの重大度変更機能が有効で,次のどちらかが成立する場合に有効になります。

記述内容(重大度変更定義ファイルバージョン)

DESC_VERSION
DESC_VERSIONには,重大度変更定義ファイルの形式を決定するファイルバージョンをバージョン情報として定義します。09-00の重大度変更定義ファイルのファイルバーションは,1です。DESC_VERSIONの指定を省略した場合,ファイルバージョンを1と見なして処理します。
DESC_VERSIONは,定義ファイルの先頭行(空行,コメント行を除いた行のうちファイルのはじめに記述された行)に記載します。先頭行にファイルバージョンがなかった場合は,ファイルバージョンを1と見なして処理します。

記述内容(重大度変更定義パラメーター)

def~end-def(定義ブロック)
重大度変更定義の開始と終了のパラメーターです。def~end-defブロックは省略でき,この場合「すべてのJP1イベントの重大度を変更しない」と解釈します。def以降には,重大度変更定義の定義名を記述します。「def 定義1 定義2 」と指定した場合,「 定義1 定義2 」が定義名となります。
定義名は,重大度定義ファイル内でユニークになるように1~50バイトの文字列で指定します。指定できる文字は,制御文字(0x00~0x1F,0x7F~0x9F)以外の文字列です。
cnd~end-cnd(イベント条件ブロック)
重大度を変更するJP1イベントのイベント条件を指定する,ブロックの開始と終了のパラメーターです。イベント条件ブロックは,定義ブロック内に必ず一つ指定する必要があります。省略はできません。受信したJP1イベントが,複数のイベント条件に一致する場合,重大度変更定義ファイルの先頭に近い定義ブロックが優先されます。cndおよびend-cndパラメーターの前後のタブやスペースは,無視されます。
イベント条件
重大度を変更するJP1イベントの条件を指定します。イベント条件ブロックには,1~256件のイベント条件を指定できます。イベント条件とイベント条件は,AND条件となります。イベント条件は,次の形式で指定します。

 属性名 比較キーワード オペランド [ オペランド]…

なお,半角スペースまたはタブだけで構成された行は,無視して処理を続行します。
属性名
属性名には,比較したい属性の名称を記述します。基本属性を指定する場合は,名称の前に「B.」を付けます。拡張属性(共通情報),拡張属性(固有情報)を指定する場合は,名称の前に「E.」を付けます。英小文字と英大文字を区別します。
指定できる属性名と比較キーワードの組み合わせおよびオペランドを次に示します。

表2-44 指定できる属性名と比較キーワードの組み合わせおよびオペランド

項番項目属性名比較
キーワード
オペランド
1イベントIDB.ID
  • と一致する
  • と一致しない
複数指定できる。複数指定では最大100件指定できる。
16進数形式で指定する。大文字・小文字は区別しない。
指定できる範囲は0~7FFFFFFFである。
2登録要因B.REASON
  • と一致する
  • と一致しない
複数指定できる。複数指定では最大100件指定できる。
3発行元プロセスIDB.PROCESSID
  • と一致する
  • と一致しない
複数指定できる。複数指定では最大100件指定できる。
指定できる範囲は,-2,147,483,648~2,147,483,647である。
4発行元ユーザーIDB.USERID
  • と一致する
  • と一致しない
複数指定できる。複数指定では最大100件指定できる。
指定できる範囲は,-2,147,483,648~2,147,483,647である。
5発行元グループIDB.GROUPID
  • と一致する
  • と一致しない
複数指定できる。複数指定では最大100件指定できる。
指定できる範囲は,-2,147,483,648~2,147,483,647である。
6発行元ユーザー名B.USERNAME
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。複数指定では最大100件指定できる。
7発行元グループ名B.GROUPNAME
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。複数指定では最大100件指定できる。
8発行元イベントサーバ名(登録ホスト名)※1B.SOURCESERVER
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。複数指定では最大100件指定できる。
9送信先イベントサーバ名※1B.DESTSERVER
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。複数指定では最大100件指定できる。
10メッセージB.MESSAGE
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。複数指定では最大100件指定できる。
11重大度E.SEVERITYと一致する複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。"Emergency","Alert","Critical","Error","Warning","Notice","Information","Debug"のどれかを指定できる。
12ユーザー名E.USER_NAME
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。複数指定では最大100件指定できる。
13プロダクト名E.PRODUCT_NAME
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。複数指定では最大100件指定できる。
14オブジェクトタイプE.OBJECT_TYPE
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。複数指定では最大100件指定できる。
15オブジェクト名E.OBJECT_NAME
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。複数指定では最大100件指定できる。
16登録名タイプE.ROOT_OBJECT_TYPE
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。複数指定では最大100件指定できる。
17登録名E.ROOT_OBJECT_NAME
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。複数指定では最大100件指定できる。
18オブジェクトIDE.OBJECT_ID
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。複数指定では最大100件指定できる。
19事象種別E.OCCURRENCE
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。複数指定では最大100件指定できる。
20終了コードE.RESULT_CODE
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。複数指定では最大100件指定できる。
21発生元ホスト名※1E.JP1_SOURCEHOST
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。複数指定では最大100件指定できる。
22固有の拡張属性※3E.xxxxxxx
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
属性名には,先頭が英大文字で英大文字,数字,およびアンダーバー(_)から構成される32バイトまでの名称を設定できる。
複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。複数指定では最大100件指定できる。
注※1
統合監視DBおよびIM構成管理DBが有効な場合に,比較キーワードが,「と一致する」「と一致しない」のとき,パス表記で業務グループ名を指定できます。
統合監視DBおよびIM構成管理DBが無効な場合,および[と一致する][と一致しない]以外を選択した場合,パス表記で業務グループ名を指定しても,ホスト名として扱われます。
jcoimdefコマンドの-ignorecasehostオプションの指定を「ON」にしている場合に,比較キーワードで[正規表現]以外を選択すると,文字列の英大文字・小文字を区別しません。
注※2
各JP1製品固有の拡張属性も使用できます。例えば,JP1/AJSのジョブの実行ホストは,E.C0です。製品固有の拡張属性についての詳細は,JP1イベントを発行する各製品のマニュアルを参照してください。

比較キーワード
比較キーワードには,「BEGIN(から始まる)」,「IN(と一致する)」,「NOTIN(と一致しない)」,「SUBSTR(を含む)」,「NOTSUBSTR(を含まない)」,「REGEX(正規表現)」のどれか一つを指定できます。英小文字と英大文字を区別します。
オペランド
比較キーワードで属性値と比較する値を文字列で指定します。英小文字と英大文字を区別します。
オペランドを複数指定する場合は,一つ以上の連続した半角スペースまたはタブをオペランドとオペランドの間に挿入して区切ります。オペランドとオペランドは,OR条件となります。ただし,正規表現を指定している場合は,複数指定できません。
オペランドに,半角スペース,タブ,改行コード(CR,LF)および%を指定したい場合,次のように記述します。
項番指定したい値指定方法
1タブ(0x09)%09
2半角スペース(0x20)%20
3%(0x25)%25
4改行コード LF(0x0a)%0a
5改行コード CR(0x0d)%0d
定義フォーマットの上限チェックの場合,%20,%25は1文字として扱います。複数選択した場合の定義例「IDが100と200に一致する」を示します。

B.ID△IN△100△200

(凡例) △:半角スペース(0x20)

オペランドは,イベント条件1件当たり4,096バイトまで,イベント条件ブロック1件当たり4,096バイト(イベント条件ブロックに記述したオペランドの合計バイト数)まで指定できます。
sev
変更後の重大度を記述するパラメーターです。
sevパラメーターは,定義ブロック内に必ず一つ指定する必要があります。省略はできません。
sevパラメーターに指定できる値は,"Emergency"(緊急),"Alert"(警戒),"Critical"(致命的),"Error"(エラー),"Warning"(警告),"Notice"(通知),"Information"(情報),"Debug"(デバッグ)のどれかです。
#コメント文
#で始まる行は,コメント扱いとなります。

定義例

イベントIDが100または200に一致,かつ重大度がWarningで,かつ登録ホストがhostA,hostB,hostCに一致する場合に,重大度をEmergencyに変更する例を次に示します。

DESC_VERSION=1
def 重大度変更1
   cnd
       B.ID IN 100 200
       E.SEVERITY IN Warning
       B.SOURCESERVER IN hostA hostB hostC
   end-cnd
   sev Emergency
end-def