機能
JP1/IM - Managerの共通除外条件の動作モードを変更するコマンドです。このコマンドを実行すると,共通除外条件を基本モードから拡張モードに変更したり,拡張モードから基本モードに変更したりできます。共通除外条件を拡張モードに変更すると,正規表現の種類が,拡張正規表現に変更されます。
-mオプションを指定してこのコマンドを実行する場合は,JP1/IM - Managerが停止している必要があります。停止していないときに実行すると,エラー終了し,メッセージが表示されます。
また,このコマンドは複数を同時に実行できません。
なお,共通除外条件がすでに設定されている場合でも共通除外条件を拡張モードに変更できます。
次の場合に共通除外条件拡張定義ファイルのバックアップファイルがcommon_exclude_filter_backup.confとして出力されます。
バックアップファイルの出力先を次に示します。
Consoleパス¥conf¥console¥filter¥
共有フォルダ¥jp1cons¥conf¥console¥filter¥
/etc/opt/jp1cons/conf/console/filter/
共有ディレクトリ/jp1cons/conf/console/filter/
拡張モードで使用できない正規表現があった場合,エラーメッセージが表示され,拡張モードの共通除外条件が設定されていない状態になります。出力されたファイルを編集し直して,jcochfilterコマンドの-efオプションでJP1/IM - Managerに反映してください。
共通除外条件拡張定義ファイルについては,「共通除外条件拡張定義ファイル」(2. 定義ファイル)を参照してください。
jcochfilterコマンドについては,「jcochfilter」(1. コマンド)を参照してください。
形式
jcochcefmode [-m {normal | extended}]
[-h 論理ホスト名]
実行権限
Windowsの場合:Administrators権限(WindowsのUAC機能が有効な場合は管理者コンソールから実行)
UNIXの場合:スーパーユーザー権限
格納先ディレクトリ
Consoleパス¥bin¥
/opt/jp1cons/bin/
引数
-m {normal | extended}
共通除外条件の動作モードを指定します。
normalまたはextendedは大文字・小文字を区別しません。
-h 論理ホスト名
クラスタシステムで運用している場合に,論理ホスト名を指定します。指定した論理ホストに対応する動作モードを,JP1/IM - Managerの共通除外条件に設定します。このオプションを省略した場合,環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合,物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。
環境変数JP1_HOSTNAMEにJP1_DEFAULTや存在しない論理ホストを設定した場合,エラーメッセージが表示されます。
注意事項
戻り値
0 | 正常終了 |
1 | 異常終了 |
2 | 引数エラー |
3 | JP1/IM - Managerが起動している |
4 | 拡張モードの前提条件を満たしていない,またはイベント取得フィルターが互換用で動作している |
5 | 拡張モードの前提条件を満たしていない,またはJP1/Baseの正規表現が拡張されていない |
6 | 現在の動作モードと同じ動作モードを指定している |
7 | jcochcefmodeコマンドの実行権限がない(Windows限定) |
8 | 共通除外条件拡張定義ファイルのバックアップに失敗した |
9 | 論理ホストの指定が不正である |
10 | 同時実行エラー |
255 | その他のエラー |
使用例1
jcochcefmode -m normal
KAVB1005-I コマンド(jcochcefmode)を開始しました
KAVB0896-I 共通除外条件の動作モードを基本モードに変更しました
KAVB1002-I コマンド(jcochcefmode)が正常終了しました
使用例2
jcochcefmode -m extended
KAVB1005-I コマンド(jcochcefmode)を開始しました
KAVB0896-I 共通除外条件の動作モードを拡張モードに変更しました
KAVB1002-I コマンド(jcochcefmode)が正常終了しました
使用例3
jcochcefmode
KAVB1005-I コマンド(jcochcefmode)を開始しました
KAVB0894-I 共通除外条件の動作モードを表示します(ホスト名:hostA)
動作モード : 拡張モード
KAVB1002-I コマンド(jcochcefmode)が正常終了しました