hdestop(抽出側Datareplicatorの終了)
機能
抽出側Datareplicatorを強制終了モードで終了します。正常終了モードで終了する場合には,抽出システム定義のsynctermオペランドにtrueを設定します。
形式
hdestop 〔 -t sendterm 〕 〔 -e 〕 〔 -s〔 送信先識別子〔{{,送信先識別子 }}…〕〕〕 〔 -w 〕
オプション
-
-t sendterm
送信処理を停止する場合に,強制的に処理を打ち切って停止するときに指定します。このオプションは,送信処理が稼働中で,かつ稼働中の送信処理の停止を指示するオプション指定の場合(-e 及び -sオプションのどちらの指定もないとき,又は-sオプションの指定があるとき)にだけ有効になります。
-tオプションを省略すると,抽出側Datareplicatorは,送信間隔中に抽出情報キューファイルから読み込んだ更新情報を送信し終わってから,送信処理を停止します。
-
-e
HiRDBシステムログファイルからの更新情報の抽出処理だけを停止するときに指定します。
-
送信先への送信処理だけを停止するときに指定します。
-
送信先識別子
特定の送信先識別子の送信処理だけを停止するときに,抽出システム定義で指定した送信先識別子を指定します。複数の送信先識別子を指定する場合には,送信先識別子と送信先識別子の間に,空白を入力しないでください。送信先識別子に**を指定した場合は,引数不正エラーとなります。
送信先識別子を省略すると,すべての送信先識別子への送信処理が終了します。
-
-
-w
抽出側Datareplicatorのマスタプロセスが停止するまで待った後で,hdestopコマンドの処理を終了するときに指定します。
計画系切り替えで使用するDatareplicator停止シェルを使用するときのようにDatareplicator本体が完全に停止するのを待ってコマンドを終了させる必要がある場合に,このオプションを指定してください。
-wオプションなしのときは,hdestopコマンドはマスタプロセスに停止要求を送信完了すると終了します(マスタプロセスはコマンドと非同期に終了します)。
-wオプションありのときは,hdestopコマンドはマスタプロセスに停止要求を送信完了後,マスタプロセスの終了まで待ってから終了します(コマンド終了時には,マスタプロセスも終了しています)。
hdestopコマンドにオプションを複数付けるときに使える組み合わせを次に示します。
hdestopコマンド
のオプション
-t
-e
-s
-w
-t
×
○
○
○
-e
○
×
○
×
-s
○
○
×
×
-w
○
×
×
×
- (凡例)
-
○:オプションを組み合わせて実行できます。
×:オプションを組み合わせて実行できません(エラーメッセージが出力されます)。
規則
-
抽出側Datareplicatorの終了方法には,抽出側HiRDBの正常終了に連動して自動的に終了する方法と,hdestopコマンドによって終了する方法の2種類があります。抽出側Datareplicatorの終了方法と終了モードとの関係を次の表に示します。
表7‒9 抽出側Datareplicatorの終了方法と終了モードとの関係 終了方法
終了モード
終了時の動作内容
抽出側HiRDBの正常終了に連動した終了
正常終了
次の条件をすべて満たした時点で,抽出側Datareplicatorが終了します。
-
抽出側HiRDBの正常終了を検知しました。
-
検知した正常終了の後に,抽出側HiRDBでのトランザクションが発生していません。
-
抽出プロセスが正常に稼働し,システムログファイルのすべての更新情報の,抽出情報キューファイルへの抽出が完了しています。
-
送信プロセスが正常に稼働し,抽出情報キューファイルのすべての更新情報の,反映側システムへの送信が完了している(送信遅延開始の場合は,抽出プロセスが抽出側HiRDBの正常終了を検知する前に,送信プロセスを開始しないと,抽出情報キューファイルの更新情報は送信されない)抽出側HiRDBの正常終了に連動して抽出側Datareplicatorを終了する場合には,抽出システム定義のsynctermオペランドをtrueに設定する必要があります。
hdestopコマンドの実行
強制終了
hdestopコマンドを実行した時点で実行中の抽出と送信が完了してから,抽出側Datareplicatorが終了します。
-
-
抽出システム定義のsynctermオペランドをtrueと設定している場合にhdestopコマンドを実行すると,抽出側Datareplicatorはhdestopコマンドに従い,強制終了モードで終了します。
-
hdestopコマンドは,抽出側Datareplicatorが稼働中のときだけ実行できます。抽出側Datareplicatorが稼働中以外のときにhdestopコマンドを実行すると,エラーになります。
-
hdestopコマンドを実行後,正常終了すると0が返されます。異常終了すると1が返されます。
注意
-
既に停止状態の抽出処理又は送信処理に対して停止要求があった場合,停止処理は実行されないで,稼働中の抽出処理又は送信処理に対してだけ停止処理が実行されます。なお,この場合hdestopコマンドは正常終了することとします(ただし,既に停止状態であった内容をエラー情報ファイルに出力します)。
-
抽出処理又は送信処理の個別停止を繰り返し実行した結果,すべての抽出処理及び送信処理が停止した場合は,抽出側Datareplicatorを停止します。
-
抽出システム定義のsendcontrolオペランドでsendmstを指定して,特定の送信先だけの個別停止をした場合,hdestopコマンドの受け付け時点で対象外の送信先に対する送信間隔が打ち切られ,送信処理を開始します。
-
抽出システム定義のnodecontrolオペランドでのserver指定時,抽出ノードマスタプロセスが稼働中でかつ抽出マスタプロセスが停止中の場合,hdestopコマンドはKFRB04411-Eメッセージを出力しエラー終了します。稼働中の抽出ノードマスタプロセスは停止しません。