適用於 z/OS 平台

配置 batchManagerZos 用戶端公用程式

您可以使用 batchManagerZos 用戶端公用程式,管理正在 z/OS 的 Liberty 上執行的批次工作。

關於這項作業

batchManagerZos 用戶端公用程式是 batchManager 指令行公用程式的原生編譯版本,用來管理正在 z/OS 的 Liberty 上執行的批次工作。它是原生程式,不需要 JVM。此公用程式隨附於 batchManagement-1.0 特性中。

batchManagerZos 用戶端公用程式支援 batchManager 指令行公用程式支援的一部分指令和選項。如果要檢視指令和選項清單,請使用 $batchManagerZos help 指令。

batchManagerZos 用戶端公用程式使用最佳化本端配接器,來連接正在本端環境中執行的 Liberty 伺服器。batchManagerZos 用戶端公用程式無法連接遠端伺服器。

安全考量
batchManagerZos 用戶端公用程式的安全行為,取決於 Liberty 伺服器是否使用 SAF 登錄。
  • 如果伺服器使用 SAF 使用者登錄,會將 batchManagerZos 用戶端公用程式身分設為批次要求的要求端身分(JEE 執行身分主體)。
  • 如果伺服器沒有使用 SAF 使用者登錄,則會忽略 batchManagerZos 用戶端公用程式身分。在此情況下,會將 EVERYONE 特殊主體設為批次要求的要求端身分。
批次角色型授權

如果在伺服器中啟用了 appSecurity,您必須將要求端身分指派給該要求所需的適當批次安全角色。有效的批次安全角色為 batchAdmin、batchSubmitter 和 batchMonitor。如果未指派身分給所需的角色,該要求會因安全異常狀況而失敗。

授權由安全授權提供者來管理。如果伺服器使用 SAF 授權,SAF 授權提供者會根據 EJBROLE 類別中的定義,檢查該身分對 SAF 資源設定檔的存取權,來判斷要求端身分的授權。依預設,批次角色相關聯的資源設定檔如下。
    batchAdmin:     BBGZDFLT.com.ibm.ws.batch.batchAdmin
    batchSubmitter: BBGZDFLT.com.ibm.ws.batch.batchSubmitter
    batchMonitor:   BBGZDFLT.com.ibm.ws.batch.batchMonitor
要求端身分必須獲授與對適當資源設定檔的 READ 存取權,才能獲得對應批次角色的權限。

下列範例說明 RACF 指令,以授與用戶端身分 bob 對 batchAdmin 角色的權限。

    RDEFINE EJBROLE BBGZDFLT.com.ibm.ws.batch.batchAdmin UACC(NONE)
    PERMIT BBGZDFLT.com.ibm.ws.batch.batchAdmin CLASS(EJBROLE) ID(bob) ACCESS(READ)
回覆碼
batchManagerZos 用戶端公用程式所輸出的回覆碼如下:
代碼 說明
0 作業正常完成。
20 未指定必要引數。
21 指定的引數無法辨識。
22 指定的引數值無效。
255 發生不明錯誤。
註: 如果您指定 --wait 引數,公用程式會輸出下列回覆碼,指出您正在等待之工作的狀態。
代碼 說明
33 工作已停止。
34 工作未順利完成。
35 工作已順利完成。
36 工作已被放棄。
註: 如果您藉由執行 BPXBATCH 來執行 batchManagerZos,BPXBATCH 的回覆碼會與 batchManagerZos 的回覆碼不符。BPXBATCH 會採用 batchManagerZos 回覆碼,且最多進位一個位元組。舉例來說,如果 batchManagerZos 傳回 1,BPXBATCH 傳回 256,(即十六進位值 0x01),則最多進位一個位元組變成 0x100。

如果從 JCL STEP 呼叫 BPXBATCH,會截斷 STEP 回覆碼,變成 BPXBATCH 回覆碼的三個低位十六進位字元。舉例來說,如果 batchManagerZos 傳回 35(即十六進位 0x23),BPXBATCH 將傳回 0x2300。JCL STEP 會將回覆碼截斷成 0x0300 或 768。

限制

batchManagerZos 用戶端公用程式目前不支援擷取或串流處理工作日誌。

batchManagerZos 用戶端公用程式的 stop 指令必須引導至執行工作的批次執行程式。在多伺服器環境中,如果 batchManagerZos 用戶端公用程式連接至指定的批次分派器,而不是正在執行工作的批次執行程式,Stop 指令可能因 BatchJobNotLocalException 而失敗。批次分派器通常會收到提交要求,並將這些要求分送到下游的批次執行程式。

程序

  1. 在 server.xml 檔中啟用 batchManagement-1.0 和 zosLocalAdapters-1.0 特性。
    <featureManager>
    	<feature>batchManagement-1.0</feature>
    	<feature>zosLocalAdapters-1.0</feature>
    </featureManager>
  2. 配置 zosLocalAdapters-1.0 端點。 下列範例說明 zosLocalAdapters-1.0 端點配置。
    <zosLocalAdapters wolaGroup="LIBERTY" wolaName2="BATCH" wolaName3="MANAGER"/>
  3. 允許 batchManagerZos 用戶端公用程式連接 zosLocalAdapters 端點。 為了讓 batchManagerZos 用戶端透過最佳化本端配接器來連接伺服器,用戶端的 userId 必須有權使用 zosLocalAdapters 端點相關聯的 CBIND SAF 資源。在 CBIND 類別中,該端點相關聯的資源名為 BBG.WOLA.{wolaGroup}.{wolaName2}.{wolaName3}。如果要連結名稱是 LIBERTY BATCH MANAGER 的 zosLocalAdapters 端點,您必須將 CBIND 類別中之 BBG.WOLA.LIBERTY.BATCH.MANAGER 資源的讀取權,授與 batchManagerZos userID。下列範例說明當您授與對資源的存取權時,必須使用的 RACF 指令。
        RDEFINE CBIND BBG.WOLA.LIBERTY.BATCH.MANAGER UACC(NONE)   
        PERMIT BBG.WOLA.LIBERTY.BATCH.MANAGER CLASS(CBIND) ACCESS(READ) ID(bob)
    註: 在本例中,bob 是執行 batchManagerZos 的使用者。
  4. 如果您希望以用戶端身分,在伺服器上執行 batchManagerZos 要求,您必須授權伺服器使用 SAFCRED z/OS 授權資源。 下列範例說明為了讓伺服器能夠使用 SAFCRED z/OS 授權資源,您必須使用的 RACF 指令。
        RDEFINE SERVER BBG.AUTHMOD.BBGZSAFM.SAFCRED UACC(NONE)   
        PERMIT BBG.AUTHMOD.BBGZSAFM.SAFCRED CLASS(SERVER) ACCESS(READ) ID(wlpuser1)
  5. 啟動 Angel 位址空間。
  6. 啟動 Liberty 伺服器。
  7. 使用 ping 指令,來測試 batchManagerZos 用戶端與 Liberty 伺服器之間的連線功能。
    $ batchManagerZos ping '--batchManager=LIBERTY BATCH MANAGER'

    如果連線測試成功,用戶端會結束,並產生回覆碼 0。如果連線測試失敗,則會發出錯誤訊息。

  8. 如果要進行疑難排解,您可以設定 $ export batchManagerZosTrace=1 環境變數,在用戶端中啟用額外追蹤。
  9. 選用:將 batchManagerZos 用戶端公用程式配置成等待批次工作事件結束,而不是利用輪詢來等待。

    您必須配置批次伺服器,以便能夠發佈使用 WebSphere MQ 傳訊提供者的工作相關事件。請參閱啟用批次工作事件發佈的相關說明文件

    下列範例顯示如何如何提交工作,並根據工作結束事件來等待其完成:
    $ batchManagerZos submit  
    --batchManager=LIBERTY+BATCH+MANAGER  
    --applicationName=[包裝批次應用程式時所用的應用程式名稱]
    --jobXMLName=[應用程式 batch-jobs 目錄中的工作 XML 檔基本名稱]
    --wait
    --queueManagerName=[MQ 佇列管理程式的名稱]
    下列三個事件是代表工作實例的結束狀態,batchManagerZos 用戶端會等待接收其中一個:
    batch/jobs/instance/stopped 
    batch/jobs/instance/failed 
    batch/jobs/instance/completed

指示主題類型的圖示 作業主題



「時間戳記」圖示 前次更新: 2016 年 6 月 3 日
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_batchManagerZos
檔名:twlp_batchManagerZos.html