Definindo e Executando uma Construção Usando o Rational Build Agent

Antes de Iniciar
Você já deve ter criado uma área do projeto no Rational Team Concert para System z.
Por Que e Quando Desempenhar Esta Tarefa
Esta tarefa será relevante se você estiver incluindo uma definição de construção em sua área do projeto e desejar usar o Rational Build Agent. Certifique-se de que tenha criado uma área do projeto e que deseja incluir uma definição de construção que usa o Rational Build Agent.
  1. Se ainda não tiver iniciado o Rational Build Agent, inicie-o agora usando o comando bfagent -s, conforme mencionado na seção sobre como configurar o Rational Build Agent.
    Importante: Os comandos executados por meio do Rational Build Agent são executados com a autoridade do usuário que inicia o agente.
  2. Localize o membro BLZCSAMP em hlq.SBLZSAMP, em que hlq é o qualificador de alto nível usado durante a instalação SMP/E do Rational Team Concert para System z. Observe que este membro é realmente instalado como parte da instalação do FMID HAHB200. O membro BLZCSAMP fornece um executável REXX de amostra para concluir uma compilação COBOL. Revise os comentários neste membro de amostra para entender os parâmetros e customização que podem ser necessários para seu ambiente.

Configurando e Executado uma Definição de Construção

  1. Na visualização Artefatos do Projeto, expanda a pasta da área do projeto na qual deseja criar uma definição de construção.
  2. Clique com o botão direito do mouse em Construções > Nova Definição de Construção.
  3. Na janela Nova Definição de Construção, desmarque Linha de Comandos de Pré-Construção e Linha de Comandos de Pós-Construção, selecione Criar nova construção e clique em Avançar.
  4. Na janela Informações Gerais, insira um ID de definição de construção e uma descrição breve da definição de construção.
    Importante: Selecione Rational Build Agent no menu Modelos Disponíveis.
    Clique em Avançar.
  5. Na janela Configuração Adicional, selecione Geral, Propriedades e Rational Build Agent e clique em Concluir. A definição de construção criada é aberta no editor de Definição de Construção.

Executando um Teste de Conexão com o Rational Build Agent

  1. Clique na guia Build Agent criada nas etapas anteriores.
  2. Insira as seguintes informações para conectar-se ao Rational Build Agent:
    Nome do Host
    O nome do sistema que usa o Rational Build Agent.
    Porta
    A porta que comunica-se com o Rational Build Agent. O padrão é a porta 5555.
    Nome do usuário
    O nome do usuário que está conectando-se ao Rational Build Agent.
    Nota: Este nome de usuário é usado para autenticar a conexão com o sistema. Ele não precisa ser o mesmo nome de usuário que iniciou o agente.
    Senha
    A senha para o nome de usuário fornecido.
    Confirmar Senha
    Digite a senha novamente para o nome de usuário fornecido.
  3. Clique em Testar Conexão. Os resultados do teste de conexão são exibidos na caixa Resultados do Teste de Conexão do Rational Build Agent.

Definindo um Bloco de Comandos para Ser Executado pelo Rational Build Agent

  1. Clique na guia Linha de Comandos do Build Agent.
  2. No campo Comando, insira um comando de processo para ser enviado ao Rational Build Agent.
  3. No campo Diretório de Trabalho, insira o diretório de trabalho que deseja que o processo chamado utilize.
  4. Clique em Salvar para salvar a definição de construção.
    Dica: A primeira vez que você salvar uma definição de construção, um novo mecanismo de construção chamado RationalBuildAgent será definido para a área do projeto. Certifique-se de que RationalBuildAgent seja o mecanismo de construção selecionado na guia Geral da definição de construção.
Exemplo
Para executar a amostra fornecida, você pode configurar um bloco de comandos no campo Comando semelhante ao seguinte exemplo:
tso "EXEC 'BGREEN.BETA.SBLZSAMP(BLZCSAMP)''/tmp/RTCZSYSPRINT COBOL.V4R1M0.SIGYSAMP"
cat /tmp/RTCZSYSPRINT
rm /tmp/RTCZSYSPRINT

Solicitando uma Construção

  1. Na visualização Artefatos da Equipe, clique com o botão direito do mouse na definição de construção e selecione Pedir Construção. Como alternativa, clique no ícone Pedir Construção no canto direito superior da janela Definição de Construção. A janela Pedir Construção é aberta.
  2. Clique em Enviar. A janela Construções é aberta.
    Dica: Para monitorar o progresso de sua construção durante o seu processamento, clique em Atualizar.

Verificando os Resultados da Construção

  1. Depois que a construção ser concluída, clique duas vezes na sua construção na guia Construções para visualizar os resultados da construção.
  2. Na seção Resumo de Contribuição, clique em log para visualizar a guia Logs.
  3. Selecione o log e clique em Abrir para exibir os resultados de construção detalhados, incluindo informações do Rational Build Agent e os resultados do bloco de comandos inserido.