jevsendd

〈このページの構成〉

機能
形式
実行権限
格納先ディレクトリ
引数
注意事項
戻り値

機能

イベントサーバにJP1イベントを登録し，登録に成功したかどうかを確認できます。イベントサービスが起動しているのにJP1イベントが登録されない場合などに実行して，登録を確認できます。

形式

jevsendd [-i イベントID]
         [-m メッセージ]
         [[-e 拡張属性名=拡張属性値] ...]
         -d 送信先イベントサーバ名
         [-s 送信元イベントサーバ名]
         [-f 初期ポーリング間隔(秒)]
         [-p ポーリング間隔(秒)]
         [-t 確認回数]

ページの先頭へ

実行権限

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 送信先イベントサーバ名

送信先のイベントサーバ名を指定します。イベントサーバ名は255バイト以内の文字列で指定してください。

注意事項

このオプションを指定して送信したJP1イベントは，自ホストのイベントサーバからは取得できません。
このオプションを指定して，JP1イベントを他ホストのイベントサーバに送信する場合，イベントサーバ設定ファイル（conf）で設定したforward-limitパラメーターの指定によるリトライの対象にはなりません。
-sに指定したイベントサーバ名（省略時に仮定されるイベントサーバ名を含みます）を指定しないでください。-sに指定したイベントサーバ名を指定すると無駄なイベント転送が発生するため，転送エラーでJP1イベントが登録されないリスクが高くなります。

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

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

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

-f 初期ポーリング間隔(秒)

JP1イベントを送信先イベントサーバへ送信してから最初の到達確認までの待ち時間を1〜10秒で指定します。このオプションを省略すると，3秒が仮定されます。

-p ポーリング間隔(秒)

初回の到達確認でJP1イベントが到達していなかった場合，2回目以降の到達確認をする間隔を3〜600秒で指定します。このオプションを省略すると，10秒が仮定されます。

-t 確認回数

2回目以降の到達確認の確認回数を0〜999で指定します。このオプションを省略すると，6が仮定されます。

ページの先頭へ

注意事項

オプションと値の間には1個以上の半角のスペースを入れてください。
メッセージテキスト，拡張属性値の途中にスペースを入れる場合は，ダブルクォーテーションマーク（"）で囲んで指定してください。
ダブルクォーテーションマーク（"）の前に円記号を付けた場合（\"），ダブルクォーテーションマークとして解釈されます。
次に示す特殊文字を含む場合，ダブルクォーテーションマーク（"）で囲む必要があります。

# ; | & ( ) ^ < > スペースタブ
コマンドのオプションで指定できるバイト数は，OSの制限に依存しますので，各OSの制限内で設定してください。
UNIXシステムで，メッセージまたは拡張属性に日本語の非ASCII文字を含める場合，LANG環境変数に，使用する文字コードを表す正しい値を設定しておいてください。
このコマンドは，到達確認がされるか，エラーを検知するまで制御を返しません。

ページの先頭へ

戻り値

0	正常終了
1	引数エラー
2	処理は続行中（最大到達待ち時間内に到達確認ができなかった場合）
3	転送に失敗した
255	そのほかのエラー

補足事項

-f，-p，-tオプションを指定した場合の動作を次の図に示します。

図15‒3　`-f，-p，-t`オプションを指定した場合の動作

最大到達待ち時間は，次の式で求まります。

最大到達待ち時間 = -fで指定した秒数 + -pで指定した秒数 × -tで指定した回数

最大到達待ち時間内に到達確認ができなかった場合，エラーメッセージを出力して終了します。

ページの先頭へ