Używanie usługi śledzenia programu IBM MQ Explorer w innych środowiskach Eclipse

Zainstalowanie programu IBM® MQ Explorer we własnym środowisku Eclipse lub w produkcie opartym na technologii Eclipse ułatwia programowanie aplikacji Java™ oraz programowanie własnych rozszerzeń.

O tym zadaniu

Aby gromadzić dane śledzenia programu IBM MQ Explorer, należy zainstalować program IBM MQ Explorer we własnym środowisku Eclipse lub produkcie opartym na technologii Eclipse, wykonując procedurę opisaną poniżej.

Należy pamiętać, że śledzenie jest z reguły włączane jedynie w przypadku, gdy poprosi o to przedstawiciel serwisu IBM. Śledzenie spowalnia działanie programu IBM MQ Explorer, a pliki śledzenia mogą szybko osiągnąć dużą wielkość.

Procedura

  1. Mechanizm śledzenia programu IBM MQ Explorer wymaga zainstalowania wtyczek AspectJ i Equinox Weaving. Aby sprawdzić, czy są one zainstalowane:
    1. Kliknij opcję Pomoc.
    2. Kliknij opcję Informacje....
    3. Kliknij opcję Szczegóły instalacji.
    4. Kliknij kartę Wtyczki.
    Wtyczka org.eclipse.equinox.weaving.caching.j9 już nie istnieje, lecz jest ona wymagana w przypadku wersji IBM MQ 9.0 Long Term Support lub IBM MQ 9.0 Continuous Delivery wcześniejszej niż IBM MQ 9.0.4.
    Należy sprawdzić, czy zostały zainstalowane następujące wtyczki:
    
    	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. Jeśli nie wtyczki AspectJ i Equinox Weaving nie są jeszcze zainstalowane, zainstaluj je. Wtyczki można pobrać z serwisu pobierania narzędzi Eclipse AspectJ Development Tools, ale należy pamiętać, że muszą one być zgodne z używaną wersją środowiska Eclipse. Aby określić, którego serwisu pobierania użyć dla danej wersji środowiska Eclipse, należy zapoznać się z sekcją https://projects.eclipse.org/projects/tools.ajdt.

    Informacje na temat poziomu platformy Eclipse, na podstawie której został zbudowany program IBM MQ Explorer, zawiera sekcja Nowości i zmiany w programie IBM MQ Explorer.

    Obecnie te kompilacje są dostępne tylko jako kompilacje rozwojowe. Należy wybrać najnowszą dostępną kompilację.

    Aby zainstalować wtyczki AspectJ i Equinox Weaving, wykonaj następujące kroki podrzędne:
    1. Kliknij opcję Pomoc, a następnie kliknij opcję Zainstaluj nowe oprogramowanie....
    2. Kliknij opcję Dodaj... i wpisz położenie serwisu pobierania odpowiedniego dla danej wersji środowiska Eclipse.
      Na przykład dla środowiska Eclipse 4.4 wpisz adres https://download.eclipse.org/tools/ajdt/44/dev/update.
    3. Kliknij przycisk OK.
      Zostanie wyświetlona lista dostępnego oprogramowania.
    4. Rozwiń kategorię Other AJDT Tools (Optional) (Inne narzędzia AJDT – opcjonalnie) i wybierz opcję AspectJ Compiler and Equinox Weaving SDK (Kompilator AspectJ i pakiet SDK Equinox Weaving).
    5. Kliknij przycisk Dalej i postępuj zgodnie z instrukcjami kreatora.
  3. Aby śledzić program IBM MQ Explorer, zamknij i zrestartuj program IBM MQ Explorer, używając skryptu runwithtrace. Informacje na temat skryptu używanego w systemach operacyjnych Windows są dostępne w sekcji Skrypt komend runwithtrace dla systemu Windows. Informacje na temat skryptu używanego w systemach operacyjnych Linux® są dostępne w sekcji Skrypt komend runwithtrace dla systemu Linux.

    Skrypt należy uruchomić z katalogu, który zawiera plik wykonywalny środowiska Eclipse.

    Gdy program IBM MQ Explorer jest uruchamiany przy użyciu komendy runwithtrace, używane są dodatkowe parametry, które umożliwiają śledzenie działania programu IBM MQ Explorer. Należy pamiętać, że komenda runwithtrace sama nie przyjmuje żadnych parametrów.

    Informacja o położeniu wyjściowego pliku śledzenia jest wyświetlana w wierszu komend po uruchomieniu komendy, ponieważ rzeczywiste położenie zależy od następujących czynników:
    • Status instalacji produktu IBM MQ
    • Uprawnienia użytkownika

    Nazwy plików śledzenia programu IBM MQ Explorer są w formacie AMQRRRRMMDDGGmmssmmm.TRC.n, który wskazuje czas rozpoczęcia sesji śledzenia. Gdy plik śledzenia osiągnie swoją maksymalną wielkość, narzędzie śledzenia zmienia nazwy wszystkich plików śledzenia z sesji, zwiększając wartość przyrostka pliku .n o jeden. Narzędzie śledzenia tworzy następnie nowy plik z przyrostkiem .0. Plik ten zawiera najnowsze dane śledzenia.

  4. Zdeinstaluj wtyczki AspectJ i Equinox Weaving. Gdy śledzenie programu IBM MQ Explorer nie będzie już potrzebne, możesz usunąć wtyczki AspectJ i Equinox Weaving ze środowiska Eclipse. Aby zdeinstalować wtyczki AspectJ i Equinox Weaving:
    1. Kliknij opcję Pomoc, a następnie kliknij opcję Informacje....
    2. Kliknij opcję Szczegóły instalacji, a następnie kliknij kartę Zainstalowane oprogramowanie.
    3. Wybierz pozycje AspectJ Compiler (Kompilator AspectJ) i Equinox Weaving SDK (Pakiet SDK Equinox Weaving).
    4. Kliknij opcję Deinstaluj... i postępuj zgodnie z instrukcjami kreatora.