共通除外条件拡張定義ファイル

形式

DESC_VERSION=ファイルバージョン
#コメント
def 条件群名
   [cmt コメント]
   id 条件群ID
   [valid {true | false}]
   [date 開始日-終了日]
   [rtime 開始時刻-終了時刻]
   [week 曜日]
   cnd
       イベント条件
   end-cnd
end-def

def 条件群名2
・・・
end-def
  :

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合
任意のフォルダ
UNIXの場合
任意のディレクトリ

説明

拡張モードの共通除外条件のイベント条件や適用期間を定義するファイルです。

共通除外条件のモードを拡張モードに変更した場合に,正規表現にエラーがあったときに出力されます。

なお,イベント取得フィルター(互換用)を使用している場合,共通除外条件を使用できません。イベント取得フィルター(互換用)を使用している場合は,jcochafmodeコマンドでイベント取得フィルターに変更してください。jcochafmodeコマンドについては,「jcochafmode」(1. コマンド)を参照してください。

定義の反映時期

jcochfilterコマンドの-efオプションを指定すると,定義内容が反映されます。jcochfilterコマンドについては,「jcochfilter」(1. コマンド)を参照してください。

記述内容

DESC_VERSION=ファイルバージョン
共通除外条件拡張定義ファイルのバージョンを表します。指定できる値は1だけです。省略した場合,「1」を仮定します。
#コメント文
#で始まる行は,コメント扱いとなります。
def~end-def(定義ブロック
拡張モードの共通除外条件定義の開始と終了のパラメーターです。def~end-defブロックは省略できます。def以降には,拡張モードの共通除外条件の条件群名を記述します。「def△△△条件群名1△△△条件群名2△△△」と指定した場合,「△△条件群名1△△△条件群名2△△△」が定義名となります(△は半角スペースまたはタブを表す)。
条件群名は,共通除外条件拡張定義ファイル内でユニークになるように1~50バイトの文字列で指定します。指定できる文字は,制御文字(0x00~0x1F,0x7F~0x9F)以外の文字列です。
cmt コメント
拡張モードの共通除外条件の説明を記述します。このパラメーターは省略できます。コメントは1,024バイト以内で指定してください。指定できる文字は,すべての文字です。
id 条件群ID
拡張モードの共通除外条件の条件群IDを指定するパラメーターです。0以上,最大定義数から1を引いた値以下で指定できます。このパラメーターは省略できません。
valid {true | false}
拡張モードの共通除外条件を有効にするかどうかを指定するパラメーターです。
大文字・小文字を区別しません。省略した場合,trueが指定されます。
date 開始日-終了日
拡張モードの共通除外条件を適用する期間を指定するパラメーターです。このパラメーターは省略できます。次の形式で指定します。

 date△YYYYMMDD-YYYYMMDD
 (凡例)△:半角スペース

 
指定できる期間は1970/01/01~2038/01/19です。
このパラメーターを省略した場合,常に適用となります。
また,開始日を省略した場合,拡張モードの共通除外条件を定義した時点から終了日まで適用されます。終了日を省略した場合,開始日から常に適用となります。
rtime 開始時刻-終了時刻
拡張モードの共通除外条件を適用する時刻を指定するパラメーターです。このパラメーターは省略できます。次の形式で指定します。

 date△HHMM-HHMM
 (凡例)△:半角スペース

 
このパラメーターを省略した場合,開始時刻を9:00,終了時刻を開始時刻の24時間後と仮定します。また,開始時刻は省略できません。終了時刻を省略した場合,開始時刻から24時間後まで適用されます。
week 曜日
拡張モードの共通除外条件を適用する曜日を指定するパラメーターです。このパラメーターは省略できます。複数の曜日を指定する場合は「,」(半角コンマ)で区切ります。次の形式で指定します。

 week△0,1,2,3,4,5,6
 (凡例)△:半角スペース

 
曜日と数値は次のとおり対応しています。
  • 日曜日:0
  • 月曜日:1
  • 火曜日:2
  • 水曜日:3
  • 木曜日:4
  • 金曜日:5
  • 土曜日:6
曜日を省略した場合,すべての曜日として適用されます。
cnd~end-cnd(イベント条件ブロック)
拡張モードの共通除外条件のイベント条件を指定する,ブロックの開始と終了のパラメーターです。イベント条件ブロックは,定義ブロック内に必ず一つ指定する必要があります。省略はできません。cndおよびend-cndパラメーターの前後のタブやスペースは,無視されます。
イベント条件
拡張モードの共通除外条件で除外するJP1イベントの条件を指定します。イベント条件ブロックには,0~256件のイベント条件を指定できます。イベント条件とイベント条件は,AND条件となります。次の形式で指定します。

 属性名△比較キーワード△オペランド
 (凡例)△:半角スペース

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

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

項番項目属性名比較
キーワード
オペランド
1イベントIDB.ID
  • と一致する
  • と一致しない
JP1イベントのイベントIDを指定する。
  • 最大100件複数指定できる。
  • 16進数形式で指定する。
  • 英大文字・英小文字は区別しない。
  • 指定できる範囲は0~7FFFFFFFである。
2登録要因B.REASON
  • と一致する
  • と一致しない
JP1イベントの登録要因を設定する。
  • 最大100件複数指定できる。
  • 英大文字・英小文字は区別する。
3発行元プロセスIDB.PROCESSID
  • と一致する
  • と一致しない
JP1イベントの発行元アプリケーションのプロセス別IDを指定する。
  • 最大100件複数指定できる。
  • 指定できる範囲は,-2,147,483,648~2,147,483,647である。
4登録時刻B.TIME
  • 時刻範囲
JP1イベントが発行元ホストのイベントDBに登録された時刻を指定する。
  • JP1/IM - Managerが稼働している環境の時刻で指定する。
  • 範囲開始日時および範囲終了日時,または期間を指定する。
  • 範囲開始日時≦時刻≦範囲終了日時が成立する場合に比較できる。
5到着時刻B.ARRIVEDTIME
  • 時刻範囲
JP1イベントがマネージャーホストのイベントDBに登録された時刻を指定する。
  • JP1/IM - Managerが稼働している環境の時刻で指定する。
  • 範囲開始日時および範囲終了日時,または期間を指定する。
6発行元ユーザーIDB.USERID
  • と一致する
  • と一致しない
JP1イベントの発行元プロセスのユーザーIDを指定する。
  • 最大100件複数指定できる。
  • 指定できる範囲は,-2,147,483,648~2,147,483,647である。
7発行元グループIDB.GROUPID
  • と一致する
  • と一致しない
JP1イベントの発行元プロセスのグループIDを指定する。
  • 最大100件複数指定できる。
  • 指定できる範囲は,-2,147,483,648~2,147,483,647である。
8発行元ユーザー名B.USERNAME
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
JP1イベントの発行元プロセスのユーザー名を指定する。
  • 最大100件複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。
  • 英大文字・英小文字は区別する。
9発行元グループ名B.GROUPNAME
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
JP1イベントの発行元プロセスのグループ名を指定する。
  • 最大100件複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。
  • 英大文字・英小文字は区別する。
10発行元IPアドレスB.SOURCEIPADDR
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
JP1イベントの発行元イベントサーバに対応するIPアドレスを指定する。
  • 最大100件複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。
11発行元イベントサーバ名(登録ホスト名)B.SOURCESERVER
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
JP1イベントの登録ホスト名(イベントサーバ名)を指定する。
  • 最大100件複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。
  • 英大文字・英小文字は区別する。
12メッセージB.MESSAGE
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
JP1イベントのメッセージを設定する。
  • 最大100件複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。
  • 英大文字・英小文字は区別する。
13重大度(変更前)E.SEVERITY
  • 属性有
  • 属性無
  • と一致する
JP1イベントの重大度の有無,種類を指定できる。
  • 比較キーワードが「と一致する」の場合,"Emergency"(緊急),"Alert"(警戒),"Critical"(致命的),"Error"(エラー),"Warning"(警告),"Notice"(通知),"Information"(情報),"Debug"(デバッグ)の中から複数指定できる。
14ユーザー名E.USER_NAME
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
JP1イベントを発行したユーザー名を指定する。
  • 最大100件複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。
  • 英大文字・英小文字は区別する。
15プロダクト名E.PRODUCT_NAME
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
JP1イベントを発行したプログラムの名称を指定する。
  • 最大100件複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。
  • 英大文字・英小文字は区別する。
16オブジェクトタイプE.OBJECT_TYPE
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
JP1イベントのオブジェクトの種類を指定する。
  • 最大100件複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。
  • 英大文字・英小文字は区別する。
17オブジェクト名E.OBJECT_NAME
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
JP1イベントのオブジェクト名を指定する。
  • 最大100件複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。
  • 英大文字・英小文字は区別する。
18登録名タイプE.ROOT_OBJECT_TYPE
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
JP1イベントの登録名タイプを指定する。
  • 最大100件複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。
  • 英大文字・英小文字は区別する。
19登録名E.ROOT_OBJECT_NAME
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
JP1イベントの登録名を指定する。
  • 最大100件複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。
  • 英大文字・英小文字は区別する。
20オブジェクトIDE.OBJECT_ID
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
JP1イベントのオブジェクトタイプを指定する。
  • 最大100件複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。
  • 英大文字・英小文字は区別する。
21事象種別E.OCCURRENCE
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
JP1イベントの事象種別を指定する。
  • 最大100件複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。
  • 英大文字・英小文字は区別する。
22開始時刻E.START_TIME
  • 時刻範囲
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
JP1イベントの実行開始または再実行開始の時刻を設定する。
  • 比較キーワードが「時刻範囲」の場合
    ・範囲開始日時および範囲終了日時,または期間を指定する。
    ・範囲開始日時≦時刻≦範囲終了日時が成立する場合に比較できる。
    ・比較対象の属性が10進数の場合,通算秒として比較する。
  • 比較キーワードが「時刻範囲」以外の場合
    ・最大100件複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。
    ・オペランドを文字列として指定した比較キーワードで比較する。
23終了時刻E.END_TIME
  • 時刻範囲
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
JP1イベント実行終了の時刻を設定する。
  • 比較キーワードが「時刻範囲」の場合
    ・範囲開始日時および範囲終了日時,または期間を指定する。
    ・範囲開始日時≦時刻≦範囲終了日時が成立する場合に比較できる。
    ・比較対象の属性が10進数の場合,通算秒として比較する。
  • 比較キーワードが「時刻範囲」以外の場合
    ・最大100件複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。
    ・オペランドを文字列として指定した比較キーワードで比較する。
24終了コードE.RESULT_CODE
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
JP1イベントの終了コードを設定する。
  • 最大100件複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。
  • 英大文字・英小文字は区別する。
25発生元ホスト名E.JP1_SOURCEHOST
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
JP1イベントの発生元ホストのホスト名を指定する。
  • 最大100件複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。
  • 英大文字・英小文字は区別する。
26固有の拡張属性E.xxxxxxx
  • から始まる
  • と一致する
  • と一致しない
  • を含む
  • を含まない
  • 正規表現
JP1イベントの固有の拡張属性の属性名を指定する。
  • 属性名には,先頭が英大文字で英大文字,数字,およびアンダーバー(_)から構成される32バイトまでの名称を設定できる。
  • 最大100件複数指定できる。ただし,正規表現を指定した場合は,複数指定できない。
  • 英大文字・英小文字は区別する。
注※
統合監視DBおよびIM構成管理DBが有効な場合に,比較キーワードが,「と一致する」「と一致しない」のとき,パス表記で業務グループ名を指定できます。
統合監視DBおよびIM構成管理DBが無効な場合,および[と一致する][と一致しない]以外を選択した場合,パス表記で業務グループ名を指定しても,ホスト名として扱われます。
jcoimdefコマンドの-ignorecasehostオプションの指定を「ON」にしている場合に,比較キーワードで[正規表現]以外を選択すると,文字列の英大文字・小文字を区別しません。

比較キーワード
比較キーワードには,「BEGIN(から始まる)」,「IN(と一致する)」,「NOTIN(と一致しない)」,「SUBSTR(を含む)」,「NOTSUBSTR(を含まない)」,「REGEX(正規表現)」,「TRANGE(時刻範囲)」,「DEFINED(属性有)」,「NOTDEFINED(属性無)」のどれか一つを指定できます。小文字と大文字で区別します。
比較キーワードに「TRANGE(時刻範囲)」を使用する場合,次の表に示すように指定します。

表2-27 TRANGEの指定形式

比較方法形式指定できる範囲
日時指定開始日時△終了日時開始日時≦属性値≦終了日時
期間指定分前基準時刻△-期間(分)MIN基準時刻-期間(分)≦属性値≦基準時刻
分後基準時刻△+期間(分)MIN基準時刻≦属性値≦基準時刻+期間(分)
時間前基準時刻△-期間(時)HOUR基準時刻-期間(時)≦属性値≦基準時刻
時間後基準時刻△+期間(時)HOUR基準時刻≦属性値≦基準時刻+期間(時)
日前基準時刻△-期間(日)DAY基準時刻-期間(日)≦属性値≦基準時刻
日後基準時刻△+期間(日)DAY基準時刻≦属性値≦基準時刻+期間(日)
(凡例)
△:半角スペース

開始日時,終了日時は,yyyyMMddHHmmss形式で指定してください。期間(分,時,日)は,数字で指定してください。MIN,HOUR,DAYは,大文字・小文字を区別します。
オペランド
比較キーワードで属性値と比較する値を文字列で指定します。小文字と大文字で区別します。
オペランドを複数指定する場合は,一つ以上の連続した半角スペースまたはタブをオペランドとオペランドの間に挿入して区切ります。オペランドとオペランドは,OR条件となります。ただし,正規表現を指定している場合は,複数指定できません。
オペランドに,半角スペース,タブ,改行コード(CR,LF)および%を指定したい場合,次のように記述します。また,これらの値は定義フォーマットの上限チェックの場合,1文字として扱います。
項番指定したい値指定方法
1タブ(0x09)%09
2半角スペース(0x20)%20
3%(0x25)%25
4改行コード LF(0x0a)%0a
5改行コード CR(0x0d)%0d

定義例

次の条件の場合に,2010/10/01~2010/10/31の毎週月曜~土曜10:00~12:00の期間でイベントを除外する定義例を示します。

DESC_VERSION=1
# コメント
def 共通除外条件群1
   cmt 期限:2010/10/31
   id 1
   valid true
   date 20101001-20101031
   week 1,2,3,4,5,6
   rtime 1000-1200
   cnd
       B.ID IN 00000001
       E.SEVERITY IN Emergency Alert
       B.SOURCESERVER REGEX host[0-9][0-9]
   end-cnd
end-def