JP1/Integrated Management - Manager コマンド・定義ファイルリファレンス
機能
JP1/IM - Managerのイベント基盤サービス,インシデント登録サービス(JP1/IM - Incident Master連携機能),および相関イベント発行機能で有効となっているイベント取得フィルターを,指定したフィルターIDのイベント取得フィルターに切り替えるためのコマンドです。また,指定した共通除外条件を有効にすることもできます。
イベント取得フィルターのフィルターID,フィルター名,共通除外条件群の共通除外条件群ID,および共通除外条件群名を一覧で表示することもできます。
指定したホストのJP1/IM - Managerが起動していない場合,およびイベント取得フィルター(互換用)の場合は使用できません。
また,共通除外条件が拡張モードの場合に,次の操作を実行できます。
- 拡張モードの共通除外条件を,条件群単位で有効・無効に設定できる
- 共通除外条件定義ファイルを読み込み,拡張モードの共通除外条件の定義を一括で反映できる
- 共通除外条件定義ファイルを読み込み,拡張モードの共通除外条件の定義内容をチェックできる
形式1
jcochfilter [-i フィルターID] [-e [共通除外条件群ID[,共通除外条件群ID...]|ALL]] [-on 共通除外条件群ID[,共通除外条件群ID...]]※ [-off 共通除外条件群ID[,共通除外条件群ID...]]※ [-ef 共通除外条件拡張定義ファイル名]※ [-h 論理ホスト名]注※ 拡張モードの共通除外条件の場合に指定できます。
形式2
jcochfilter -check 共通除外条件拡張定義ファイル名
実行権限
Windowsの場合:Administrators権限(WindowsのUAC機能が有効な場合は管理者コンソールから実行)
UNIXの場合:スーパーユーザー権限
格納先ディレクトリ
- Windowsの場合
Consoleパス\bin\
- UNIXの場合
/opt/jp1cons/bin/
引数
-i フィルターID
切り替えて使用するイベント取得フィルターのフィルターIDを指定します。
このオプションは,-efおよび-checkオプションと同時に指定できません。
-e [共通除外条件群ID,共通除外条件群ID...]|ALL
有効にしたい共通除外条件群のIDを指定します。指定しなかったIDの共通除外条件は無効になります。複数指定する場合は,コンマで区切ります。すべての共通除外条件を有効にしたい場合は,ALLを指定します。なお,-eのあとに何も指定しなかった場合は,すべての共通除外条件が無効になります。このオプションと同時に指定できるのは,-iおよび-hオプションだけです。
-on 共通除外条件群ID[,共通除外条件群ID...]
有効にしたい拡張モードの共通除外条件のIDを指定します。このオプションは,共通除外条件が拡張モードの場合に設定できます。拡張モードの共通除外条件のIDを複数指定する場合は,コンマで区切ります。指定できる共通除外条件群IDの範囲は,0〜1,023です。このオプションは,-e,-ef,および-checkオプションと同時に指定できません。
-off 共通除外条件群ID[,共通除外条件群ID...]
無効にしたい拡張モードの共通除外条件のIDを指定します。このオプションは,共通除外条件が拡張モードの場合に設定できます。拡張モードの共通除外条件のIDを複数指定する場合は,コンマで区切ります。指定できる共通除外条件群IDの範囲は,0〜1,023です。このオプションは,-e,-ef,および-checkオプションと同時に指定できません。
-ef 共通除外条件拡張定義ファイル名
JP1/IM - Managerに反映したい共通除外条件拡張定義ファイル名を,相対パスまたは絶対パス形式で指定します。このオプションは,共通除外条件が拡張モードの場合に設定できます。このオプションを指定すると,共通除外条件拡張定義ファイルに記載されている拡張モードの共通除外条件の定義内容をJP1/IM - Managerに一括で反映できます。このオプションと同時に指定できるのは,-hオプションだけです。
-check 共通除外条件拡張定義ファイル名
共通除外条件拡張定義ファイルに記載されている拡張モードの共通除外条件の定義内容が正しいかどうかをチェックするオプションです。
JP1/IM - Managerに反映したい共通除外条件拡張定義ファイル名を,相対パスまたは絶対パス形式で指定します。このオプションは,ほかのオプションと同時に指定できません。
-h 論理ホスト名
クラスタシステムで運用している場合に,論理ホスト名を指定します。このオプションを省略した場合,環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合,物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。このオプションは,-checkオプションと同時に指定できません。
注意事項
- -h以外のオプションを指定しなかった場合,次の内容を一覧で表示します。
- 適用中のイベント取得フィルターのフィルターIDとフィルター名
- 適用中の共通除外条件群IDと共通除外条件群名
- 設定されているイベント取得フィルターのフィルターIDとフィルター名
- 設定されている共通除外条件群IDと共通除外条件群名
- 共通除外条件の動作モードが拡張モードの場合,拡張モードの共通除外条件のIDと共通除外条件群名
- 指定したホストのJP1/IM - Managerが起動していない場合,およびイベント取得フィルターが互換用の場合は,jcochfilterコマンドは実行できません。
- このコマンドを複数同時に実行しないでください。複数同時に実行した場合,あとに実行したコマンドが失敗する場合があります。
戻り値
0 正常終了 1 引数エラー 2 JP1/IM - Manager(JP1/IM - Central Console)と接続できない(通信エラー) 3 JP1/IM - Managerの起動状態が確認できない 4 一定時間内にJP1/IM - Managerからの応答がない 5 イベント取得フィルターが互換用で動作している 6 JP1/IM - Managerからのエラー 7 -iオプションで指定したフィルターIDが存在しない 8 jcochfilterコマンドの実行権限がない(Windows限定) 9 イベント取得フィルターの最大長を超えている 10 -eオプションで指定した共通除外条件が存在しない 255 その他のエラー
使用例1
論理ホストhostA上のイベント取得フィルターの一覧を表示する場合
jcochfilter -h hostA
使用例2
論理ホストhostA上のイベント取得フィルターをフィルターIDが3のフィルターに変更する場合
jcochfilter -i 3 -h hostA
使用例3
論理ホストhostA上のイベント取得フィルターの共通除外条件群(ID:0,2)を有効にし,それ以外を無効にする場合
jcochfilter -e 0,2 -h hostA
All Rights Reserved. Copyright (C) 2009, 2011, Hitachi, Ltd.