Configurando o Shell Script do Rational Build Agent

O Jazz Build System contém um script de amostra denominado startbfa.sh que é possível usar para iniciar o Rational Build Agent.

É possível localizar o script de amostra no diretório @pathPrefix@/usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/startbfa, em que @pathPrefix@ é qualquer prefixo especificado ao instalar o SMP/E. Esse script é necessário para iniciar o Rational Build Agent para especificar credenciais de forma que o agente possa se conectar ao Jazz Team Server e para fornecer acesso às bibliotecas necessárias para o Ant com Extensões Corporativas e compilação nativa. Esse script é copiado para o diretório de configuração do Rational Team Concert, geralmente /etc/jazz40/ccm, pela tarefa BLZCPBTK.
Importante: O script deve ser configurado para adequar ao seu ambiente. Muitas das variáveis exigidas terão que ser configuradas pela tarefa de cópia e configuração BLZCPBTK. No entanto, algumas das variáveis, como informações de ID do usuário e senha, não serão configuradas automaticamente. Revise e substitua as sequências variáveis necessárias no script de amostra, conforme descrito na tabela a seguir:
Tabela 1. Cadeias de Variável de Script de Amostra
Variável Descrição
@pathPrefix@ Caminho do diretório para prefixar o diretório Jazz
Nota: Este é o prefixo para o diretório Jazz, portanto, seu prefixo deve incluir qualquer prefixo especificado como parte da instalação do SMP/E e, em seguida, /usr/lpp.
@javaPathPrefix@ O caminho do diretório para o IBM® SDK de 31 bits para Tecnologia z/OS Java 2.
@yourUserid@ O ID do usuário do Jazz
@yourPasswordFile@ O arquivo de senhas do Jazz conforme definido pela tarefa BLZBPASS. Consulte Running the Jazz Build Engine on z/OS para obter informações sobre como executar a tarefa BLZBPASS.
@stepLib@ A DD (definição de conjunto de dados) STEPLIB a ser usada na construção do z/OS. Por exemplo, SYS1.LINKLIB:CEE.SCEERUN
@bfaBinPath@ Caminho do diretório para o diretório do executável do Rational Build Agent.
@bfaConfPath@ Caminho do diretório para o diretório do arquivo de configuração do Rational Build Agent.
@zLang@ Codificação usada nos arquivos hosts. Por exemplo, IBM-037.
@timeout@ Valor de tempo limite, em segundos, para execução da etapa de construção. Se não especificado, o padrão será de 300 segundos.
@workPath@ Caminho do diretório em que os metadados são armazenados paraPDSEs. Por padrão, é /u/jazz40/ccm/.
@yourHomeDirectory@ Seu diretório inicial. Use isso apenas quando não tiver definido a variável de ambiente HOME em outro lugar.
_CMDSERV_BASE_HOME Indica o local dos arquivos fornecidos pelo ISPF para que o Rational Build Agent possa iniciar o gateway ISPF. Consulte Configurando o gateway ISPF para Suporte de Construção, Implementação e Promoção. para obter informações adicionais sobre _CMDSERV_BASE_HOME.
Quando estiver pronto para iniciar o Rational Build Agent e aceitar solicitações de construção, será possível executar o script startbfa.sh de uma das seguintes maneiras:
  • Inicie o script startbfa.sh manualmente a partir do OMVS
  • Configure a tarefa BLZBFA iniciada de amostra fornecida na biblioteca BLZ.SBLZSAMP, seguindo as instruções na tarefa. Será possível então executar o Build Forge Agent como uma tarefa iniciada na inicialização do sistema. Você deve copiar esta tarefa para um sistema alocado PROCLIB e configurar as definições de segurança necessárias para ela executar como uma tarefa iniciada.
Nota: A menos que outra shell seja especificada em seu arquivo bfagent.conf, a shell padrão (/bin/sh) é usada na sessão iniciada pelo Rational Build Agent em z/OS.  A shell padrão em z/OS sempre executa o script /etc/profile para definir configurações de todo sistema, depois que startbfa.sh executar é possível que algumas variáveis de ambiente definidas na shell script startbfa.sh possam ser substituídas.

Quando você executar um Ant com compilação de Enterprise Extensions ou construção de dependência com a opção –verbose ou –debug nos argumentos Ant, o comando de exportação do UNIX executará antes que o Ant seja chamado. É possível localizar as saídas do comando de exportação no registro da construção, para certificar-se de que as variáveis de ambiente estejam definidas corretamente.

Se algumas variáveis de ambiente forem substituídas por /etc/profile, solicite a seu programador de sistema que altere /etc/profile. Se não for possível alterar /etc/profile, você poderá usar o shell bash, que está disponível em z/OS Ported Tools. Especifique a opção –noprofile incluindo as duas linhas a seguir em seu arquivo bfagent.conf:
shell /bin/bash   
shellflag --noprofile 

Feedback