大量匯入工具支援的選項

這個主題列出並簡要說明透過大量匯入工具所提供的選項。
請從 Rational Team Concert™ for System z® 指令行介面 (CLI) 來執行大量匯入指令 zimport。大量匯入工具支援的選項如下:
-r
代表 repositoryURI。這個選項用來指定您要匯入分割資料集 (PDS) 成員的儲存庫位置。
-u
代表 user。這個選項用來指定儲存庫的使用者名稱。
-P
代表 password。這個選項用來指定儲存庫的密碼。
重要: 針對這個選項請使用大寫 P,而非小寫 p。
--hlq
代表 HLQ。這個選項用來指定您要匯入之分割資料集的高階限定元 (HLQ)。
--mapfile
代表 file。這個選項用來指定要使用之對映檔的位置。這個對映檔說明您要匯入 PDS 成員的專案結構。您必須一律指定對映檔的位置,且對映檔必須包含下列兩種類型的對映:
  • 從 PDS 成員對映至要匯入這些成員的 zComponent 專案。
  • 從 zComponent 專案對映至專案所隸屬的 Jazz™ 元件。
您的對映檔也可以選擇性地包含從成員至其相關聯語言定義的對映。
記住: 語言定義必須已存在於您指定的專案區域中。
--projectarea
代表 projectArea。這個選項用來指定專案區域名稱,以便儲存所匯入成員的相關資料集定義。這和儲存相關語言定義的專案區域應該是同一個。
-s
選用項目:代表 stream。這個選項用來指定您要設定為儲存庫工作區(因大量匯入而建立)預設流程目標之串流的名稱、別名或 UUID。
-q
選用項目:代表 quiet。這個選項用來抑制主控台輸出。
-v
選用項目:代表 verbosity。這個選項用來增加輸出的詳細程度。

對映檔格式

對映檔為字行定界,因此每一行都必須遵循以下格式:<ID 字元> : <索引鍵> = <值> 下表指出可能的字行組合。如需對映檔規則限制的相關資訊,請參閱 大量匯入工具對映檔格式
表 1. 大量匯入的字行組合
ID 索引鍵 Notes®
C zComponent 專案名稱 Jazz 元件名稱 指定 zComponent 專案應隸屬於哪一個 Jazz 元件。只要 zComponent 專案不符合對映檔中指定的專案名稱規則,就無法匯入。
P1, 2 完整的成員名稱(不包含 HLQ) zComponent 專案名稱 [:zFolder 名稱] 指定 PDS 成員應匯入至哪些 zComponent 專案中。您可以在索引鍵中使用以星號 (*) 表示的萬用字元,指定將多個成員放入相同的 zComponent 專案中。只要成員不符合對映檔中指定的成員名稱規則,就無法匯入。
L1 完整的成員名稱(不包含 HLQ) 語言定義名稱 [:檔案字尾] 指定一項語言定義,以便與匯入的成員相關聯。請謹記:語言定義必須已存在於專案區域中。您可以在索引鍵中使用萬用字元 (*),指定多個成員來與語言定義相關聯。
X1 完整的成員名稱(不包含 HLQ) 指定要從大量匯入排除的成員。您可以在索引鍵中使用萬用字元 (*),指定多個要排除的成員。只要成員符合給定的索引鍵,就不會匯入。
重要事項:
  1. PLX ID 而言,成員是利用型樣相符字串來參照,這些字串依序由 PDS 名稱(不含 HLQ)、句點和成員名稱所組成。例如,PDS SMITH.TEST.COBOL 中的 HELLO 成員就符合 TEST.COBOL.HELLO 型樣。而名稱為 SMITH.TEST.COBOL 之資料集中的任何成員,就符合 TEST.COBOL.* 型樣。依預設,成員將匯入成 zFile,且其名稱和成員相同。您可以用這種方式來指定語言定義名稱,例如:

    L:TEST.COBOL.*=COBOL:cbl

    在您附加 .cbl 之類的副檔名時,會出現下列兩種情況:
    1. 語言定義 COBOL 會與任何符合規則的成員相關聯。
    2. .cbl 會附加至您所匯入之 zFile 的檔名中。
  2. P ID 來說,依預設,zimport 會將 PDS 中的成員匯入至指定的 zComponent 專案,再匯入至與 PDS 同名的 zFolder 中。您可以選擇性地變更 zFolder 的名稱,在 zComponent 專案名稱後面新增一個冒號 (:),後面接著您所選的 zFolder 名稱。例如,如果您想將名稱為 MORT.BLD.TEST 之 PDS 中的所有成員,匯入至 zComponent 專案 MortgageApp 中名稱為 MORT.BLD 的 zFolder 下,則對映檔規則應該是 P:MORT.BLD.TEST.*=MortgageApp:MORT.BLD
  3. 您也可以在對映檔的任何字行中採取向後參照,其作法是在索引鍵中使用括弧,在值中使用 %n。例如,如果您想將名稱為 MORT.*.BLD.TEST 之任何 PDS 中的所有成員,匯入至 名稱為 MORTApp 之 zComponent 專案中其名稱介於 MORT..BLD 之間的 zFolder 內,您可以將規則撰寫成 P:(MORT).(*).BLD.TEST.*=%1App:%2

意見

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