Coleta de rastreio IBM MQ Explorer em outros ambientes Eclipse

Ao usar uma variante do comando runwithtrace , você pode coletar rastreio a partir de uma instância do IBM® MQ Explorer que é instalado em seu próprio produto Eclipse ou produto baseado em Eclipse.

Antes de Iniciar

Esta tarefa assume que você instalou IBM MQ Explorer em seu próprio ambiente Eclipse ou produto baseado em Eclipsee, portanto, não pode usar o comando padrão runwithtrace como descrito em Coleta do rastreio IBM MQ Explorer.

Sobre esta tarefa

IBM MQ Explorer pode ser instalado em seu próprio ambiente Eclipse ou produto baseado em Eclipsepara ajudar a desenvolver aplicativos Java , ou para desenvolver suas próprias extensões.

Para coletar rastreio, você usa um comando runwithtrace para iniciar o IBM MQ Explorer. Não é possível usar o comando runwithtrace que é fornecido com o produto. Em vez disso, use uma variante do comando, conforme descrito no procedimento a seguir.

Nota: Você normalmente habilitar o rastreio apenas quando solicitado a fazê-o fazer por seu Representante de Serviço IBM . O rastreio diminui o IBM MQ Explorer e os arquivos de rastreio podem rapidamente tornar-se grandes.

Procedimento

  1. O mecanismo de rastreio do IBM MQ Explorer conta com plug-ins AspectJ e Equinox Weaving sendo instalados. Para confirmar que eles estão instalados:
    1. Clique em Ajuda
    2. Clique em Sobre ...
    3. Clique em Detalhes da Instalação
    4. Clique na guia Plug-ins .
    O plug-in org.eclipse.equinox.weaving.caching.j9 não existe mais, mas você requer este plug-in se você estiver usando IBM MQ 9.0 Suporte A Longo Prazo, ou IBM MQ 9.0 Entrega Contínua releases, anteriores a IBM MQ 9.0.4.
    Verifique se os plug-ins a seguir estão instalados:
    
    	org.aspectj.runtime
    	org.aspectj.weaver
    
    	org.eclipse.equinox.weaving.aspectj
    	org.eclipse.equinox.weaving.caching
    	org.eclipse.equinox.weaving.caching.j9
    	org.eclipse.equinox.weaving.hook
    
  2. Se eles ainda não estiverem instalados, instale os plug-ins AspectJ e Equinox Weaving. Esses plug-ins devem corresponder à versão do Eclipse que você está usando e podem ser transferidos por download do site de download do Eclipse AspectJ Development Tools. Para determinar qual site de download usar para a sua versão do Eclipse, consulte https://projects.eclipse.org/projects/tools.ajdt.

    Para obter informações sobre o nível Eclipse que o IBM MQ Explorer é construído em, veja O que há de novo e o que mudou no IBM MQ Explorer.

    Atualmente, essas construções estão disponíveis apenas como construções de desenvolvimento; é necessário selecionar a mais recente disponível.

    Para instalar os plug-ins AspectJ e Equinox Weaving, conclua as subetapas a seguir:
    1. Clique em Ajuda em seguida, clique em Instalar o Novo Software ...
    2. Clique em Adicionar ... em seguida digite o local do site de download apropriado para a versão Eclipse.
      Por exemplo, para o Eclipse 4.4, insira https://download.eclipse.org/tools/ajdt/44/dev/update.
    3. Clique em OK
      Uma lista dos softwares disponíveis é exibida.
    4. Expanda a categoria Outras Ferramentas AJDT (Opcional) e selecione AspectJ Compiler e Equinox Weaving SDK.
    5. Clique em Avançar e siga as instruções do assistente.
  3. Rastreio IBM MQ Explorer.

    Feche e reinicie o IBM MQ Explorer usando o script runwithtrace . Para o script usar para sistemas operacionais Windows , consulte script de comando runwithtrace para Windows. Para que o script use para os sistemas operacionais Linux® , consulte runwithtrace command script para Linux.

    O script deve ser executado a partir do diretório que contém o arquivo executável do Eclipse.

    Ao iniciar o IBM MQ Explorer usando o comando runwithtrace , os parâmetros extras são incorporados que permitem o rastreio do IBM MQ Explorer. Observe que o comando runwithtrace não utiliza nenhum parâmetro em si.

    O local de saída do arquivo de rastreio é impresso na linha de comandos quando o comando é executado, porque o local real é dependente do
    • o status da instalação do IBM MQ .
    • as permissões do usuário.

    Os arquivos de rastreio do IBM MQ Explorer possuem um nome do formato AMQYYYYMMDDHHmmssmsmmm.TRC.n que indica o horário de início da sessão de rastreio. Quando um arquivo de rastreio atinge seu tamanho máximo, o recurso de rastreio renomeia todos os arquivos de rastreio da sessão incrementando o sufixo do arquivo .n em um. O recurso de rastreio, então, cria um novo arquivo com o sufixo .0 que contém o rastreio mais recente.

  4. Desinstale os plug-ins AspectJ e Equinox Weaving. Ao terminar com o rastreio do IBM MQ Explorer , é possível remover os plugins de Weaving AspectJ e Equinox do ambiente Eclipse . Para desinstalar os plug-ins AspectJ e Equinox Weaving:
    1. Clique em Ajuda e em seguida, clique em Sobre ....
    2. Clique em Detalhes da Instalação e, em seguida, clique na guia Software Instalado .
    3. Selecione os itens AspectJ Complier e Equinox Weaving SDK.
    4. Clique em Desinstalar ... e siga as instruções do assistente.