startNode コマンド
startNode コマンドは、ノード・エージェント・プロセスの構成ファイルを 読み取り、launch コマンドを作成します。
指定するオプションに応じて、startNode コマンドは、
新規 Java™ 仮想マシン (JVM) API を作成してエージェント・プロセスを実行したり、
launch コマンド・データをファイルに書き込んだりします。
Windows プラットフォームを使用していて、ノード・エージェントを Windows サービスとして実行している場合は、startNode コマンドは、関連した Windows サービスを開始し、ノード・エージェントの開始も行います。
startNode コマンドは、WebSphere® Application Server Network Deployment セルに追加されたプロファイルのノード・エージェント・プロセスの構成ファイルを読み取り、そのサーバーを始動します。
startNode コマンドはサーバー処理を起動しますが、MBean メソッドを呼び出さないため、このコマンドでユーザー名およびパスワードを使用する必要はありません。
このコマンドをどこで実行するかについて詳しくは、コマンド行ツールの使用の項目を参照してください。
構文
コマンド構文は次のようになります。
startNode [options]
パラメーター
startNode コマンドで使用可能なオプションは、以下のとおりです。
- -?
- 使用ステートメントを出力します。
-curlib <product_library>
基礎となる Submit Job (SBMJOB) CL コマンドで使用する現行ライブラリーを指定します。
-cpyenvvar
startNode コマンドに、ノード・エージェント・プロセスに現在定義されている環境変数を設定するよう指示します。 デフォルトは、現在定義されている環境変数を未設定にすることです。
- -help
- 使用ステートメントを出力します。
-inllibl <library_list>
基礎となる Submit Job (SBMJOB) CL コマンドで使用する初期ライブラリー・リストを指定します。
-inlaspgrp <ASP_group>
基礎となる Submit Job (SBMJOB) CL コマンドで使用する初期 ASP グループを指定します。
-jobd <product_library/job_description>
基礎となる Submit Job (SBMJOB) CL コマンドのジョブ記述を指定します。
-jobq <product_library/job_queue>
基礎となる Submit Job (SBMJOB) CL コマンドのジョブ・キューを指定します。
-logfile <fileName>
トレース情報を書き込むログ・ファイルのロケーションを指定します。デフォルトでは、ログ・ファイルは startServer.log という名前で、profile_root/logs ディレクトリーに作成されます。
-nowait
startNode コマンドに、起動されたノード・エージェント・プロセスの正常な初期化を待機しないことを指示します。
-outq <product_library/output_queue>
基礎となる Submit Job (SBMJOB) CL コマンドの出力キューを指定します。
-profileName
マルチプロファイル・システムで、アプリケーション・サーバー・プロセスのプロファイルを定義します。 -profileName オプションは、単一プロファイル環境で実行する場合は必要ありません。 このオプションのデフォルトは、 デフォルト・プロファイルです。
-quiet
startNode コマンドが通常モードで印刷する進行情報を抑止します。
-replacelog
現行ログに追加する代わりに、ログ・ファイルを置き換えます。
-sbs <product_library/subsystem_description>
基礎となる Submit Job (SBMJOB) CL コマンドで使用するサブシステムを指定します。
-script [<script fileName>] -background
ノード・エージェント・プロセスを直接立ち上げる代わりに、startServer コマンドを使用して立ち上げスクリプトを生成します。 立ち上げスクリプト名は、オプションの引数です。 立ち上げスクリプト名を指定しない場合、デフォルトのスクリプト・ファイル名は、 以下のとおりです。
start_node_agent.sh
start_node_agent.bat
-statusport <portNumber>
管理者がノード・エージェント状況のコールバック用のポート番号を設定できるようにするオプション・パラメーター。ツールは、このポートを開いて、開始を示すノード・エージェントからの状況の コールバックを待機します。このパラメーターを設定しない場合は、未使用のポートが自動的に割り振られます。
- -trace
デバッグのために、ログ・ファイルにトレース情報を生成します。
ノード・エージェントを開始させるネイティブ処理コードのトレースを使用可能にします。 このトレース出力は、profile_root/logs ディレクトリーにある was_jobname-jobuser-jobnum.log ファイルに書き込まれます。
- -timeout <seconds>
- ノードの初期化がタイムアウトになってから、エラーを戻すまでの待ち時間を指定します。
-usejobd
「Run-As」ユーザー ID への切り替え時に、ノード・エージェントで、ジョブ記述を Submit Job (SBMJOB) プロセスから使用するよう指定します。
注: このコマンドは、現行のジョブ記述の「USER」フィールドには影響を与えません。
使用のシナリオ
以下は、正しい構文の例です。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
startNode
startNode -script (produces the start_node.bat or .sh file)
startNode -trace (produces additional trace statements in the startnode.log file)
![[z/OS]](../images/ngzos.gif)
startNode
startNode -trace (produces additional trace statements in the startnode.log file)
![[IBM i]](../images/iseries.gif)
startNode (デフォルト・プロファイルのためにノード・エージェント・プロセスを開始します。
The default profile must belong to a product cell.)
startNode -profileName mynode (Starts the node agent for the mynode profile
which belongs to a product cell.)
startNode -trace (profile_root/logs ディレクトリーにトレース・ファイルを作成します)