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"の拡張属性値は，「14.1.2　拡張属性」の項目「重大度」の内容の中から指定し，必ず先頭を大文字にしてください。

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

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

注意事項

• 定義されていないイベントサーバ，起動されていないイベントサーバ，およびネットワークの障害などでイベントが届かないイベントサーバなどを指定してもエラーにはなりません。
• このオプションを指定して送信したJP1イベントは自ホストのイベントサーバからは，取得できません。
• このオプションを指定して，JP1イベントを他ホストのイベントサーバに送信する場合，イベントサーバ設定ファイルで設定したforward-limitパラメーターの指定によるリトライの対象にはなりません。

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

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

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

注意事項

• オプションと値の間には1個以上の半角のスペースを入れてください。
• メッセージテキスト，拡張属性値の途中にスペースを入れる場合は，ダブルクォーテーションマーク（"）で囲んで指定してください。
• コマンドのオプションで指定できるバイト数は，OSの制限に依存しますので，各OSの制限内で設定してください。
• UNIXシステムで，メッセージまたは拡張属性に日本語の非ASCII文字を含める場合，LANG環境変数に，使用する文字コードを表す正しい値を設定しておいてください。

戻り値

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

[目次][前へ][次へ]

All Rights Reserved. Copyright (C) 2006, 2008, Hitachi, Ltd.