stopNode コマンド
stopNode コマンドは、ノード・エージェント・プロセスの構成ファイルを読み取り、Java™ Management Extensions (JMX) コマンドを送信して、ノード・エージェントにシャットダウンするように指示します。
デフォルトでは、stopNode コマンドは ノード・エージェントがシャットダウンを完了するまで待機してから制御をコマンド行に戻します。 即時に戻す -nowait オプションや、stopNode コマンドの動作を制御する その他のオプションもあります。 このコマンドを実行する状況について詳しくは、コマンド行ツールの使用を参照してください。
Windows オペレーティング・システムを使用しており、ノード・エージェントが Windows サービスとして実行されている場合、stopNode コマンドは関連する Windows サービスを使用してノード・エージェントを停止します。
stopServer -servers コマンドを使用してノード・エージェントを停止する前にサーバーを停止した場合、startServer コマンドを発行してもサーバーは再始動しません。
stopServer コマンドは、サーバーのシャットダウンが完了したときに制御を戻しますが、IBM® i プロセスが終了する前に戻すことも可能です。
Java 仮想マシンがメモリー・プールに戻さなければならないメモリーの量によって異なりますが、処理が終了するには数秒から数分かかります。
処理が終わるまで、サーバーを再開しないでください。
処理が完全に終わったかどうかを判別するためには、WRKACTJOB SBS(subsystem) CL コマンドを使用してください。
デフォルトでは、サブシステムは QWAS85 です。

構文
stopNode [options]
パラメーター
stopNode コマンドで使用可能なオプションは、以下のとおりです。
- -nowait
- stopNode コマンドに対して、ノード・エージェント・プロセスが正常に シャットダウンするまで待たないように指示します。
- -quiet
- stopNode コマンドが通常モードで印刷する進行情報を抑止します。
- -logfile <fileName>
- トレース情報を書き込むログ・ファイルのロケーションを指定します。デフォルトでは、ログ・ファイルは stopServer.log という名前で、停止されるノードのプロファイルの logs ディレクトリーに作成されます。
-profileName
マルチプロファイル・システムで、アプリケーション・サーバー・プロセスのプロファイルを定義します。 -profileName オプションは、単一プロファイル環境で実行する場合は必要ありません。 このオプションのデフォルトは、 デフォルト・プロファイルです。
- -replacelog
- 現行ログに追加する代わりに、ログ・ファイルを置き換えます。
- -trace
- デバッグのために、ファイルにトレース情報を生成します。このトレース出力は、profile_root/logs ディレクトリーにある was_jobname-jobuser-jobnum.log ファイルに書き込まれます。
- -timeout <seconds>
- タイムアウトが発生しエラーが戻されるまでの、エージェントのシャットダウンの待ち時間を指定します。
サポートされる構成: timeout パラメーター は、一度に 1 つのサーバーを停止する場合に使用します。 timeout パラメーターを stopservers パラメーターと一緒に使用すると、 timeout パラメーター値は無視されます。sptcfg
- -statusport <portNumber>
- 管理者がノード・エージェント状況のコールバック用のポート番号を設定できるようにするオプション・パラメーター。ツールは、このポートを開いて、 ノード・エージェントから完全に停止する直前の状況のコールバックを待機します。このパラメーターを設定しない場合は、未使用のポートが自動的に割り振られます。
- -stopservers [-saveNodeState]
- ノード・エージェントを停止する前に、ノード上のすべてのアプリケーション・サーバーを停止します。
-saveNodeState オプションを使用してサーバー再始動状態を保存し、startNode コマンドを使用して前の状態に基づいたアプリケーション・サーバーの始動を可能にします。
- -conntype <type>
- デプロイメント・マネージャーへの接続に使用する Java Management Extensions (JMX) コネクター・タイプを指定します。 有効なタイプは、SOAP またはリモート・メソッド呼び出し (RMI) です。
- -port <portNumber>
- 明示的に使用するノード・エージェント JMX ポートを指定します。 これにより、情報を得るために構成ファイルを読み取らなくても済みます。
- -username <name>
- ノード・エージェントでセキュリティーが使用可能な場合、認証するユーザー名を指定します。 -user オプションと同様の働きをします。
- -user <name>
- ノード・エージェントでセキュリティーが使用可能な場合、認証するユーザー名を指定します。 -username オプションと同様の働きをします。
- -password <password>
- ノード・エージェントで
セキュリティーが使用可能な場合、認証のためのパスワードを指定します。注: 機密保護機能のある環境で実行中にユーザー ID とパスワードをまだ提供していない場合は、 次のエラー・メッセージが表示されます。
この問題を回避するには、ユーザー ID とパスワードの情報を指定してください。ADMN0022E: Access denied for the stop operation on Server MBean due to insufficient or empty credentials.
- -help
- 使用ステートメントを出力します。注: stopNode コマンドの使用法ステートメントのヘルプを要求すると、 stopServer コマンドについての説明が表示されます。 この使用法ステートメント用に表示されるオプションは、 すべて stopNode コマンドに適用されます。
- -?
- 使用ステートメントを出力します。注: stopNode コマンドの使用法ステートメントのヘルプを要求すると、 stopServer コマンドについての説明が表示されます。 この使用法ステートメント用に表示されるオプションは、 すべて stopNode コマンドに適用されます。
使用のシナリオ
以下は、正しい構文の例です。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
stopNode
stopNode -nowait
stopNode -trace (produces the stopnode.log file)
![[IBM i]](../images/iseries.gif)
stopNode
stopNode -profileName mynode
stopNode -nowait
stopNode -trace (profile_root/logs ディレクトリーにトレース・ファイルを作成します。)