10.2.2 HADBサーバの終了方法
HADBサーバを終了する場合,adbstopコマンドを実行してください。HADBサーバが終了します。
次のとおりにコマンドを実行してください。
adbstop※
- 注※
-
adbstopコマンド実行時にオプションを指定すると,HADBサーバの終了モードを変更できます。詳細については,「(1) HADBサーバの終了モード」および「(2) オプションの指定と正常終了の種類」を参照してください。
- 重要
-
HADBサーバに接続中のAPまたはコマンドがある場合,adbstopコマンドを実行してもHADBサーバを終了できません。
(1) HADBサーバの終了モード
HADBサーバには,次に示す終了モードがあります。終了モードによって,adbstopコマンドに指定するオプションが異なります。
項番 |
終了モード |
実行するコマンドおよびオプション |
説明 |
---|---|---|---|
1 |
正常終了 |
adbstop |
通常の終了モードです。 正常終了には4種類あり,指定するオプションによって終了処理が異なります。詳細については,「(2) オプションの指定と正常終了の種類」を参照してください。 |
2 |
強制終了 |
adbstop --force |
処理中のトランザクションの完了を待たないで,HADBサーバが終了します。 adbstop --forceコマンドを実行すると,新規のコネクション確立要求を受け付けなくなります。 処理中のトランザクションは,HADBサーバを再開始したときに回復処理の対象となります。 |
3 |
異常終了 |
− |
何らかの異常によって,HADBサーバが終了する場合の終了モードです。 処理中のトランザクションの完了を待たないで,HADBサーバは終了します。 処理中のトランザクションは,HADBサーバを再開始したときに回復処理の対象となります。 |
- (凡例)
-
−:実行するコマンドはありません。
(2) オプションの指定と正常終了の種類
adbstopコマンドに指定するオプションによって,正常終了時の処理が異なります。adbstopコマンドに指定するオプションと正常終了の種類を次の表に示します。
adbstopコマンドのオプションの指定形式については,マニュアルHADB コマンドリファレンスのadbstop(HADBサーバの終了)を参照してください。
項番 |
実行するコマンドおよびオプション |
説明 |
---|---|---|
1 |
adbstop |
adbstopコマンド(オプション指定なし)を実行すると,HADBサーバに接続中のAPおよび実行中のコマンドがない場合に,HADBサーバを終了します。
|
2 |
adbstop --wait connection |
adbstop --wait connectionコマンドを実行すると,次の処理を待ってから,HADBサーバを終了します。
|
3 |
adbstop --wait transaction |
adbstop --wait transactionコマンドを実行すると,処理中のトランザクションの完了,および実行中のコマンドの終了を待ってから,HADBサーバが終了します。
|
4 |
adbstop --cancel |
adbstop --cancelコマンドを実行すると,処理中のトランザクションおよび実行中のコマンドをキャンセルして,HADBサーバを終了します。
|
- ■終了待機状態とは
-
終了待機状態とは,HADBサーバが次の処理を待っている状態のことです。
-
HADBサーバに接続中のAPの,HADBサーバからの切り離し
-
実行中のコマンドの終了
-
処理中のトランザクションの完了
adbstop --wait connectionコマンドおよびadbstop --wait transactionコマンドを実行したときだけ,HADBサーバは終了待機状態になります。終了待機状態には待ち時間があり,adbstopコマンドの-tオプションで指定できます。-tオプションを省略した場合は,デフォルトの待ち時間が適用されます。
-
- ■終了待機状態の待ち時間
-
終了待機状態の待ち時間内に,HADBサーバに接続中のAPがHADBサーバから切り離されなかったり,実行中のコマンドが終了しなかったり,処理中のトランザクションが完了しなかったりして,終了待機状態の待ち時間を超えた(タイムアウトした)場合は,HADBサーバは終了しません。この場合は,KFAA91152-Eメッセージが出力されるため,メッセージを参照して,エラー要因を取り除いてください。
なお,終了待機状態の待ち時間を超えた(タイムアウトした)場合,HADBサーバは,新規のコネクション確立要求および新規のトランザクション開始要求を受け付けられるようになります。
- ■終了待機状態の確認方法
-
HADBサーバが終了待機状態かどうかは,adbls -d srvコマンドで確認できます。出力項目「STATUS」の表示が"STOPWAIT"であれば,HADBサーバは終了待機状態となっています。
終了待機状態をキャンセルしたい場合は,OSのkillコマンドでadbstopコマンドのプロセスを終了させてください。終了待機状態をキャンセルできます。
終了待機状態がキャンセルされた場合,HADBサーバは,新規のコネクション確立要求および新規のトランザクション開始要求を受け付けられるようになります。
adbls -d srvコマンドについては,マニュアルHADB コマンドリファレンスのadbls -d srv(HADBサーバの状態表示)を参照してください。
(3) 終了処理完了の確認
HADBサーバの終了処理の完了を確認する場合,adbstopコマンドのリターンコードを確認してください。
-
リターンコードが0の場合
終了処理が正常終了しました。
-
リターンコードが4の場合
終了処理は終了しましたが,警告メッセージが出力されています。
HADBサーバは終了しています。表示されたメッセージ,またはメッセージログファイルに出力されたメッセージを確認して対処してください。
-
リターンコードが8の場合
終了処理が異常終了しました。HADBサーバの終了処理中にエラーが発生しています。表示されたメッセージ,またはメッセージログファイルに出力されたメッセージを確認して対処してください。