startServer コマンド

構文

startServer server_name [options]

ここで、server_name は、開始するアプリケーション・サーバーの名前になります。

この引数は必須です。

この引数はオプションです。 この引数が指定されていない場合は、プロファイル名に基づいてサーバーが割り当てられます。 defaultという名前のプロファイルを使用する場合、< server> 引数は server1に設定されます。 プロファイル名が defaultでない場合、< server> 引数はプロファイル名に設定されます。

startServer <adminagent_name>

ここで、adminagent_name は、 開始する管理エージェントの名前です。

パラメーター

startServer コマンドで使用可能なオプションは、以下のとおりです。

-?

使用ステートメントを出力します。

-curlib <product_library>

基礎となる Submit Job (SBMJOB) CL コマンドで使用する現行ライブラリーを指定します。

-cpyenvvar

サーバー・プロセスに現在定義されている環境変数を設定するように startServer コマンドに指示します。 デフォルトは、現在定義されている環境変数を未設定にすることです。

-help

使用ステートメントを出力します。

-inllibl <library_list>

基礎となる Submit Job (SBMJOB) CL コマンドで使用する初期ライブラリー・リストを指定します。

-inlaspgrp <ASP_group>

基礎となる Submit Job (SBMJOB) CL コマンドで使用する初期 ASP グループを指定します。

-J <java_option>

Java インタープリターにパススルーするオプションを指定します。

-jobd <product_library/job_description>

基礎となる Submit Job (SBMJOB) CL コマンドのジョブ記述を指定します。

-jobq <product_library/job_queue>

基礎となる Submit Job (SBMJOB) CL コマンドのジョブ・キューを指定します。

-logfile <fileName>

トレース情報を書き込むログ・ファイルのロケーションを指定します。 デフォルトでは、ログ・ファイルは、startServer.log という名前で logs ディレクトリーに作成されます。

-nowait

startServer コマンドに対して、起動されたサーバー・プロセスの正常な初期化を待機しないように指示します。

-outq <product_library/output_queue>

基礎となる Submit Job (SBMJOB) CL コマンドの出力キューを指定します。

-profileName

複数プロファイルのインストール済み環境におけるサーバー・プロセスのプロファイルを定義します。 -profileName オプションは、単一プロファイル環境で実行する場合は必要ありません。 このオプションのデフォルトは、 デフォルト・プロファイルです。

-quiet

startServer コマンドが通常モードで印刷する進行情報を抑止します。

-replacelog

現行ログに追加する代わりに、ログ・ファイルを置き換えます。

-recovery

サーバーがリカバリー・モードで始動し、トランザクションのリカバリーを実行し、シャットダウンすることを指定します。 サーバーは、リカバリー・モード中は新しいトランザクションを受け入れません。 サーバーを再始動する場合は、問題のあるトランザクションのために使用不可であったリソースが使用可能になります。

サーバーに障害が起こり、リカバリー・プロセス中に新しいトランザクションを受け入れたくない場合は、このオプションを使用してください。

移行ユーザーの場合: 製品の前のバージョンから移行する場合は、コントローラーの JCL プロシージャー・ステートメントに含まれている ENV パラメーターに、REC=N エレメントまたは REC=Y エレメントのいずれかが含まれていることを確認してください。 ENV パラメーターに REC=N または REC=Y エレメントが含まれていない場合、-recovery オプションを指定しても、サーバーはリカバリー・モードで再始動しません。

//BBO6ACR  PROC ENV=,PARMS=' ',REC=N,Z=BBO6ACRZ

-recovery パラメーターを指定して startServer コマンドを呼び出したときに、リカバリー・プロセスが失敗すると、 SystemErr.log ファイルと SystemOut.log ファイルに以下のエラー・メッセージが表示されます。

CWNATV03I: Application server xxxxxx in profile xxxxxx has completed recovery. Server stopped.

このメッセージでは、 リカバリー・プロセスが正常終了しなかったことが示されていません。 -recovery パラメーターを使用した場合には、SystemErr.log ファイルと SystemOut.log ファイルで、開始中のサーバーがあるか確認し、リカバリー・プロセスが正常終了したかどうかを判別してください。

-sbs <product_library/subsystem_description>

基礎となる Submit Job (SBMJOB) CL コマンドで使用するサブシステムを指定します。

-statusport <portNumber>

サーバー状況のコールバック用のポート番号を管理者が設定できるようにするオプション・パラメーター。 ツールは、このポートを開いて、 サーバーから開始を示す状況のコールバックを待機します。 このパラメーターを設定しない場合は、未使用のポートが自動的に割り振られます。

-script [<script fileName>] -background

サーバー・プロセスを直接立ち上げる代わりに、startServer コマンドを用いて 立ち上げスクリプトを生成します。 立ち上げスクリプト名は、オプションの引数です。 起動スクリプト名を指定しない場合、デフォルトのスクリプト・ファイル名は、 startServer コマンドに最初の引数として渡されるサーバー名に基づく start_server です。 -background パラメーターは、生成したスクリプトを実行時にバックグラウンドで実行するよう指定するオプション・パラメーターです。

-trace

デバッグのために、ログ・ファイルにトレース情報を生成します。

サーバーを始動するネイティブ処理コードのトレースを使用可能にします。 トレース出力は、profile_root/logs ディレクトリーにある was_jobname-jobuser-jobnum.log ファイルに書き込まれます。

-timeout <seconds>

サーバーの初期化がタイムアウトになり、エラーが戻されるまでの待機時間を指定します。

-usejobd

「Run-As」ユーザー ID への切り替え時に、サーバーがジョブ記述を Submit Job (SBMJOB) プロセスから使用するよう指定します。

注: このコマンドは、現行ジョブ記述の USER フィールドには影響しません。

使用のシナリオ

以下は、正しい構文の例です。 括弧内の情報は、 直前のコマンドを実行した場合に作成される出力の説明です。

startServer server1

startServer server1 -script (produces the start_server1.sh or .bat files)

startServer server1 -trace (produces the startserver.log file)

startServer adminagent

startServer.sh server1 -trace -username MyUserName -password MyUserPassword
 -profileName MyProfileName     (starts the server1 server using the 
         MyProfileName profile. The server runs under the user name MyUserName,
         and produces trace files under the profile_root/logs directory)

startServer server1 (starts the server1 server for the default profile)

startServer server1 -trace (starts the server1 server for
the default profile and produces trace files under the
profile_root/logs directory)

startServer -profileName mytest (starts server mytest 
configured under profile mytest)

startServer AdminAgent01

startServer.sh server1 -trace -username MyUserName -password MyUserPassword
 -profileName MyProfileName     (starts the server1 server using the 
         MyProfileName profile. The server runs under the user name MyUserName,
         and produces trace files under the profile_root/logs directory)

出口コード

startServer および stopServer の戻りコードを取得して、これが成功したかどうかを判別する方法を示します。 以下の表に、所定の start または stop コマンドにおけるサーバーの戻りコードを示します。

#!/bin/sh
exitCode=`./startServer.sh server1`