配置 Rational Build Agent Shell Script

Jazz™ Build System 包含一個名稱為 startbfa.sh 的範例 Script,您可以用它來啟動 Rational® Build Agent。

您可以在 @pathPrefix@/usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/startbfa 目錄中找到這個範例 Script,其中 @pathPrefix@ 是您安裝 SMP/E 時所指定的任何字首。啟動 Rational Build Agent 時,需要這個 Script 來指定認證,代理程式才能連接 Jazz Team Server,並且讓您能夠存取執行「Ant with Enterprise Extensions」和原生編譯時所需要的程式庫。 BLZCPBTK 工作會將這個 Script 複製到 Rational Team Concert 配置目錄中,通常是 /etc/jazz40/ccm。
重要: Script 必須配置為適合您的環境。BLZCPBTK 複製和配置工作將會配置好許多必要的變數。 但是,使用者 ID 與密碼資訊等之類的一些變數並不會自動設定。請依照下表的說明,檢閱並取代範例 Script 中所需的變數字串:
表 1. 範例 Script 變數字串
變數 說明
@pathPrefix@ 用來作為 Jazz 目錄字首的目錄路徑
註: 這是 Jazz 目錄的字首,因此,您的字首應該包括您在 SMP/E 安裝過程中所指定的任何字首,然後包括 /usr/lpp。
@javaPathPrefix@ 適用於 z/OS® Java™ 2 Technology 之 IBM® 31 位元 SDK 的目錄路徑。
@yourUserid@ Jazz 使用者 ID。
@yourPasswordFile@ BLZBPASS 工作所定義的 Jazz 密碼檔。 請參閱在 z/OS 上執行 Jazz Build Engine,以取得如何執行 BLZBPASS 工作的相關資訊。
@stepLib@ 供您的 z/OS 建置使用的 STEPLIB DD(資料集定義)。例如,SYS1.LINKLIB:CEE.SCEERUN
@bfaBinPath@ Rational Build Agent 可執行目錄的目錄路徑。
@bfaConfPath@ Rational Build Agent 配置檔目錄的目錄路徑。
@zLang@ 主機檔中所用的編碼。例如,IBM-037。
@timeout@ 執行建置步驟時的逾時值(秒)。如果沒有指定,則預設值為 300 秒。
@workPath@ 儲存 PDSE 之 meta 資料的目錄路徑。依預設值,此為 /u/jazz40/ccm/。
@yourHomeDirectory@ 您的起始目錄。 請只在它處未定義 HOME 環境變數時,才使用這個變數。
_CMDSERV_BASE_HOME 指出 ISPF 提供之檔案的位置,Rational Build Agent 才能夠啟動 ISPF 閘道。如需 _CMDSERV_BASE_HOME 的相關資訊,請參閱配置 ISPF 閘道以取得建置、部署及調升支援。
當您準備好啟動 Rational Build Agent 及接受建置要求時,您可以使用下列一種方式來執行 startbfa.sh Script:
  • 從 OMVS 手動啟動 startbfa.sh Script
  • 遵循工作中的指示,配置 BLZ.SBLZSAMP 程式庫中提供的起始作業 BLZBFA 範例。 之後,當系統啟動時,您就能夠以起始作業形式來執行 Build Forge Agent。 您必須將這項工作複製到系統配置的 PROCLIB,並且設定必要的安全設定,它才能以起始作業形式來執行。
註: 除非在 bfagent.conf 檔中指定了另一個 Shell,否則,在 z/OS 中,Rational Build Agent 所啟動的階段作業會使用預設 Shell (/bin/sh)。在執行 startbfa.sh 之後,z/OS 中的預設 Shell 一律會執行 /etc/profile Script 來設定系統層面的配置,有可能會改寫 startbfa.sh Shell Script 中所設定的一些環境變數。

當您在 Ant 引數中設定 –verbose 或 –debug 選項來執行「含企業延伸的 Ant」建置或相依關係建置時,在呼叫 Ant 之前,會先執行 UNIX 匯出指令。您可以在建置日誌中查看匯出指令的輸出,確定已正確設定環境變數。

如果 /etc/profile 置換某些環境變數,請要求您的系統程式設計師來變更 /etc/profile。 如果不可能變更 /etc/profile,您可以使用 bash Shell,這個工具隨附於 z/OS Ported Tools。 將下列兩行新增至 bfagent.conf 檔,以指定 –noprofile 選項:
shell /bin/bash   
shellflag --noprofile 

意見