Instalando o Extrator RSE do Agente de Arquivo

Execute as etapas neste tópico para instalar e configurar o agente de arquivo do Explorador de Sistema Remoto (RSE).

Antes de Iniciar

Siga as etapas de instalação e configuração do servidor RSE e daemon no Rational Developer para System z Host Configuration Guide (SC23-7658-05).

Estas etapas requerem que você já tenha instalado o Build System Toolkit para System z. Caso não tenha concluído a instalação, consulte Instalando o Build System Toolkit no z/OS para obter mais informações.

Como a variável de ambiente CLASSPATH que pode ser especificada no sistema de arquivos z/OS possui uma limite de tamanho, você deve criar links symbolic para os arquivos Build System Toolkit .jar. É possível criar esses links simbólicos seguindo estas etapas:

Procedimento

  1. Configure o membro JCL de amostra BLZCRSYM no hlq SBLZSAMP, em que hlq é o qualificador de alto nível que você especificou durante a instalação do SMP/E. Essa tarefa cria um diretório de link simbólico em seu diretório jazz config, normalmente /etc/jazz/ccm, e contém links simbólicos para todos os arquivos .jar no diretório buildtoolkit. Envie o JCL modificado e o log da tarefa para certificar-se de que a tarefa seja concluída com código de retorno 0. A parte de SYSTSPRT da saída da tarefa lista o nome do arquivo .jar e o link simbólico que você criou; por exemplo, uma das linhas pode parecer com a seguinte:
    jar.6=com.ibm.team.filesystem.client_2.1.0.v20101021_0811.jar
    sym.6=jar6.jar
  2. Localize o arquivo rsed.envvars no diretório RSE configuration. Consulte rsed.envvars, RSE no Guia de Configuração do Host do Rational Developer para System z para obter instruções.
  3. Salve uma cópia desse arquivo usando o seguinte comando: cp rsed.envvars rsed.envvars.org
  4. Se usar OMVS, edite o arquivo rsed.envvars usando o comando ISPF 3.17 oedit (oedit rsed.envvars) ou o editor do Rational Developer para System z se usar RSE.
  5. Você deve designar instruções de caminho da classe, instruções de caminho da biblioteca e um local do diretório ativo. Localize a atribuição CLASSPATH, CLASSPATH=.:$CLASSPATH, no arquivo rsed.envvars. Para Java 1.6, imediatamente a frente da atribuição CLASSPATH, copie o número de amostra BLZENVAR de hlq.SBLZSAMP. Para Java 1.5, após a atribuição CLASSPATH, copie o membro de amostra BLZENV15 de hlq.SBLZSAMP. Para ambos os membros, hlq é o qualificador de alto nível especificado durante a instalação de SMP/E. Os membros contêm listas de atribuições CLASSPATH do Rational Team Concert. Para os dois níveis de Java, os membros de amostra também contêm declarações em stub das duas variáveis de ambiente LIB_PATH e SCM_WORK. Para esclarecimento sobre o que definir para essas variáveis de ambiente, revise os comentários no arquivo rsed.envvars.
    Nota: Aplique as adições de instrução de caminho da classe do Rational Team Concert para toda instância do servidor RSE no qual deseja executar o Rational Team Concert. Depois de executar as etapas de configuração, você deve recriar quaisquer conexões RSE que existiam anteriormente em seus clientes Rational Developer para System z.
    O exemplo a seguir mostra o arquivo Java 1.6 rsed.envvars. Ele inclui um aviso de modificação para mostrar como e onde customizar seu próprio arquivo rsed.envvars, de acordo com seu ambiente de construção.

    #
    # Insert the following Classpath allocation in the rsed.envvars file,
    # just prior to the CLASSPATH=.:$CLASSPATH statement
    #
    # Rational Team Concert
    #
    CLASSPATH=$CLASSPATH:'/etc/jazz/ccm/symlinks/*'

    # Uncomment and update the following statement to reference the install
    # path for RTC
    #LIBPATH=$LIBPATH:@pathPrefix@/usr/lpp/jazz/v3.0/buildsystem/buildtoolkit


    # Uncomment and update the following statement to reference the working
    # directory.
    # Working directories are typically stored in /u/jazz. You can change
    # this directory.
    #SCM_WORK=@workPath@

    A seguir está um exemplo do arquivo Java 1.5 rsed.envvars. Ele inclui um aviso de modificação para mostrar como e onde customizar seu próprio arquivo rsed.envvars, de acordo com seu ambiente de construção.

    #
    # Insert the following Classpath allocation in the rsed.envvars file,
    # just prior to the CLASSPATH=.:$CLASSPATH statement
    #
    # Rational Team Concert
    #
    RTC=/etc/jazz/ccm/symlinks

    CLASSPATH=$CLASSPATH:$RTC/jar1.jar
    CLASSPATH=$CLASSPATH:$RTC/jar2.jar
    CLASSPATH=$CLASSPATH:$RTC/jar3.jar
    CLASSPATH=$CLASSPATH:$RTC/jar4.jar
    CLASSPATH=$CLASSPATH:$RTC/jar5.jar
    CLASSPATH=$CLASSPATH:$RTC/jar6.jar
    CLASSPATH=$CLASSPATH:$RTC/jar7.jar
    CLASSPATH=$CLASSPATH:$RTC/jar8.jar
    CLASSPATH=$CLASSPATH:$RTC/jar9.jar
    CLASSPATH=$CLASSPATH:$RTC/jar10.jar
    CLASSPATH=$CLASSPATH:$RTC/jar11.jar
    CLASSPATH=$CLASSPATH:$RTC/jar12.jar
    CLASSPATH=$CLASSPATH:$RTC/jar13.jar
    CLASSPATH=$CLASSPATH:$RTC/jar14.jar
    CLASSPATH=$CLASSPATH:$RTC/jar15.jar
    CLASSPATH=$CLASSPATH:$RTC/jar16.jar
    CLASSPATH=$CLASSPATH:$RTC/jar17.jar
    CLASSPATH=$CLASSPATH:$RTC/jar18.jar
    CLASSPATH=$CLASSPATH:$RTC/jar19.jar
    CLASSPATH=$CLASSPATH:$RTC/jar20.jar
    CLASSPATH=$CLASSPATH:$RTC/jar21.jar
    CLASSPATH=$CLASSPATH:$RTC/jar22.jar
    CLASSPATH=$CLASSPATH:$RTC/jar23.jar
    CLASSPATH=$CLASSPATH:$RTC/jar24.jar
    CLASSPATH=$CLASSPATH:$RTC/jar25.jar
    CLASSPATH=$CLASSPATH:$RTC/jar26.jar
    CLASSPATH=$CLASSPATH:$RTC/jar27.jar
    CLASSPATH=$CLASSPATH:$RTC/jar28.jar
    CLASSPATH=$CLASSPATH:$RTC/jar29.jar
    CLASSPATH=$CLASSPATH:$RTC/jar30.jar
    CLASSPATH=$CLASSPATH:$RTC/jar31.jar
    CLASSPATH=$CLASSPATH:$RTC/jar32.jar
    CLASSPATH=$CLASSPATH:$RTC/jar33.jar
    CLASSPATH=$CLASSPATH:$RTC/jar34.jar
    CLASSPATH=$CLASSPATH:$RTC/jar35.jar
    CLASSPATH=$CLASSPATH:$RTC/jar36.jar
    CLASSPATH=$CLASSPATH:$RTC/jar37.jar
    CLASSPATH=$CLASSPATH:$RTC/jar38.jar
    CLASSPATH=$CLASSPATH:$RTC/jar39.jar
    CLASSPATH=$CLASSPATH:$RTC/jar40.jar
    CLASSPATH=$CLASSPATH:$RTC/jar41.jar
    CLASSPATH=$CLASSPATH:$RTC/jar42.jar
    CLASSPATH=$CLASSPATH:$RTC/jar43.jar
    CLASSPATH=$CLASSPATH:$RTC/jar44.jar
    CLASSPATH=$CLASSPATH:$RTC/jar45.jar
    CLASSPATH=$CLASSPATH:$RTC/jar46.jar
    CLASSPATH=$CLASSPATH:$RTC/jar47.jar
    CLASSPATH=$CLASSPATH:$RTC/jar48.jar
    CLASSPATH=$CLASSPATH:$RTC/jar49.jar
    CLASSPATH=$CLASSPATH:$RTC/jar50.jar
    CLASSPATH=$CLASSPATH:$RTC/jar51.jar
    CLASSPATH=$CLASSPATH:$RTC/jar52.jar
    CLASSPATH=$CLASSPATH:$RTC/jar53.jar
    CLASSPATH=$CLASSPATH:$RTC/jar54.jar
    CLASSPATH=$CLASSPATH:$RTC/jar55.jar
    CLASSPATH=$CLASSPATH:$RTC/jar56.jar
    CLASSPATH=$CLASSPATH:$RTC/jar57.jar
    CLASSPATH=$CLASSPATH:$RTC/jar58.jar
    CLASSPATH=$CLASSPATH:$RTC/jar59.jar
    CLASSPATH=$CLASSPATH:$RTC/jar60.jar
    CLASSPATH=$CLASSPATH:$RTC/jar61.jar
    CLASSPATH=$CLASSPATH:$RTC/jar62.jar
    CLASSPATH=$CLASSPATH:$RTC/jar63.jar

    # Uncomment and update the following statement to reference the install
    # path for RTC
    #LIBPATH=$LIBPATH:@pathPrefix@/usr/lpp/jazz/v3.0/buildsystem/buildtoolkit

    # Uncomment and update the following statement to reference the working
    # directory.
    # Working directories are typically stored in /u/jazz. You can change
    # this directory.
    #SCM_WORK=@workPath@

  6. Pare e reinicie o servidor e o daemon do RSE.

O que Fazer Depois

Crie um arquivo do agente chamado FileAgentConfiguration.dat no mesmo diretório onde o rsed.envvars está salvo. Esse arquivo .dat deve conter entradas separadas por vírgulas que identificam ums URL de repositório do Rational Team Concert para System z Jazz, um ID de usuário de agente de arquivo que você utilizará para autenticar o repositório Jazz, e uma senha de texto não criptografado ou um nome do caminho completo de um arquivo de senha criptografada para esse ID de usuário. Por exemplo:

https://myexample.jazz.repository.com:9443/jazz, myrepouserid, /pathToMyEncryptedPasswordFile
Nota: A URL do repositório que você especifica no arquivo FileAgentConfiguration.dat deve resolver para o mesmo endereço de IP que as URLs de repositório que você especificou no cliente.

Para obter mais informações sobre como criar um arquivo de senha criptografada, consulte Criando um Arquivo de Senhas Usando a Tarefa de Amostra BLZBPASS.


Feedback