Gromadzenie danych śledzenia programu IBM MQ Explorer w innych środowiskach Eclipse

Korzystając z wariantu komendy runwithtrace , można gromadzić dane śledzenia z instancji programu IBM® MQ Explorer , która jest zainstalowana we własnym środowisku Eclipse lub w produkcie opartym na platformie Eclipse.

Zanim zaczniesz

W przypadku tego zadania założono, że produkt IBM MQ Eksplorator został zainstalowany we własnym środowisku produktu Eclipse lub w produkcie opartym na produkcie Eclipse, dlatego nie można użyć standardowej komendy runwithtrace zgodnie z opisem w sekcji Gromadzenie danych śledzenia programu IBM MQ Explorer.

Informacje o zadaniu

Produkt IBM MQ Explorer można zainstalować we własnym środowisku Eclipse lub w produkcie opartym na technologii Eclipse, aby pomóc w tworzeniu aplikacji Java lub w celu tworzenia własnych rozszerzeń.

Aby zgromadzić dane śledzenia, należy użyć komendy runwithtrace w celu uruchomienia programu IBM MQ Explorer. Nie można użyć komendy runwithtrace, która jest dostarczana z produktem. Zamiast tego należy użyć wariantu komendy zgodnie z opisem w poniższej procedurze.

Uwaga: śledzenie jest zwykle włączone tylko wtedy, gdy zostanie poproszony o to przedstawiciel serwisu IBM . Śledzenie spowalnia program IBM MQ Explorer , a pliki śledzenia mogą szybko stać się duże.

Procedura

  1. Mechanizm śledzenia IBM MQ Explorer jest oparty na wtyczkach AspectJ i Equinox Weaving instalowanych. Aby sprawdzić, czy są one zainstalowane:
    1. Kliknij opcję Pomoc
    2. Kliknij Informacje ...
    3. Kliknij opcję Szczegóły instalacji
    4. Kliknij kartę Wtyczki .
    Wtyczka org.eclipse.equinox.weaving.caching.j9 już nie istnieje, ale wymagana jest ta wtyczka, jeśli używany jest produkt IBM MQ 9.0 Obsługa długoterminowalub IBM MQ 9.0 Ciągła dostawa , przed 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óry serwis do pobrania ma być używany dla używanej wersji produktu Eclipse, należy zapoznać się z https://projects.eclipse.org/projects/tools.ajdt.

    Informacje na temat poziomu produktu Eclipse , na którym jest zbudowany program IBM MQ Explorer , zawiera sekcja Co nowego i co zostało zmienione 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 przycisk Dodaj ... Następnie 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ę Inne narzędzia AJDT (opcjonalne) i wybierz opcję AspectJ Compiler and Equinox Weaving SDK.
    5. Kliknij przycisk Dalej i postępuj zgodnie z instrukcjami kreatora.
  3. Śledzenie IBM MQ Eksplorator.

    Zamknij i zrestartuj program IBM MQ Explorer , korzystając ze skryptu runwithtrace . Skrypt, który ma być używany dla systemów operacyjnych Windows , znajduje się w sekcji Skrypt komend runwithtrace dla systemu Windows. Skrypt, który ma być używany dla systemów operacyjnych Linux® , znajduje się w sekcji Skrypt komend runwithtrace dla systemu Linux.

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

    Po uruchomieniu programu IBM MQ Explorer za pomocą komendy runwithtrace włączane są dodatkowe parametry, które umożliwiają śledzenie programu IBM MQ Explorer. Należy pamiętać, że komenda runwithtrace sama nie przyjmuje żadnych parametrów.

    Położenie danych wyjściowych pliku śledzenia jest wyświetlane w wierszu komend, gdy komenda jest uruchamiana, ponieważ rzeczywiste położenie jest zależne od
    • Status instalacji IBM MQ .
    • uprawnień użytkownika.

    Pliki śledzenia IBM MQ Explorer mają nazwę w formacie AMQRRRRMMDDGGmmssmmm.TRC.n , która 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. Po zakończeniu działania funkcji śledzenia IBM MQ Explorer można usunąć wtyczki AspectJ i Equinox Weaving ze środowiska Eclipse . Aby zdeinstalować wtyczki AspectJ i Equinox Weaving:
    1. Kliknij opcję Pomoc , a następnie opcję Informacje o ....
    2. Kliknij opcję Szczegóły instalacji , a następnie kliknij kartę Zainstalowane oprogramowanie .
    3. Wybierz elementy AspectJ Complier i Equinox Weaving SDK.
    4. Kliknij opcję Deinstaluj ... i postępuj zgodnie z instrukcjami kreatora.