使用 Rational Team Concert for System z 語言定義產生器,來自動產生建置 meta 資料

開始之前
在 Rational Team Concert™ for System z® 整合開發環境 (IDE) 用戶端中,使用語言定義產生器來建立資料集定義、轉換器與語言定義,而不需使用編輯器。

在您使用語言定義產生器之前,必須已執行下列動作:

匯入 zComponent 專案,以搭配語言定義產生器使用

執行這項作業的原因和時機
請完成這項作業,來練習搭配使用語言定義產生器與專案範例(其中一些已隨 Rational Team Concert for System z 用戶端一起安裝)。
  1. 在 Rational Team Concert for System z 中,開啟「資源」視景。
    1. 按一下視窗
    2. 移至「開啟視景」上。
    3. 選取其他
    4. 選取資源
    5. 按一下確定 這時會顯示「專案瀏覽器」視圖。
  2. 在「專案瀏覽器」視圖中,用滑鼠右鍵按一下您的專案,並選取匯入 這時會開啟「匯入」精靈的選取視窗。
  3. 在「匯入」精靈的選取視窗中,展開「一般」節點,並選取現有的專案至工作區
  4. 下一步 這時會開啟「匯入」精靈的匯入專案視窗。
  5. 選取選取根目錄圓鈕,並按一下瀏覽
  6. 選取您要匯入之專案的根目錄。專案範例儲存在 Rational Team Concert for System z 安裝目錄 C:\Program Files\IBM\SDP\rtcz\samplesrtcz\samples 子目錄中。
  7. 選取您要匯入之專案旁的方框。可用的專案範例如下:
    HelloWorldSample
    簡式 "Hello World" COBOL 應用程式範例。
    HelloWorldSample2
    主機組譯器 PL/I 與 C 中的附加 "Hello World" 應用程式。
    MortgageApplication
    內含多個 zComponent 專案的 COBOL 範例應用程式。如果要匯入這個專案範例,請選取名稱開頭為 MortgageApplication 的所有專案。
  8. 按一下完成

執行 Rational Team Concert for System z 語言定義產生器

  1. 展開您的專案節點。
  2. 選取 setuprtcz.xml 檔,然後選取執行身分 > Ant 建置
    註: setuprtcz.xml 是專案範例中所含的檔案名稱。如果您撰寫自己的檔案,請確定其副檔名為 .xml
  3. 選取「內容」標籤,並清除「使用 Ant 執行時期喜好設定中指定的廣域內容」旁的方框,然後新增下列內容:
    • repositoryAddress。這是您的 Rational Team Concert for System z URL。
    • userId。這是您的 Rational Team Concert for System z 使用者 ID。
    • password。這是您的 Rational Team Concert for System z 密碼。
    • projectArea。這是您專案區域的名稱。
  4. 選取 JRE 標籤,然後選取在和工作區相同的 JRE 中執行
  5. 按一下套用,然後按一下執行 只要語言定義產生器順利執行,就會建立好所有必要的資料集定義、轉換器和語言定義,並且會更新您所選專案中的所有 meta 資料,而指向新定義。
  6. 移至「擱置的變更」視圖,並驗證您對 meta 資料的變更。
  7. 移至「工作項目」視景,用滑鼠右鍵按一下您的專案區域,並按一下重新整理 在「團隊構件」視圖中,新的資料集定義、語言定義與轉換器應該都會顯示在您的專案區域中。

語言定義產生器 Ant 作業

使用 Rational Team Concert for System z 語言定義產生器來執行下列的自訂 Ant 作業。每一個作業名稱各代表一個實作該作業的 Java™ 類別名稱。

InitTask

執行這項作業的原因和時機
InitTask 是一項自訂 Ant 作業,它會起始設定 Rational Team Concert for System z 伺服器連線,以執行其他的資料集定義、轉換器與語言定義作業。必須先執行 InitTask,才能執行其他任何的資料集定義、轉換器或語言定義作業。
表 1. InitTask 參數
屬性 說明
repositoryAddress Rational Team Concert for System z 伺服器的 URL 字串
userId Rational Team Concert for System z 使用者 ID
password Rational Team Concert for System z 密碼
passwordFile Rational Team Concert for System z 密碼檔
projectArea 用來儲存相關聯資料集定義、轉換器與語言定義的專案區域名稱。
範例
以下是 InitTask 範例:

<ld:init repositoryAddress="https://opusdejazz.raleigh.ibm.com:9443/jazz"userId="tami" password="tami" projectArea="Build Test"/>

DsDefTask

執行這項作業的原因和時機
這項作業用來建立資料集定義。
表 2. DsDefTask 參數
屬性 說明 預設值
name 定義名稱  
description 定義說明  
dsName 資料集名稱  
dsMember 成員名稱  
prefixDSN true 是否應該將您在建置要求中指定的字首,附加到資料集名稱的前面。 true
dsDefUsageType
  • 0 = zFolder
  • 1 = 新建
  • 2 = 暫用
  • 3 = 現有
0 (zFolder)
dsType
  • 0 = PDSE
  • 9 = 未指定
0 (PDSE)
storageClass 要指派資料集的儲存類別。  
dataClass 用來建立資料集的資料類別。  
managementClass 用來管理資料集的管理類別。  
volumeSerial 資料集磁區序號  
GenericUnit 通用群組名稱或裝置位址  
spaceUnits 要使用的配置空間單位。值必須是下列其中一項:
  • trks(追蹤)
  • blks(區塊)
  • cyls(磁柱)
 
recordUnit 配置數量的單位。值必須是下列其中一項:
  • U(單一)
  • K(千)
  • M(百萬)
U
primaryQuantity 主要配置數量 1
secondaryQuantity 次要配置數量 1
directoryBlocks 所提供的 256 位元組目錄區塊數目。 0
recordLength 邏輯長度(以位元組為單位) 80
blockSize 區塊大小  
recordFormat z/OS® 資料集記錄格式字串,例如 F、FB、V、VB 或 U。可能的值包括下列:
  • F(固定)
  • V(可變)
  • U(未定義)
  • B(區塊)
  • A(指定檔案含有 ASA 控制字元。)
  • M(指定檔案含有機器控制字元。)
  • S(若為固定,則是標準格式;若為可變,則是擴充格式)
  • T(截斷)
FB
範例
以下是 DsDefTask 範例:

<!-- zFolder --> <ld:dsdef name="COBOL" dsName="COBOL" dsDefUsageType="0" dsType="0" spaceUnits="cyls" primaryQuantity="1" secondaryQuantity="1" recordFormat="FB" recordLength="80" blockSize="0" />
<!-- 新資料集 --> <ld:dsdef name="OBJ" dsName="OBJ"  dsDefUsageType="1" dsType="0" spaceUnits="cyls" primaryQuantity="1" secondaryQuantity="1" recordFormat="FB" recordLength="80" blockSize="0" /> <ld:dsdef name="LOAD" dsName="LOAD"  dsDefUsageType="1" dsType="0" spaceUnits="cyls" primaryQuantity="1" secondaryQuantity="1" recordFormat="U" recordLength="0" blockSize="32760" />
<!-- 暫用資料集 --> <ld:dsdef name="TEMPFILE" dsDefUsageType="2" prefixDSN="false" dsType="9" spaceUnits="trks" primaryQuantity="5" secondaryQuantity="5" genericUnit="SYSALLDA" />
<!-- 現有資料集 --> <ld:dsdef name="IGYCRCTL" dsName="COBOL.V4R1M0.SIGYCOMP" dsMember="IGYCRCTL" dsDefUsageType="3" prefixDSN="false"/> <ld:dsdef name="IEWBLINK" dsMember="IEWBLINK" dsDefUsageType="3" prefixDSN="false"/> <ld:dsdef name="SCEELKED" dsName="CEE.SCEELKED" dsDefUsageType="3" prefixDSN="false"/>

TranslatorTask

執行這項作業的原因和時機
這項作業用來建立轉換器。TranslatorTask 可接受 AllocationConcatenation 作為子元素。
表 3. TranslatorTask 參數
屬性 說明 預設值
name 轉換器名稱  
description 轉換器說明  
dataSetDefinition 轉換器模組的資料集定義  
ddnamelist 轉換器的替代 DD 名稱清單  
defaultOptions 傳遞給轉換器的選項字串。  
maxRC 容許的最大回覆碼 0
範例
以下是 TranslatorTask 範例:

<ld:translator name="ASMMAP" dataSetDefinition="ASMA90"
   defaultOptions="SYSPARM(MAP),DECK,NOOBJECT"
   ddnamelist="SYSLIN,,,SYSLIB,SYSIN,ANTPRINT"
   maxRC="0">
   <ld:concatenation name="SYSLIB">
      <ld:allocation dataSetDefinition="SDFHMAC"/>
      <ld:allocation dataSetDefinition="MACLIB"/>
   </ld:concatenation>
   <ld:allocation name="SYSIN" input="true"/>
   <ld:allocation name="SYSPUNCH" dataSetDefinition="OBJ" member="true"/>
   <ld:allocation name="ANTPRINT" dataSetDefinition="TEMPFILE"/>
   <ld:allocation name="SYSUT1" dataSetDefinition="TEMPFILE"/>
   <ld:allocation name="SYSUT2" dataSetDefinition="TEMPFILE"/>
   <ld:allocation name="SYSUT3" dataSetDefinition="TEMPFILE"/>
</ld:translator>

LangDefTask

執行這項作業的原因和時機
這項作業用來建立語言定義。
表 4. LangDefTask 參數
屬性 說明
name 語言定義名稱
description 語言定義說明
translators 轉換器的名稱,以冒號定界
defaultExtension 相關聯的預設副檔名
範例
以下是 LangDefTask 範例:

<ld:langdef name="BMS" translators="ASMMAP,ASMDSECT"defaultExtension=”bms”/>

DeleteDsDefsTask

執行這項作業的原因和時機
這項作業用來刪除所有的資料集定義。
範例
以下是 DeleteDsDefsTask 範例:

<ld:deletedsdefs/>

DeleteTranslatorsTask

執行這項作業的原因和時機
這項作業用來刪除所有的轉換器。
範例
以下是 DeleteTranslatorsTask 範例:

<ld:deletetranslators/>

DeleteLangDefsTask

執行這項作業的原因和時機
這項作業用來刪除所有的語言定義。
範例
以下是 DeleteLangDefsTask 範例:

<ld:deletelangdefs/>

ResolveMetadataTask

執行這項作業的原因和時機
這項作業用來讓 zFile 與語言定義相關聯,以及讓 zFolder 與資料集定義相關聯。這些關聯儲存在每一個 zComponent 專案的 .antzBuild 子目錄中。您可以使用 zFile 副檔名和給定語言定義的 defaultExtension 屬性,在 zFile 與語言定義之間建立關聯。例如,如果語言定義 COBOL 具有 defaultExtension 屬性 cbl,則 zFile HELLO.cbl 會與該語言定義相關聯。您可以使用 zFolder 的名稱和資料集定義的名稱,在 zFolder 與資料集定義之間建立關聯。例如,如果您的資料集定義名稱為 HELLO.COBOL,則 zFolder HELLO.COBOL 會與同名的資料集定義相關聯。
表 5.
屬性 說明 預設值
projectRoot zComponent 專案的根目錄 儲存 Script 的目錄。
範例
以下是 ResolveMetadataTask 範例:

<ld:resolvemetadata/>
<ld:resolvemetadata projectRoot="../AnotherProject"/>

語言定義產生器限制

執行這項作業的原因和時機
以下是 Rational Team Concert for System z 語言定義產生器的限制:
  • 語言定義產生器不支援使用建置內容作為替代。
  • 即使您未在相關聯的資料集定義或語言定義中進行任何變更,ResolveMetadataTask 也都會更新 meta 資料。

意見

以上說明對您有幫助嗎?您可以在 Jazz.net 網站中提供意見(需要登錄):在討論區中提供意見提交錯誤