程序定義設定

請利用這個頁面來配置程序定義。程序定義包括啟動或起始設定程序所需要的指令行資訊。

如果要檢視這個管理主控台頁面，請按一下伺服器 > 伺服器類型 > WebSphere 應用程式伺服器 > server_name。然後在「伺服器基礎架構」區段中，按一下 Java 和程序管理 > 程序定義。

[z/OS] 在 z/OS® 上，您必須按一下控制、 服務者或 附屬項。

[z/OS] 若為 z/OS，這個頁面提供用來啟動、起始設定或停止程序的指令行資訊。控制處理程序可以使用提供的資訊所適用的每個指令。服務者程序只適用啟動指令和啟動指令引數內容。請在程序定義畫面中指定控制程序的指令，在另一個程序定義畫面中指定服務者程序的指令。請勿在相同畫面中，指定兩個不同程序的指令。

執行檔名稱

此指令行資訊指定所要呼叫以啟動程序的執行檔名稱。

比方說，如果您利用 PERL Script 作為通用伺服器，請在「執行檔名稱」欄位中輸入 perl.exe 模組的路徑，然後在「執行檔引數」欄位中輸入 PERL Script 的名稱及任何引數。

[z/OS] 此欄位不適用於 z/OS 控制程序。

表 1. 資料類型。下表說明「執行檔名稱」設定的資料類型。
資訊	值
資料類型	字串

執行檔引數

此指令行資訊指定當啟動程序時要傳給執行檔的引數。

您可以在這個欄位中輸入多個引數，但必須用回車字元來分開它們。請利用鍵盤上的 Enter 鍵來建立這些回車字元。下列範例說明需要兩個引數的 PERL Script 應用程式應該如何出現在這個欄位中：

perl_application.pl
arg1
arg2

[z/OS] 此欄位不適用於 z/OS 控制程序。

表 2. 資料類型及單位。下表說明「執行檔引數」設定的資料類型與單位。
資訊	值
資料類型	字串
單位	指令行引數

啟動指令 (startCommand)

此指令行資訊指定用來啟動伺服器程序的平台專用指令。

z/OS 控制程序

表 3. 資料類型、格式及範例。下表說明資料類型、格式與範例。
資訊	值
資料類型	字串
格式	START `control_JCL_procedure_name`
範例	START BBO6ACR

z/OS 服務者程序

對於 z/OS 服務者程序，啟動指令的值會指定工作量管理程式 (WLM) 用來啟動服務者程序的程序名稱。只有在已安裝 WLM 動態應用程式環境特性的情況下，WLM 才會使用這個值。

表 4. 資料類型、格式及範例。下表說明資料類型、格式與範例。
資訊	值
資料類型	字串
格式	`servant_JCL_procedure_name`
範例	BBO6ASR

啟動指令引數 (startCommandArgs)

此指令行資訊指定啟動指令所需的其他任何引數。

如果您有兩個以上引數需要針對程序定義設定傳遞，則必須在個別行上指定這些引數。比方說，如果要指定埠 8089 和配置檔（位置和檔名）作為指令引數，您可以指定：

<startCommandArgs>8089<startCommandArgs>
<startCommandArgs>/opt/payexpert/conf/PCPILogServer.properties<startCommandArgs>

在管理主控台中，您可以在每一新行輸入一個引數，來進行這項指定。

附註: 請勿只使用空格來區隔指令引數。

z/OS 控制程序

表 5. 資料類型、格式、範例。下表說明資料類型、格式與範例。
資訊	值
資料類型	字串
格式	JOBNAME=`server_short_name`， ENV=`cell_short_name`.`node_short_name`.`server_short_name`
範例	JOBNAME=BBOS001,ENV=SY1.SY1.BBOS001

z/OS 服務者程序

表 6. 資料類型、格式、範例。下表說明資料類型、格式與範例。
資訊	值
資料類型	字串
格式	JOBNAME=`server_short_name`S ， ENV=`cell_short_name`.`node_short_name`.`server_short_name`
範例	JOBNAME=BBOS001S,ENV=SY1.SY1.BBOS001

避免麻煩: 若為 z/OS，依預設伺服器簡稱 (JOBNAME) 包含 7 個字元，但您可以將簡稱延長至 8 個字元。

停止指令 (stopCommand)

此指令行資訊指定用來停止伺服器程序的平台專用指令

[z/OS] 若為 z/OS，如果這個欄位空白，則會使用 MVS STOP 指令來停止通用伺服器。

表 7. 資料類型、格式、範例。在欄位中指定兩個指令，一個用於停止指令，一個用於立即停止 (CANCEL) 指令。
資訊	值
資料類型	字串
格式	停止 `server_short_name`;CANCEL `server_short_name`
z/OS 範例	STOP BBOS001;CANCEL BBOS001

停止指令引數 (stopCommandArgs)

此指令行資訊指定停止指令所需的其他任何引數。

表 8. 資料類型、格式、範例。指定停止指令和立即停止 (CANCEL) 指令的引數。
資訊	值
資料類型	字串
格式	`stop command arg string`;`immediate stop command arg string`
z/OS 範例	;ARMRESTART 在這個範例中，「停止」沒有引數。「立即停止」有 ARMRESTART 引數。 ARMRESTART 前面有一個分號。

終止指令 (terminateCommand)

此指令行資訊指定用來終止伺服器程序的平台專用指令。

表 9. 資料類型、格式、範例。指定終止指令的引數。
資訊	值
資料類型	字串
格式	FORCE `server_short_name`
z/OS 範例	FORCE BBOS001

終止指令引數 (terminateCommandArgs)

此指令行資訊指定終止指令所需的其他任何引數。

預設值為空字串。

表格 10. 資料類型、格式、範例。指定終止指令的其他引數。
資訊	值
資料類型	字串
格式	`終止指令引數字串`
z/OS 範例	ARMRESTART

工作目錄

指定檔案系統目錄，程序會將這個目錄當作其現行工作目錄來使用。此設定僅適用於 IBM® i 及分散式平台。程序利用這個目錄來判斷含相對路徑名稱的輸入和輸出檔的位置。

[z/OS] z/OS 控制程序不會顯示這個欄位。

避免麻煩: 在 z/OS上，工作目錄一律是 UNIX ® System Services 目錄，它針對啟動服務者的使用者，使用 RACF ® 使用者設定檔的 OMVS 設定來定義。因此，即使您在此欄位中指定目錄，也會使用 UNIX 系統服務目錄作為工作目錄。若要提供在 z/OS 平台及分散式平台上執行的應用程式之間的相容性，請將 UNIX 系統服務目錄設為您在分散式平台系統上工作目錄欄位中指定的相同值。

避免麻煩: 變更 com.ibm.websphere.zos.userdir.useRacfSettings 的設定不會對 JVM 產生動態影響。如需相關資訊，請參閱 Java 虛擬機器自訂內容。

表格 11. 資料類型。下表說明資料類型。
資訊	值
資料類型	字串

可執行的目標類型

指定執行檔目標是 Java™ 類別或 JAR 執行檔。

表 12. 資料類型。下表說明資料類型。
資訊	值
資料類型	字串

可執行的目標

指定執行檔目標的名稱。如果目標類型是 Java 類別名稱，則此欄位包含 main () 方法。如果目標類型是 JAR 執行檔，這個欄位會包含這個 JAR 檔的名稱。

表 13. 資料類型。下表說明資料類型。
資訊	值
資料類型	字串