jcochstat

機能

重要イベントの対処状況を示す情報を変更します。

このコマンドは，-hで指定したホストのイベントDBにアクセスし，-nで指定した通し番号のJP1イベントの重要イベント対処状況を変更します。

対処状況を変更すると，同じマネージャーにログインしているほかのJP1/IM - Viewでも対処状況の表示が変更されます。対処状況を変更するJP1イベントがほかのホストから転送されてきた場合やほかのホストに転送する設定がされている場合，転送元および転送先のホストでの対処状況は変更されません。

なお，このコマンドを使えば，［イベントコンソール］画面の［重要イベント］ページに表示されていないJP1イベントの対処状況も変更できますが，この場合，その変更を確認するには次の方法を取る必要があります。

• 対処状況を変更したJP1イベントが［イベントコンソール］画面の［イベント監視］ページに表示されている場合：［イベント監視］ページで確認する。

• 対処状況を変更したJP1イベントが［イベントコンソール］画面の［イベント監視］ページに表示されていない場合：イベント検索で確認する。

このコマンドは，JP1/IM - Managerが稼働する環境で使用できます。

ページの先頭へ

形式

jcochstat [-h マネージャーホスト名]
          {-k 重要イベント対処状況キー | -d | 
           -k 重要イベント対処状況キー -d}
           -n イベントDB内通し番号1[,...,イベントDB内通し番号100]

ページの先頭へ

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：なし

ページの先頭へ

格納先ディレクトリ

Windowsの場合

Consoleパス\bin\

UNIXの場合

/opt/jp1cons/bin/

ページの先頭へ

引数

-h マネージャーホスト名

重要イベントが登録されているイベントDBがあるマネージャーを指定します。ホスト名，ドメイン名，およびIPv4アドレスを指定できます。このオプションを省略した場合は，自ホストを仮定します。クラスタシステムでの運用時に，このオプションを省略した場合は，コマンドを実行した物理ホスト名を仮定します。指定したマネージャー上のJP1/IM - Managerが起動していないと，エラーになります。

マネージャーホスト名は255文字以内の文字列で指定してください。

なお，マネージャーホスト名に他ホストのマネージャーを指定する機能は，バージョン6互換用です。

-k 重要イベント対処状況キー

重要イベントの対処状況を表すキー値を入力します。-nオプションで指定した重要イベントの対処状況が，指定したキーが示す対処状況に変更されます。また，JP1/IM - Viewで表示した場合，対処状況マークが変更されます。

重要イベント対処状況キーは大文字と小文字を区別します。

-kオプションと-dオプションは，どちらか一方または両方を指定してください。-kオプションと-dオプションを両方指定した場合は，対処状況を変更したあと，JP1/IM - Viewの画面からイベントを削除します。-kオプションと-dオプションは同時に省略できません。

表1‒30　重要イベント対処状況キー

キー値	対処状況	JP1/IM - Viewに表示される対処状況マーク
PROCESSED	対処済
PROCESSING	処理中
HELD	保留
UNPROCESSED	未対処	（無印）

-d

-nオプションで指定した重要イベントを［イベントコンソール］画面の［重要イベント］ページから削除します。イベントDBからは削除されません。

削除したイベントを［重要イベント］ページに再度表示することはできません。

-kオプションと-dオプションは，どちらか一方または両方を指定してください。

-kオプションと-dオプションを両方指定した場合は，対処状況を変更したあと，［イベントコンソール］画面の［重要イベント］ページからイベントを削除します。-kオプションと-dオプションは同時に省略できません。

-n イベントDB内通し番号

対処状況を変更したい重要イベントのイベントDB内通し番号を指定します。このオプションは省略できません。

イベントDB内通し番号は，最大100個指定できます。複数指定する場合は，通し番号と通し番号の間をコンマで区切ります。コンマの前後に空白を指定できません。

指定できる値は，0〜2,147,483,647の10進数整数です。

ページの先頭へ

注意事項

jcochstatコマンドを大量に同時実行すると，マネージャーの性能が低下したり，タイムアウトが発生したりすることがあります。

例えば，自動アクションからjcochstatコマンドを実行すると，jcochstatコマンドの処理に時間がかかった場合に，自動アクションの処理が遅延したり，自動アクションを実行できなくなったりすることがあるため，自動アクションなどからjcochstatコマンドを実行することは推奨しません。jcochstatコマンドの実行を運用に組み込む場合は，jcochstatコマンドの実行性能とマネージャーの性能への影響が，運用要件上問題ないかを十分に検証した上で使用してください。

ページの先頭へ

戻り値

0	正常終了
1	引数エラー
2	ネットワーク障害
3	イベントDBの更新に失敗した
4	指定できないキーを指定している
5	更新できないイベントを指定した
7	コマンドを実行する権限がない（Windowsの場合）
255	その他のエラー

ページの先頭へ

使用例

マネージャーhost01上のイベントDBに登録されている，イベントDB内通し番号が35のイベントおよび400のイベントを，対処状況を対処済に変更したあと，画面から削除します。

jcochstat -h host01 -k PROCESSED -n 35,400 -d

ページの先頭へ