Usando o rastreio do IBM MQ Explorer em outros ambientes do Eclipse

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

Sobre Esta Tarefa

É possível coletar o rastreio do IBM MQ Explorer se você tiver instalado o IBM MQ Explorer em seu próprio produto Eclipse ou no produto baseado em Eclipse seguindo o procedimento.

Observe que você normalmente ativa o rastreio apenas quando solicitado a fazer isso pelo seu Representante de Serviço IBM. O rastreio reduz a velocidade do IBM MQ Explorer e os arquivos de rastreio podem ficar grandes rapidamente.

Procedimento

  1. O mecanismo de rastreio do IBM MQ Explorer depende dos plug-ins AspectJ e Equinox Weaving estarem instalados. Para confirmar que eles estão instalados:
    1. Clique em Ajuda
    2. Clique em Sobre...
    3. Clique em Detalhes de Instalação
    4. Clique na guia Plug-ins.
    O plug-in org.eclipse.equinox.weaving.caching.j9 não existe mais, mas é necessário ao usar as liberações IBM MQ 9.0 Long Term Support ou IBM MQ 9.0 Continuous Delivery, anteriores ao 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 sua versão do Eclipse, consulte https://projects.eclipse.org/projects/tools.ajdt.

    Para obter informações sobre o nível do Eclipse no qual o IBM MQ Explorer foi construído, consulte Novidades e Mudanças 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 e, em seguida, clique em Instalar novo software...
    2. Clique em Incluir... e, em seguida, insira o local do site de download apropriado para a versão do 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. Para rastrear o IBM MQ Explorer, feche e reinicie o IBM MQ Explorer usando o script runwithtrace. Para o script que será usado para sistemas operacionais Windows, veja Script de comando runwithtrace para Windows. Para o script que será usado para sistemas operacionais Linux®, veja Script de comando runwithtrace para Linux.

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

    Quando você inicia o IBM MQ Explorer usando o comando runwithtrace, são incorporados parâmetros extras que ativam 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 por causa do local real:
    • É dependente do status da instalação do IBM MQ
    • Permissões do usuário

    Os arquivos de rastreio do IBM MQ Explorer  têm um nome do formato AMQYYYYMMDDHHmmssmmm.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. Quando concluir o rastreio do IBM MQ Explorer, será possível remover os plug-ins AspectJ e Equinox Weaving do ambiente do Eclipse. Para desinstalar os plug-ins AspectJ e Equinox Weaving:
    1. Clique em Ajuda e, em seguida, clique em Sobre....
    2. Clique em Detalhes de Instalação e, em seguida, clique na guia Software Instalado.
    3. Selecione os itens AspectJ Compiler e Equinox Weaving SDK.
    4. Clique em Desinstalar... e siga as instruções do assistente.