新增構件至 Rational Team Concert

新增構件至 Rational Team Concert™ 包含取出您利用 Rational® Developer for System z® 建立的構件,以用於 Rational Team Concert 的來源控制管理。

在這個範例中,您利用 Rational Developer for System z 建立 COBOL 程式,將它新增到 Rational Team Concert 儲存庫中,以進行來源控制。 您可以利用共用成員作為 zFile精靈,從 Rational Developer for System z 中,將 MVS 子專案成員新增到 Rational Team Concert 中。

請完成下列步驟。(這些步驟利用指導教學的範例來說明。)

  1. 從「遠端系統」視圖中,選取範例的載入部分所建立的 COBOL 程式,按一下滑鼠右鍵,選取建立 PDS 成員
    「遠端系統瀏覽器」的功能表,顯示「建立 PDS 成員」
  2. 新建 PDS 成員畫面的成員名稱欄位中,輸入新 COBOL 程式的名稱,按一下完成。 在這個範例中,我們將新程式命名為 Goodbye
    「建立 PDS 成員」畫面,「成員名稱」欄位顯示新建 COBOL 程式的名稱 "Goodbye"。
    您新建的 COBOL 程式會出現 HELLO.cbl 程式的相同資料集中。
    「遠端系統瀏覽器」,新的 "GOODBYE.cbl" 顯示在 "HELLO.cbl" 的相同資料集中
  3. 從「遠端系統」視圖中,將新程式拖放到「z/OS® 專案」視圖中您的 MVS 子專案上,以將它新增到這個子專案中。
    「z/OS 專案」視圖,新的 "GOODBYE.cbl" 顯示在 "HELLO.cbl" 的相同 MVS 子專案中。
新程式未顯示現有程式的相同裝飾字元,因為它尚未 Rational Team Concert 來源控制之下。
    註: 新程式 BGREEN.BLD.COBOL(GOODBYE.cbl) 並沒有 BGREEN.BLD.COBOL(HELLO.cbl) 所擁有的金色檔案裝飾字元,因為它尚未在 Rational Team Concert 來源控制之下。
請完成下列步驟,將程式新增到 Rational Team Concert 來源控制中:
  1. 從「z/OS 專案」視圖的 MVS 子專案中,用滑鼠右鍵按一下 BGREEN.BLD.COBOL(GOODBYE.cbl),選取 zComponent > 共用成員作為 zFile
    「z/OS 專案」視圖,顯示用來選取「共用成員作為 zFile」的功能表
  2. 依預設,在共用成員作為 zFile 精靈的第一個畫面中,會預先選取新增的程式名稱。 按下一步
  3. 選取要共用新程式的 zComponent 專案,然後按下一步。 您也可以建立 zComponent 專案,但在這個範例中,我們使用利用 Rational Build Agent 和 含企業延伸的 Ant 來編譯 COBOL 應用程式中所建立的專案。
    「選擇 zComponent」專案畫面,顯示現有的 zComponent 專案,以及建立 zComponent 專案的選項
  4. 給 Jazz 儲存庫共用 zComponent 專案畫面中,選取含有 HELLO.cbl 程式的相同元件。 按下一步
    「給 Jazz 儲存庫共用 zComponent 專案」畫面,顯示在現有儲存庫工作區中的 Jazz 儲存庫和元件
  5. 從「指定建置環境定義」畫面中,按一下瀏覽,選取一個建置定義。 在這個範例中,請選取抵押團隊建置
    「選取建置定義」畫面,顯示名稱為「抵押團隊建置」的建置定義
    按一下確定 > 下一步。 建置定義會關聯於 Rational Team Concert 儲存庫工作區。
    註: 您執行將 zFile 載入 z/OS 精靈或共用成員作為 zFile 精靈,且選擇儲存庫工作區的建置定義之後,建置定義會關聯於這個儲存庫工作區。 後續執行這兩個精靈時,會顯示相關聯的建置定義詳細資料,但您無法變更它們。 您可以將所有成員斷線,以清除建置環境定義。
  6. 建置定義通常會指定團隊建置所用的字首。 如果要確定您可以個別處理您的構件,請將建置定義中所指定的字首改為您自己的字首。 如果要修改字首,請從建置內容清單中選取 teamz.scm.dataset.prefix,然後按一下編輯
  7. 選取內容類型畫面的新內容類型清單中,選取字串,然後按一下確定
    「選取內容類型」畫面,顯示新內容類型的選項清單
  8. 編輯建置要求內容畫面中,將 MASAO.BLD 值改成您的字首,然後按一下確定。 (在這個範例中,我們已將值改為 BGREEN.BLD。)
    「編輯建置要求」畫面,顯示值已變更為 BGREEN.BLD
    重要: 請確定您用來建立主機 RSE 連線的認證,有權以您在值欄位中設定的字首來建立及修改資料集。
  9. 下一步

當新程式新增到 zComponent 專案時,它會放在 zFolder 中。 這個 zFolder 必須關聯於某個資料集定義。

您可以變更資料集定義關聯。 這個範例所用的畫面顯示正確的資料集名稱 (BGREEN.BLD.COBOL),但儲存庫資料集定義 (BMS) 不正確。

「關聯資料集定義」畫面,顯示不正確的儲存庫資料集定義 "BMS"

請完成下列步驟來變更關聯:
  1. 關聯資料集定義畫面中,按一下瀏覽標題之下的 <...> 按鈕。
  2. 選取 COBOL 資料集定義,然後按一下確定
    「選取資料集定義」畫面,顯示已選取 "COBOL" 作為資料集定義選項
  3. 您也可以在關聯資料集定義時,關聯語言定義。 如果您未在這裡關聯語言定義,在要求建置之前,您必須先關聯所有要建置之檔案的語言定義。
  4. 在更新的關聯資料集定義畫面中,確認儲存庫資料集定義正確。 在這個範例中,它是 COBOL
    「關聯資料集定義」畫面,顯示正確的儲存庫資料集定義 "COBOL"
  5. 共用成員作為 zFile 精靈的最後一頁中,會有選項供您複製或移動成員。 如果您選擇複製,成員會保留在它的原始資料集中,且會將副本放在資料集定義和字首所指定的新位置中。 如果您選擇移動,就移動及刪除原始資料集中的成員。
  6. 按一下完成

確認已順利共用

專案瀏覽器中,確認 GOODBYE.cbl 程式已新增到 zComponent 專案中。
「專案瀏覽器」視圖,顯示 zComponent 專案中的 "GOODBYE.cbl"
提示: 如果共用成員作為 zFile 精靈結束,且發生錯誤,請開啟 Eclipse 工作區 meta 資料之資料夾中的 .log 檔,以取得相關資訊。

意見