batchManager 指令行用戶端公用程式
batchManager 指令行用戶端公用程式提供指令行介面,來管理在 Liberty 上執行的批次工作。
batchManager 指令行用戶端公用程式會透過批次管理器的 REST API,與批次管理程式互動。如果要使用 batchManager 指令行用戶端公用程式,批次管理程式必須正在 Liberty 伺服器上執行。請使用批次管理特性,來安裝並啟用 Liberty 批次管理程式。
SSL 配置
batchManager 指令行用戶端公用程式會透過 SSL 連線,與批次管理程式互動。為了方便與正在 Liberty 伺服器上執行的批次管理程式進行 SSL 通訊,公用程式必須能夠驗證 Liberty 伺服器的 SSL 憑證。
如果 SSL 憑證由已知的憑證管理中心 (CA) 簽署,公用程式可讓 CA 驗證該憑證。不必進行進一步的配置。
- 指定 --trustSslCertificates 選項,這會將公用程式配置成信任所有 SSL 憑證。
- 將伺服器的 SSL 憑證包含在公用程式的信任儲存庫中。
如果您選擇指定 --trustSslCertificates 選項,公用程式會信任它所接收的所有 SSL 憑證,且不需進行進一步的配置。
如果您選擇的選項是將伺服器的 SSL 憑證包含在公用程式的信任儲存庫中,您還必須配置公用程式,讓它可以找到其信任儲存庫。此公用程式是獨立式 Java 主要程式。您將使用 javax.net.ssl.truststore 等之類的系統內容來配置 SSL。
$ export JVM_ARGS="-Djavax.net.ssl.trustStore=/path/to/server/keystore.jks"
$ batchManager submit ...
$ keytool -export -alias default -file server.crt -keystore [server-dir]/resources/security/key.jks -storepass Liberty
$ keytool -import -alias server_crt -file server.crt -keystore /path/to/truststore.jks -storepass passw0rd
$ export JVM_ARGS="-Djavax.net.ssl.trustStore=/path/to/truststore.jks"
$ batchManager submit ...
指令和用法
batchManager 指令行用戶端公用程式提供一些指令,來提交、停止、重新啟動工作,以及檢查工作的狀態。
公用程式的一般用途:
$ batchManager [指令] [選項]
查看可用的指令清單:
$ batchManager help
查看特定指令的說明和選項:
$ batchManager help [指令]
下列範例說明如何提交工作,並等待其完成:
$ batchManager submit \
--batchManager=<host>:<port>
--user=[用來登入批次管理程式的認證]
--password=[用來登入批次管理程式的認證]
--applicationName=[包裝批次應用程式時所用的應用程式名稱]
--jobXMLName=[應用程式 batch-jobs 目錄中的工作 XML 檔基本名稱]
--wait
jobParametersFile 和 jobPropertiesFile
jobParametersFile=filePath1,filePath2,filePath3
jobPropertiesFile=filePath1,filePath2,filePath3
舉例來說,--jobParametersFile=<filepath1> 會置換控制內容檔中的 --jobParametersFile=<filepath1>,<filepath2>。
產生的參數是 --jobParametersFile=<filepath1>。
z/OS 上具有 SAF 金鑰環的 batchManager 指令行用戶端公用程式
如果要在 batchManager 指令行用戶端公用程式中,使用 WebSphere Application Server Liberty 伺服器的「系統授權機能 (SAF)」金鑰環,您必須設定 java.environment 設定,以及 batchManager 指令行用戶端公用程式呼叫中指定的使用者 ID,且這個使用者 ID 有權讀取 SAF 金鑰環。
下列指令會授權使用者讀取 SAF 金鑰環。
PermitRingOwnerId.RingName.LST CLASS(RDATALIB)ID(userId)ACCESS(UPDATE)
SETROPTS RACLIST(RDATALIB) GENERIC(RDATALIB) REFRESH
如需相關資訊,請參閱 WebSphere Application Server z/OS Security Server RACF 指令語言參照。
下列範例定義 JVM_ARGS 環境變數。
export JVM_ARGS="-Djavax.net.ssl.trustStore=safkeyring://ringOwnerId/ringName
-Djavax.net.ssl.trustStoreType=JCERACFKS -Djavax.net.ssl.keyStore=safkeyring://ringOwnerId/ringName
-Djavax.net.ssl.keyStoreType=JCERACFKS -Dcom.ibm.ssl.keyStoreFileBased=false -Dcom.ibm.ssl.trustStoreFileBased=false
-Djava.protocol.handler.pkgs=com.ibm.crypto.provider -Djavax.net.ssl.keyStorePassword=password"
回覆碼
| 代碼 | 說明 |
|---|---|
| 0 | 作業正常完成。 |
| 20 | 未指定必要引數。 |
| 21 | 指定的引數無法辨識。 |
| 22 | 指定的引數值無效。 |
| 255 | 發生不明錯誤。 |
| 代碼 | 說明 |
|---|---|
| 33 | 工作已停止。 |
| 34 | 工作未順利完成。 |
| 35 | 工作已順利完成。 |
| 36 | 工作已被放棄。 |

概念主題