startServer 指令

語法

startServer server_name [options]

其中 server_name 是您要啟動之應用程式伺服器或 DMZ Secure Proxy Server for IBM WebSphere Application Server 的名稱。

這是必要引數。

這是選用引數。 如果未指定這個引數，會根據您的設定檔名稱來指派伺服器。 If you use the profile named default, the <server> argument is set to server1. If the profile name is not default, the <server> argument is set to the profile name.

startServer <adminagent_name>

其中 adminagent_name 是您要啟動之管理代理程式的名稱。

startServer <job_manager>

其中 job_manager 是您要啟動之工作管理程式的名稱。

參數

startServer 指令的可用選項如下：

-?

列印用法說明。

-curlib <product_library>

指定基礎「提交工作」(SBMJOB) CL 指令所用的現行程式庫。

-cpyenvvar

指示 startServer 指令設定目前定義給伺服器處理程序的環境變數。 預設值是不設定目前定義的環境變數。

-help

列印用法說明。

-inllibl <library_list>

指定基礎「提交工作」(SBMJOB) CL 指令所用的起始程式庫清單。

-inlaspgrp <ASP_group>

指定基礎「提交工作」(SBMJOB) CL 指令的起始 ASP 群組。

-J <java_option>

指定要傳遞至 Java 直譯器的選項。

-jobd <product_library/job_description>

指定基礎「提交工作」(SBMJOB) CL 指令的工作說明。

-jobq <product_library/job_queue>

指定基礎「提交工作」(SBMJOB) CL 指令的工作佇列。

-logfile <fileName>

指定要寫入追蹤資訊的日誌檔位置。 依預設，日誌檔名稱為 startServer.log，建立在您的 logs 目錄中。

-nowait

告知 startServer 指令不要等待已啟動伺服器程序順利起始設定。

-outq <product_library/output_queue>

指定基礎「提交工作」(SBMJOB) CL 指令的輸出佇列。

-profileName

定義多重設定檔安裝架構中的伺服器程序設定檔。 如果要在單一設定檔環境中執行，-profileName 選項不是必要選項。 這個選項的預設值是預設設定檔。

-quiet

隱藏 startServer 指令以標準模式列印的進度資訊。

-replacelog

取代日誌檔，而不是附加至現行日誌。

-recovery

指定伺服器將在回復模式下啟動、執行交易式回復，然後關閉。 處於回復模式的伺服器不接受任何新的交易。 當您重新啟動伺服器時，因交易有問題而無法使用的資源，將可供使用。

如果伺服器失敗，且您不想在回復程序期間接受新交易，請使用這個選項。

對於轉移使用者: 如果您是從舊版產品移轉，請確定控制器的 JCL 程序陳述式所包含的 ENV 參數包括 REC=N 或 REC=Y 元素。 如果 ENV 參數沒有包含 REC=N 或 REC=Y 元素，伺服器將不會在回復模式下重新啟動，即使您指定 -recovery 選項也一樣。

如果 ENV 參數包含 REC=N 元素，如果您在重新啟動伺服器時指定了 -recovery，會自動將設定變更為 REC=Y。 如果您沒有從產品舊版移轉，ENV 參數會自動包含 REC=N 元素。 下列範例是 PROC 陳述式更新後的可能樣貌：

//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>

指定基礎「提交工作」(SBMJOB) CL 指令所用的子系統。

-statusport <portNumber>

可讓管理者設定伺服器狀態回呼埠號的選用參數。 工具會開啟這個埠，並等待伺服器發出狀態回呼，來指出伺服器已啟動。 如果未設定這個參數，便會自動配置未用的埠。

-script [<script fileName>] -background

使用 startServer 指令來產生啟動 Script ，而不是直接啟動伺服器程序。 啟動 Script 名稱是選用的引數。 如果您沒有提供啟動 Script 名稱，預設 Script 檔名是 start_server，此視當成第一個引數傳遞給 startServer 指令的伺服器名稱而定。 -background 是選用參數，指定當您執行產生的 Script 時，將在背景執行它。

-trace

會將追蹤資訊產生至日誌檔以進行除錯。

對啟動伺服器的原生程序程式碼啟用追蹤。 追蹤輸出會寫入至 was_jobname-jobuser-jobnum.log 檔，這個檔案位於 profile_root/logs 目錄。

-timeout <seconds>

指定在伺服器起始設定逾時並傳回錯誤之前的等待時間。

-usejobd

指定在切換至「執行身分」使用者 ID 時，要使用伺服器之「提交工作 (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 jobmgr

startServer proxy1 (for the secure proxy profile)

startServer server1

startServer server1 -script (produces the start_server1.sh file)

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

startServer adminagent

startServer jobmgr

startServer proxy1 (for the secure proxy profile)

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 JobMgr01

startServer proxy1 (default server name for the SecureProxySrv01 profile)

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 回覆碼，以判斷是否成功？ 這份表格顯示伺服器給定啟動或停止指令的回覆碼。

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