As regras em um arquivo de mapeamento são delimitadas por linha e as seguintes
restrições se aplicam às regras de arquivo de mapeamento:
- A ferramenta de importação em massa ignora linhas em branco.
- A ferramenta de importação em massa ignora as linhas que começam com o sinal de sustenido (#).
- As linhas devem adotar o seguinte formato, em que rule-type deve
ser o caractere P, o caractere C,
o caractere L ou o caractere X:
rule-type:key=value
- P indica que uma regra mapeia um nome de membro qualificado
para o projeto zComponent e, opcionalmente, para o zFolder onde
ele deve ser colocado.
Nota: Após a regra P,
você tem a opção de especificar um zFolder para o qual o membro será
importado. Para isso, inclua [:zFolder] após a regra P e
coloque zFolder com o nome da pasta onde deseja importar
o membro. A linha deverá ser semelhante a essa: P:TEST.COBOL.HELLO=MyProject:MyFolder
Atenção: A qualificação do nome do membro na regra P não inclui
o qualificador de alto nível (HLQ).
- C indica que a regra mapeia um projeto zComponent
para o componente Jazz que deve contê-lo.
Importante: Se o projeto
zComponent no qual os membros são importados não corresponder a nenhuma regra C, esses membros não serão
importados.
- L indica que a regra mapeia um nome de membro qualificado
(sem um qualificador de alto nível) para o nome de uma definição de linguagem
para associar a ele.
Nota: Após a regra L,
você tem a opção de especificar um sufixo de file a ser anexado no zFile
importado. Para isso, inclua [:file suffix] após a regra L e
substitua o sufixo do arquivo pela extensão do arquivo que deseja
anexar ao zFile. A linha deverá ser semelhante a essa: L:TEST.COBOL.*=COBOL:cbl.
Importante: A definição de linguagem especificada já deverá existir na área do projeto que
você especificou na linha de comandos. A especificação das definições de linguagem
para os membros importados é opcional e os membros sem uma definição de linguagem associada ainda podem ser importados.
- X indica os membros a serem excluídos da importação
em massa.
Importante: Quaisquer membros que corresponderem a regra
principal X fornecida não serão importados.
O conteúdo de um arquivo de mapeamento poderá ser semelhante ao seguinte exemplo:
# Member to zComponent project mappings
# Specify the zComponent project and, optionally, the zFolder that will
# contain the imported members.
#
# Format:
# P:<member>=<zComponent project>[:<zFolder>]
P:MORTGAGE.*.(*).*=MortgageApp:%1
P:ALL.COBOL.*CALC=CalcApp:CobolSrc
P:ALL.COBOL.ATM*=ATMApp:CobolSrc
# zComponent project to Jazz Component mappings
# Specify the Jazz Component that each zComponent project will be shared to.
#
# Format:
# C:<zComponent project>=<Jazz Component>
C:MortgageApp=Mortgage
C:CalcApp=Sample Applications
C:ATMApp=Sample Applications
# Member to Language Definition mappings
# Optionally specify the Language Definition to associate with imported members.
#
# Format:
# L:<member>=<Language Definition name>
L:*.COBOL.*=COBOL:cbl
L:*.JCL.*=JCL
# Exclusion rules
# List members not to import
#
# Format:
# X:<member>
X:*.OBJ.*
Se você executar zimport para um PDS
denominado SMITH.MORTGAGE.BLD.COBOL, indicar SMITH como
o --hlq e especificar a regra de arquivo de mapeamento P:MORTGAGE.BLD.COBOL.*=MortgageApp,
todo o conteúdo do SMITH.MORTGAGE.BLD.COBOL será importado
para um projeto zComponent denominado MortgageApp dentro de um
zFolder chamado MORTGAGE.BLD.COBOL. Se, em vez disso, você especificar a regra de arquivo
de mapeamento P:MORTGAGE.BLD.COBOL.*=MortgageApp:CobolSRC,
o zFolder se chamará CobolSRC.