Hitachi

JP1 Version 11 JP1/Base 運用ガイド


jevsend

〈このページの構成〉

機能

イベントサーバにJP1イベントを登録します。

形式

jevsend [-i イベントID]
        [-m メッセージ]
        [[-e 拡張属性名=拡張属性値] ...]
        [-d 送信先イベントサーバ名]
        [-s 送信元イベントサーバ名]

実行権限

Windowsの場合:なし

UNIXの場合:なし

格納先ディレクトリ

Windowsの場合

インストール先フォルダ\bin\

UNIXの場合

/opt/jp1base/bin/

引数

-i イベントID

登録するJP1イベントのイベントIDを指定します。指定できる範囲は,0〜1FFF,7FFF8000〜7FFFFFFFです。このオプションを省略すると,0が仮定されます。

-m メッセージ

登録するJP1イベントのメッセージテキストを指定します。メッセージテキストは,1,023バイト以下の文字列で指定してください。

-e 拡張属性名=拡張属性値 ...

登録するJP1イベントの拡張属性を指定します。登録する拡張属性の設定は「-e 拡張属性名=拡張属性値」を1組として複数記述できます。「=」と拡張属性値の間には空白(スペースやタブなど)を入れないでください。拡張属性とは次に示す内容の100個までの集まりのことです。なお,すべての属性値の長さの合計が,10,000バイトに制限されます。

拡張属性

内容

形式

拡張属性名

属性の意味を表す名称

英数字またはアンダーライン(英字は大文字,先頭は英字)から成る32バイトまでの文字列

拡張属性値

属性の内容

文字列(0〜10,000バイト)

なお,拡張属性名にSEVERITYを指定したJP1イベントは,JP1/IM - Viewの[イベントコンソール]画面の一覧に表示されます。SEVERITYの拡張属性値は,「17.1.2 拡張属性」の項目「重大度」の内容の中から指定し,必ず先頭を大文字にしてください。

-d 送信先イベントサーバ名

JP1イベントを転送設定ファイル(forward)で指定されたイベントサーバに送信しないで,任意のイベントサーバに送信したい場合,送信先のイベントサーバ名を指定します。イベントサーバ名は255バイト以内の文字列で指定してください。

注意事項
  • 定義されていないイベントサーバ,起動されていないイベントサーバ,およびネットワークの障害などでイベントが届かないイベントサーバなどを指定してもエラーにはなりません。

  • このオプションを指定して送信したJP1イベントは,自ホストのイベントサーバからは取得できません。

  • このオプションを指定して,JP1イベントを他ホストのイベントサーバに送信する場合,イベントサーバ設定ファイル(conf)で設定したforward-limitパラメーターで指定したリトライの対象にはなりません。

  • -sに指定したイベントサーバ名(省略時に仮定されるイベントサーバ名を含みます)を指定しないでください。-sに指定したイベントサーバ名を指定すると無駄なイベント転送が発生するため,転送エラーでJP1イベントが登録されないリスクが高くなります。

-s 送信元イベントサーバ名

-dオプションを併用する場合は,転送のために使用するイベントサーバ名を指定します。-dオプションを指定しない場合は,イベントを登録するイベントサーバ名を指定します。指定できるイベントサーバは自ホストで稼働しているイベントサーバに限ります。このオプションを省略すると,環境変数JP1_HOSTNAMEに指定した論理ホスト名がイベントサーバ名として仮定されます。環境変数JP1_HOSTNAMEを指定していない場合,自ホスト名と同じイベントサーバ名が仮定されます。イベントサーバ名は255バイト以内の文字列で指定してください。

このオプションは,主にクラスタシステムで使用します。

注意事項

戻り値

0

正常終了

1

引数エラー

255

そのほかのエラー

使用例

(例1)

イベントIDが111,メッセージが"BaseEvent_Sample"のJP1イベントを登録します。

jevsend -m BaseEvent_Sample -i 111
(例2)

イベントIDが111,拡張属性名が"EXTATTR",拡張属性値が"Extend Value"を登録します。

jevsend -i 111 -e EXTATTR="Extend Value"
(例3)

次に示す拡張属性のJP1イベントを登録します。

  • 拡張属性名が"EXTATTR",拡張属性値が"extattr"

  • 拡張属性名が"INCLUDESPACE",拡張属性値が"include space"

jevsend -e EXTATTR=extattr -e INCLUDESPACE="include space"
(例4)

イベントIDが111,拡張属性名が"SEVERITY",拡張属性値が"Information"のJP1イベントを登録します。

jevsend -i 111 -e SEVERITY=Information