Incluindo um artefato no Rational Team Concert para System z

A inclusão de um artefato no Rational Team Concert para System z envolve a utilização de um artefato criado usando o Rational Developer para System z e disponibilizando-o para o gerenciamento do controle de origem do Rational Team Concert para System z.

Para este exemplo, você criará um novo programa COBOL usando o Rational Developer para System z e o incluirá no repositório do Rational Team Concert para System z para controle de origem. Você pode incluir membros do subprojeto do MVS do Rational Developer para System z no Rational Team Concert para System z usando o assistente Compartilhar Membros como zFiles.

Conclua as seguintes etapas. (Estas etapas usam exemplos do tutorial como ilustrações).

  1. Na visualização Sistemas Remotos, selecione o programa COBOL que criou na seção de carregamento do exemplo, clique com o botão direito do mouse e selecione Criar Membro PDS.
    Menu de contexto do Explorador de Sistema Remoto mostrando "Criar Membro PDS"
  2. Insira um nome para o novo programa COBOL no campo Nome do Membro do painel Novo Membro PDS e clique em Concluir. Para este exemplo, denominamos o o novo programa de Goodbye.
    Painel Criar Membro PDS mostrando o nome do novo programa COBOL "Goodbye" no campo Nome do Membro.
    O novo programa COBOL aparecerá no mesmo conjunto de dados do programa HELLO.cbl.
    Explorador de Sistema Remoto mostrando o novo "GOODBYE.cbl" no Mesmo Conjunto de Dados de "HELLO.cbl"
  3. Inclua um novo programa no subprojeto do MVS arrastando-o da visualização Sistemas Remotos e soltando-o no subprojeto na visualização Projetos do z/OS.
    Visualização Projeto do z/OS Mostrando o Novo "GOODBYE.cbl" no Mesmo Subprojeto do MVS como "HELLO.cbl." O novo programa não mostra o mesmo decorador do programa existente porque ele ainda não está sob o controle de origem do Rational Team Concert para System z
    Nota: O novo programa BGREEN.BLD.COBOL(GOODBYE.cbl) não possui o decorador de arquivo ouro que o BGREEN.BLD.COBOL(HELLO.cbl) possui, porque ele ainda não está sob o controle de origem do Rational Team Concert para System z.
Conclua as seguintes etapas para incluir o programa no controle de origem do Rational Team Concert para System z:
  1. No subprojeto do MVS na visualização Projetos do z/OS, clique com o botão direito do mouse em BGREEN.BLD.COBOL(GOODBYE.cbl) e selecione zComponent > Compartilhar Membros como zFiles.
    Visualização do Projeto z/OS mostrando o menu de contexto para a seleção de "Compartilhar Membros como zFiles"
  2. Por padrão, o nome do programa que está sendo incluído será pré-selecionado no primeiro painel do assistente Compartilhar Membros como zFiles. Clique em Avançar.
  3. Selecione o projeto zComponent com o qual deseja compartilhar o novo programa e clique em Avançar. É possível criar também um novo projeto do zComponent, mas para esse exemplo estamos usando o projeto criado no Usando as Extensões de Construção do Rational Build Agent e Antz para Compilar um Aplicativo COBOL.
    Painel do projeto "Escolher um zComponent" mostrando o projeto zComponent existente e a opção para criar um novo projeto zComponent
  4. No painel Compartilhar Projeto do zComponent com o Repositório Jazz, selecione o mesmo componente que contém o programa HELLO.cbl. Clique em Avançar.
    Painel "Compartilhar Projeto zComponent com Repositório Jazz" mostrando o repositório Jazz e componente em uma área de trabalho do repositório existente
  5. No painel Especificar Contexto de Construção, clique em Procurar e selecione uma definição de construção. Para esse exemplo, selecione Construção da Equipe de Hipoteca.
    Painel "Selecionar Definição de Construção" mostrando a definição de construção denominada "Construção da Equipe de Hipoteca"
    Clique em OK > Avançar. A definição de construção será associada à área de trabalho do repositório do Rational Team Concert para System z.
    Nota: Depois de você executar o assistente Carregar zFiles para z/OS ou o assistente Compartilhar Membros como zFiles e escolher uma definição de construção para uma área de trabalho do repositório, a definição de construção será associada a essa área de trabalho do repositório. Quaisquer execuções subsequentes dos assistentes exibirão os detalhes da definição de construção associada, mas mas não permitirão que você os altere. É possível limpar o contexto de construção desconectando todos os membros.
  6. Uma definição de construção normalmente especifica o prefixo que a equipe de construção usa. Para certificar-se de que você trabalhar nos artefatos isoladamente, altere o prefixo especificado na definição de construção para o seu próprio prefixo. Para modificar o prefixo, selecione teamz.scm.dataset.prefix na lista Propriedades de Construção e clique em Editar.
  7. No painel Selecionar Tipo de Propriedade, selecione Cadeia na lista de novos tipos de propriedades e clique em OK.
    Painel "Selecionar Tipo de Propriedade" mostrando lista de opções para o tipo de nova propriedade
  8. No painel Editar Propriedade de Pedido de Construção altere o valor de MASAO.BLD para seu prefixo e clique em OK. (Para esse exemplo, alteramos o valor para BGREEN.BLD.)
    Painel "Editar Pedido de Construção" mostrando valor alterado para BGREEN.BLD
    Importante: Certifique-se de que as credenciais usadas para fazer a conexão do RSE ao host têm a autoridade para criar e modificar um conjunto de dados com o prefixo configurado no campo de valor.
  9. Clique em Avançar.

Quando o novo programa for incluído no projeto zComponent ele será colocado em uma zFolder. Essa zFolder deverá ser associada a uma definição de conjunto de dados.

É possível alterar associações de definição de conjunto de dados. O painel usado para esse exemplo mostra o nome correto do conjunto de dados (BGREEN.BLD.COBOL), mas uma definição incorreta do conjunto de dados do repositório (BMS).

Painel "Associar Definições do Conjunto de Dados" mostrando a definição incorreta do conjunto de dados do repositório "BMS"

Conclua as seguintes etapas para alterar a associação:
  1. No painel Associar Definições do Conjunto de Dados, clique no botão <...> no título Procurar.
  2. Selecione a definição de conjunto de dados COBOL e clique em OK.
    Painel "Selecionar uma Definição de Conjunto de Dados" mostrando "COBOL" selecionado como a opção de definição de conjunto de dados
  3. Você pode associar também as definições de linguagem ao associar as definições de conjunto de dados. Se você não associar as definições de linguagem aqui, deverá associar as definições de linguagem para todos os arquivos que deseja construir antes de solicitar uma construção.
  4. No painel Associar Definições de Conjunto de Dados atualizado, verifique se a definição de conjunto de dados do repositório está correta. Para esse exemplo, é COBOL.
    Painel "Associar Definições do Conjunto de Dados" mostrando a definição correta do conjunto de dados do repositório "COBOL"
  5. Na última página do assistente Compartilhar Membros como zFiles, você tem a opção de copiar ou mover os membros. Se você optar por Copiar, o membro ficará em seu conjunto de dados original e uma cópia será colocada no novo local especificado pela definição de conjunto de dados e o prefixo. Se você optar por Mover, o membro será movido e excluído do conjunto de dados original.
  6. Clique em Concluir.

Verificando se o Compartilhamento Foi Bem-sucedido

No Explorador de Projetos, confirme se o programa GOODBYE.cbl foi incluído no projeto zComponent.
Visualização "Explorador de Projetos" mostrando "GOODBYE.cbl" no projeto zComponent
Dica: Se o assistente Compartilhar Membros como zFiles terminar em erro, abra o arquivo .log na pasta .metadata na área de trabalho do Eclipse, para obter informações adicionais.