對映檔中的規則以字行定界,且對映檔規則會套用下列限制:
- 大量匯入工具會忽略空白行。
- 大量匯入工具會忽略以井字號 (#) 開頭的字行。
- 字行必須遵守以下格式,其中 rule-type 必須是 P 字元、C 字元、L 字元或 X 字元:
rule-type:key=value
- P 表示規則會將合格的成員名稱,對映至其所應放置的 zComponent 專案以及選擇性的 zFolder。
註: 在 P 規則之後,您可以選擇指定一個要匯入成員的 zFolder。其作法是在 P 規則之後新增 [:zFolder],並以要放置所匯入成員的資料夾名稱,取代 zFolder。這樣的字行可能類似如下:
P:TEST.COBOL.HELLO=MyProject:MyFolder
小心: P 規則中的成員名稱資格不包含高階限定元 (HLQ)。
- C 表示規則會將 zComponent 專案對映至應包含它的 Jazz™ 元件。
重要: 如果要匯入成員的 zComponent 專案不符合任何 C 規則,就不會匯入這些成員。
- L 表示規則會將合格的成員名稱
(不含高階限定元)對映至其相關聯的語言定義名稱。
註: 在 L 規則之後,您可以選擇指定一個檔案字尾,以附加至所匯入的 zFile 中。其作法是在 L 規則之後新增 [:file suffix],但以您要附加至 zFile 的副檔名,取代檔案字尾。這樣的字行可能類似如下:L:TEST.COBOL.*=COBOL:cbl。
重要: 指定的語言定義必須已存在於您在指令行上指定的專案區域中。為匯入的成員指定語言定義是選用的,成員即使沒有相關聯的語言定義仍然可以匯入。
- X 表示從大量匯入排除的成員。
重要: 凡是符合給定 X 索引鍵規則的成員都不會匯入。
對映檔的內容可能類似如下範例:
# 成員至 zComponent 專案的對映
# 指定 zComponent 專案,以及選擇性地指定 zFolder,# 以便包含匯入的成員。
#
# 格式:
# P:<member>=<zComponent project>[:<zFolder>]
P:MORTGAGE.*.(*).*=MortgageApp:%1
P:ALL.COBOL.*CALC=CalcApp:CobolSrc
P:ALL.COBOL.ATM*=ATMApp:CobolSrc
# zComponent 專案至 Jazz 元件的對映
# 指定要提供每一個 zComponent 專案供其共用的 Jazz 元件。
#
# 格式:
# C:<zComponent project>=<Jazz Component>
C:MortgageApp=Mortgage
C:CalcApp=Sample Applications
C:ATMApp=Sample Applications
# 成員至語言定義的對映
# 選擇性地指定要與匯入的成員相關聯的語言定義。
#
# 格式:
# L:<member>=<Language Definition name>
L:*.COBOL.*=COBOL:cbl
L:*.JCL.*=JCL
# 排除規則
# 列出不匯入的成員
#
# 格式:
# X:<member>
X:*.OBJ.*
如果您針對名稱為
SMITH.MORTGAGE.BLD.COBOL 的 PDS 執行 zimport 指令,並以 SMITH 代表 --hlq,以及指定對映檔規則 P:MORTGAGE.BLD.COBOL.*=MortgageApp,就會將 SMITH.MORTGAGE.BLD.COBOL 的所有內容,匯入至 zComponent 專案(名稱為 MortgageApp)的 zFolder(名稱為 MORTGAGE.BLD.COBOL)內。相反地,如果您指定對映檔規則 P:MORTGAGE.BLD.COBOL.*=MortgageApp:CobolSRC,則
zFolder 的名稱會是 CobolSRC。