J2EEアプリケーションの停止

ここでは，サーバ管理コマンドを使用してJ2EEアプリケーションを停止する方法について説明します。

サーバ管理コマンドを使用したJ2EEアプリケーションの停止には，次の五つの方法があります。

デフォルトのタイムアウト時間で通常停止を実行する
任意のタイムアウト時間を設定して通常停止を実行する
デフォルトのタイムアウト時間で通常停止を実行して，停止しなかった場合に強制停止を実行する
任意のタイムアウト時間を設定して通常停止を実行して，停止しなかった場合に強制停止を実行する
任意のタイムアウト時間を設定して通常停止を実行して，停止しなかった場合に自動的に強制停止を実行する

これらの方法以外の順序でコマンドを実行した場合，コマンドが異常終了します。例えば，通常停止をしない状態では，強制停止の形式でコマンドを実行できません。

また，1.，2.，または5.の処理は，一つのJ2EEアプリケーションに対してどれか1回だけ実行できます。

ただし，強制停止は，J2EEサーバの動作設定をカスタマイズして，強制停止が有効になるように設定されているシステムだけで実行できます。J2EEサーバの動作設定のカスタマイズの方法については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

J2EEアプリケーションの停止処理では，次の処理が実行されます。

J2EEアプリケーションのフロントがWebアプリケーションの場合

新規リクエストを受け付けなくなります。
処理中のリクエストは引き続き処理されます。
Webアプリケーションの同時実行数制御のキューに格納されているリクエストのうち，Webコンテナでの処理が開始されていないものに対して，HTTP503エラーが返却されます。

J2EEアプリケーションのフロントがEnterprise Beanの場合

新規リクエストを受け付けなくなります。
処理中のリクエストは引き続き処理されます。

停止後のアプリケーションに含まれているEnterprise Beanのメソッドの呼び出しはできません。停止後のアプリケーションに含まれているEnterprise Beanのメソッドを呼び出そうとすると，「stop could not lock <文字列>」というメッセージがJ2EEサーバの標準エラー出力に出力されることがありますが，問題ありません。

次に，それぞれのパターンについて，サーバ管理コマンドの実行手順を説明します。

＜この項の構成＞: (1)　デフォルトのタイムアウト時間で通常停止を実行する; (2)　任意のタイムアウト時間を設定して通常停止を実行する; (3)　デフォルトのタイムアウト時間で通常停止を実行して，停止しなかった場合に強制停止を実行する; (4)　任意のタイムアウト時間を設定して通常停止を実行して，停止しなかった場合に強制停止を実行する; (5)　任意のタイムアウト時間を設定して通常停止を実行して，停止しなかった場合に自動的に強制停止を実行する

(1)　デフォルトのタイムアウト時間で通常停止を実行する

コマンドの実行手順，実行形式および実行例を次に示します。

J2EEアプリケーションを通常停止します。
cjstopappコマンドを実行します。
実行形式
　 cjstopapp <J2EEサーバ名> -name <J2EEアプリケーション名> 　
実行例

cjstopapp Myserver -name App1

　

なお，デフォルトのタイムアウト時間でコマンドを実行した場合，停止処理が完了しなくても60秒後にコマンドの制御が戻ります。

コマンドの制御がタイムアウトによって戻った場合は，J2EEアプリケーションの停止状態を確認します。
タイムアウトによってコマンドの制御が戻った場合，J2EEアプリケーションの停止処理は完了していないことがあります。このため，タイムアウトが発生した場合は，J2EEアプリケーションの状態を確認してください。
J2EEアプリケーションの状態は，サーバ管理コマンドのcjlistappコマンド実行して確認します。

実行形式

　
cjlistapp <サーバ名称>

実行例: cjlistapp MyServer;

J2EEアプリケーションの状態として，次のどれかの状態が出力されます。

表4-15　J2EEアプリケーションの状態

出力される文字列	状態の意味
running	開始状態
stopped	停止状態
stopFailure	通常停止失敗状態
forceStopFailure	強制停止失敗状態
blockadeFailure	閉塞失敗状態
blockading	閉塞中
blockaded	閉塞状態
stopping	通常停止中
forceStopping	強制停止中