esirecoveryinコマンドについて説明します。
機能説明
シーケンス定義にもとづくメディエーション機能の実行が、何らかの理由により失敗した場合、失敗時に出力されたリカバリメッセージをもとに対象のシーケンスを最初から実行します。
リカバリメッセージには、失敗時のシーケンス情報、ファンクション情報、履歴情報、ログ情報は含まれません。
Interstage Application Serverの“異常時のメッセージ退避機能”を利用したリトライが実行されます。リトライ回数＋1回連続して失敗した場合、リカバリメッセージがインバウンドリカバリキューに格納されます。
本コマンドが正常終了するとリカバリメッセージは削除されます。
形式
esirecoveryin [-q [JMSCorrelationID] | ファイル名]
オプション
オプション | 説明 |
|---|---|
-q | リカバリメッセージを再実行する場合に指定します。 |
ファイル名 |
オプション“-q”を省略した場合に指定します。通常は省略してください。
オプション“-q”を省略した場合に指定します。通常は省略してください。 |
JMSCorrelationID | オプション“-q”を指定した場合に指定します。通常は省略してください。 |
復帰値
復帰値 | 意味と対処 |
|---|---|
0 | 正常終了。 |
1 | JMSCorrelationID指定誤り。指定されたメッセージは存在していません。正しいJMSCorrelationIDを指定してください。 |
2 | ファイル名指定誤り。指定されたファイルは存在していません。正しいファイル名を指定してください。 |
9 | 異常終了。エラーメッセージから原因を特定し、再度実行してください。 |
注意事項
本コマンドは、管理者権限を所有するユーザ、またはInterstage運用者だけが実行できます。
本機能は、サービス提供側のサービスエンドポイントに“非同期”を使用している場合だけ、利用できます。“同期”の場合は、サービス利用側アプリケーションにおいて、メッセージ送受信APIの復帰値をもとに、再実行してください。
オプションのファイル名省略時は、“<INSDIR>\var\recovery\inbound”ディレクトリ配下のリカバリファイルがリカバリの対象になります。リカバリ対象がない場合でも復帰値は、“0(正常終了)”となります。
オプションのファイル名省略時は、“/opt/FJSVesi/var/recovery/inbound”ディレクトリ配下のリカバリファイルがリカバリの対象になります。リカバリ対象がない場合でも復帰値は、“0(正常終了)”となります。
オプションのJMSCorrelationID省略時は、インバウンドリカバリキューに格納されたメッセージがリカバリの対象になります。リカバリ対象がない場合でも復帰値は、“0(正常終了)”となります。
“-q”を指定した場合、最大100件のリカバリ処理が実行されます。リカバリメッセージが100件を超える場合は、本コマンドを繰り返し実行してください。
使用例
esirecoveryinコマンドの使用例を示します。この例では、シーケンスを最初から実行します。
esirecoveryin -q
