ewallevent コマンド

目的

ログインしているすべてのユーザーにイベントまたはリアーム・イベントをブロードキャストします。

構文

ewallevent [-c] [-h]

説明

ewallevent スクリプトは、イベントまたはリアーム・イベントが発生したときに、そのイベントまたはリアーム・イベントに関するメッセージを、現在ホストにログインしているすべてのユーザーにブロードキャストします。イベントまたはリアーム・イベントの情報は、イベントまたはリアーム・イベントが発生すると、イベント応答リソース・マネージャーから生成される環境変数で、イベント応答リソース・マネージャーによって収集され、追加されます。このスクリプトは、イベント応答リソースによって実行されるアクションとして使用できます。また、その他のユーザー定義アクションを作成するためのテンプレートとしても使用できます。このスクリプトは常に、メッセージを英語で戻します。

メッセージは、このスクリプトが応答アクションであるイベントまたはリアーム・イベントが発生したときにログインしていたすべてのユーザーのコンソールに、次のフォーマットで表示されます。

Broadcast message from user@host (tty) at hh:mm:ss...

severity event_type occurred for Condition condition_name
on the resource resource_name of resource_class_name at hh:mm:ss mm/dd/yy
The resource was monitored on node_name and resided on {node_names}.

ERRM 環境変数に関するイベント情報が戻されます。また、イベント情報には以下も含まれます。

Local Time: このイベントまたはリアーム・イベントが監視される時刻。 ERRM が提供する実際の環境変数は ERRM_TIME です。この値は表示前にローカライズされ、読み取り可能な形式に変換されます。

このスクリプトは、環境変数の値を取り込み、 wall コマンドを使用して、現在ログインしているユーザー・コンソールにメッセージを書き込みます。

フラグ

-c: ERRM イベントの ERRM_VALUE をブロードキャストするように ewallevent に指示します。 -c フラグを指定すると、 ewallevent は SNMP トラップ・メッセージをブロードキャストします。
-h: スクリプトの使用方法の文を標準出力に書き込みます。

パラメーター

log_file

イベント情報を記録する先のファイルの名前を指定します。 log_file パラメーターの絶対パスを指定する必要があります。

log_file は循環ログとして扱われ、64KB の固定サイズを持ちます。 log_file がいっぱいになると、既存の最も古いエントリー上に新しいエントリーが上書きされます。

log_file が既存の場合は、イベント情報はこのファイルに付加されます。 log_file が存在しない場合は作成され、イベント情報を書き込めるようにします。

終了状況

0: スクリプトが正常に実行されました。
1: スクリプトの実行時にエラーが発生しました。

制約事項

このスクリプトは、ERRM が稼働中のノードで実行しなければなりません。
wall コマンドは、現在ログインしているユーザー・コンソールにメッセージを書き込むために使用します。 wall コマンドについて詳しくは、 wall のマニュアル・ページを参照してください。

標準出力

-h フラグを指定すると、スクリプトの使用法ステートメントが標準出力に書き込まれます。

例

ewallevent スクリプトがクリティカル通知応答の事前定義アクションであり、リソース /varの /var space used 条件に関連付けられているとします。この条件に定義されたイベント式のしきい値に達すると、イベントが発生します。クリティカル通知の応答が行われ、 ewallevent が実行されます。ログインしているすべてのユーザーのコンソールに、次のメッセージが表示されます。
```
Broadcast message from joe@neverland.com (pts/6) at 18:42:03...
 
Critical event occurred for Condition /var space used 
on the resource /var of filesys of IBM.FileSystem at 18:41:50 03/28/02
The resource was monitored on c174n05 and resided on {c174n05}.
```

リソース /varの /var space used 条件に対してリアーム・イベントが発生すると、ログインしているすべてのユーザーのコンソールに以下のメッセージが表示されます。

Broadcast message from joe@neverland.com (pts/6) at 18:42:03...
 
Critical rearm event occurred for Condition /var space used 
on the resource /var of filesys of IBM.FileSystem at 18:41:50 03/28/02
The resource was monitored on c174n05 and resided on {c174n05}.

場所

/opt/rsct/bin/ewallevent