Opções Suportadas pela Ferramenta de Importação em Massa

Este tópico lista e descreve brevemente as opções disponíveis através da ferramenta de importação em massa.
Execute o comando de importação em massa, zimport, a partir da interface de linha de comandos (CLI) do Rational Team Concert para System z. A ferramenta de importação em massa suporta as seguintes opções:
-r
Para repositoryURI. Use essa opção para especificar o local do repositório para o qual deseja importar os membros do conjunto de dados particionado (PDS).
-u
Para user. Use essa opção para especificar um nome de usuário para o repositório.
-P
Para password. Use essa opção para especificar uma senha do repositório.
Importante: Use um P maiúsculo para essa opção e não um p minúsculo.
--hlq
Para HLQ. Use essa opção para especificar o qualificador de alto nível (HLQ) dos conjuntos de dados particionados que deseja importar.
--mapfile
Para file. Use essa opção para especificar o local do arquivo de mapeamento a ser usado. Esse arquivo de mapeamento descreve a estrutura do projeto para o qual deseja importar os membros do PDS. É necessário especificar sempre o local do arquivo de mapeamento e seu arquivo de mapeamento deve conter os seguintes dois tipos de mapeamento:
  • Mapeamento a partir dos membros do PDS para o projeto zComponent para o qual deseja importá-los.
  • Mapeamento do projeto zComponent para o componente Jazz ao qual o projeto pertence.
É opcional para o arquivo de mapeamento conter mapeamento a partir dos membros para a definição de linguagem associada.
Lembre-se: A definição de linguagem já deverá existir na área do projeto especificada.
--projectarea
Para projectArea. Use essa opção para especificar o nome da área do projeto na qual as definições do conjunto de dados que estão relacionadas aos membros importados devem ser armazenadas. Isso deve ser a mesma área do projeto na qual as definições de linguagem relacionadas são armazenadas.
-s
Opcional: para stream. Use essa opção para especificar o nome, o alias ou o UUID do fluxo que deseja configurar como o destino de fluxo padrão para a área de trabalho do repositório que é criada com a importação em massa.
-q
Opcional: Para quiet. Use essa opção para suprimir a saída do console.
-v
Opcional: Para verbosidade. Use essa opção para aumentar a verbosidade da saída.

Formato de Arquivo de Mapeamento

O arquivo de mapeamento é delimitado por linha, em que cada linha deve seguir esse formato: <caractere identificador> : <chave> = <valor>. A tabela a seguir indica possíveis combinações de linha. Para obter mais informações sobre as restrições da regra de arquivo de mapeamento, consulte Formato do Arquivo de Mapeamento da Ferramenta de Importação em Massa.
Tabela 1. Combinações da Linha de Importação em Massa
Identificador Chave Valor Notas
O Nome do projeto zComponent Nome do componente Jazz Especifica a qual Componente Jazz um projeto zComponent deve pertencer. Os projetos zComponent que não corresponderem às regras de nome de projeto especificadas no arquivo de mapeamento não poderão ser importados.
P1, 2 Nome completo do membro (não incluindo o HLQ) Nome do projeto zComponent [nome :zFolder] Especifica para quais projetos do zComponent os membros do PDS devem ser importados. É possível usar caracteres curingas na chave, indicados por um asterisco (*), para especificar vários membros a serem colocados no mesmo projeto zComponent. Os membros que não corresponderem a uma regra de nome de membro especificada no arquivo de mapeamento não poderão ser importados.
L1 Nome completo do membro (não incluindo o HLQ) Nome da definição de linguagem [sufixo :file] Especifica uma definição de linguagem a ser associada aos membros importados. Observação: A definição de linguagem já deverá existir na área do projeto. É possível usar caracteres curingas (*) na chave para especificar vários membros a serem associados a uma definição de linguagem.
X1 Nome completo do membro (não incluindo o HLQ) nenhum Especifica os membros a serem excluídos da importação em massa. É possível usar caracteres curingas (*) na chave para especificar vários membros a serem excluídos. Quaisquer membros que corresponderem a uma determinada chave não serão importados.
Importante:
  1. Para os identificadores P, L e X, os membros são referenciados usando as cadeias de correspondência padrão que consistem do nome do PDS (sem o HLQ), seguido por um ponto e depois pelo nome do membro. Por exemplo, o membro HELLO no PDS SMITH.TEST.COBOL seria correspondido ao padrão TEST.COBOL.HELLO. O padrão TEST.COBOL.* corresponderia a quaisquer membros no conjunto de dados nomeado SMITH.TEST.COBOL. Por padrão, os membros são importados como zFiles com o mesmo nome do membro. É possível especificar um nome de definição de linguagem como esse, por exemplo:

    L:TEST.COBOL.*=COBOL:cbl

    Ao anexar essa extensão de arquivo, como por exemplo .cbl, duas coisas acontecem:
    1. A definição de linguagem COBOL é associada a quaisquer membros que corresponderem à regra.
    2. A extensão .cbl será anexada ao nome do arquivo dos zFiles importados.
  2. Para o identificador P, por padrão, zimport importa os membros de um PDS de um projeto zComponent especificado em uma zFolder com o mesmo nome do PDS. Opcionalmente, é possível alterar o nome da zFolder ao incluir dois pontos (:) após o nome do projeto zComponent seguido por um nome zFolder de sua escolha. Por exemplo, se desejar importar todos os membros de um PDS chamado MORT.BLD.TEST no projeto zComponent MortgageApp em uma zFolder chamada MORT.BLD, a regra de arquivo de mapeamento deverá ser P:MORT.BLD.TEST.*=MortgageApp:MORT.BLD.
  3. Também é possível fazer referências de volta em qualquer linha no arquivo de mapeamento usando parênteses na chave e %n no valor. Por exemplo, se desejar importar todos os membros em qualquer PDS chamado MORT.*.BLD.TEST de um projeto zComponent chamado MORTApp nas zFolders nomeadas entre MORT. e .BLD, poderá gravar a regra como P:(MORT).(*).BLD.TEST.*=%1App:%2.