Formato do Arquivo de Mapeamento da Ferramenta de Importação em Massa

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.