Применение трассировки IBM MQ Explorer в других средах Eclipse

IBM® MQ Explorer можно установить в среде Eclipse или в продукте на основе Eclipse для разработки приложений Java™ или собственных расширений.

Об этой задаче

Трассировку IBM MQ Explorer можно собрать, если IBM MQ Explorer установлен в собственной среде Eclipse или в продукте на основе Eclipse с помощью следующей процедуры.

Обратите внимание, что обычно служба трассировки включается только в соответствии с указаниями из сервисного представительства IBM. Трассировка замедляет работу IBM MQ Explorer и файлы трассировки быстро становятся большими.

Процедура

  1. Служба трассировки IBM MQ Explorer использует модули AspectJ и Equinox Weaving. Для того чтобы проверить, что они установлены, выполните следующие действия:
    1. Выберите Справка
    2. Выберите О программе...
    3. Выберите Сведения об установке
    4. Перейдите на вкладку Модули.
    Модуль org.eclipse.equinox.weaving.caching.j9 больше не существует, однако он требуется в случае применения IBM MQ 9.0 Long Term Support или IBM MQ 9.0 Continuous Delivery ниже IBM MQ 9.0.4.
    Убедитесь, что установлены следующие модули:
    
    	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. Если они не установлены, то установите модули AspectJ и Equinox Weaving. Они должны соответствовать применяемой версии Eclipse. Загрузите их с веб-сайта Eclipse AspectJ Development Tools. Сайт загрузки для конкретной версии Eclipse можно выбрать на веб-странице https://projects.eclipse.org/projects/tools.ajdt.

    Дополнительная информация об уровне Eclipse, на котором выполнена компоновка IBM MQ Explorer, приведена в разделе Дополнения и изменения IBM MQ Explorer.

    В настоящее время эти сборки доступны только для целей разработки; выберите последнюю доступную.

    Для установки модулей AspectJ и Equinox Weaving выполните следующие действия:
    1. Выберите Справка, затем выберите Установить новое программное обеспечение....
    2. Нажмите кнопку Добавить... и укажите расположение сайта загрузки для применяемой версии Eclipse.
      Например, для Eclipse 4.4 введите https://download.eclipse.org/tools/ajdt/44/dev/update.
    3. Нажмите кнопку OK
      Появится список доступного программного обеспечения.
    4. Разверните категорию Другие инструменты AJDT (необязательно) и выберите SDK AspectJ Compiler и Equinox Weaving.
    5. Нажмите кнопку Далее и следуйте инструкциям мастера.
  3. Для трассировки IBM MQ Explorer закройте и перезапустите IBM MQ Explorer с помощью сценария runwithtrace. Сценарий для операционной системы Windows указан в разделе Командный сценарий runwithtrace для Windows. Сценарий для операционной системы Linux® указан в разделе Командный сценарий runwithtrace для Linux.

    Сценарий следует запускать из каталога, содержащего исполняемый файл Eclipse.

    При запуске IBM MQ Explorer с помощью команды runwithtrace указываются дополнительные параметры, включающие трассировку IBM MQ Explorer. Обратите внимание, что команда runwithtrace не принимает параметры.

    Расположение вывода файла трассировки печатается в командной строке, поскольку фактическое расположение зависит от следующих факторов:
    • Зависит от состояния экземпляра IBM MQ
    • Права доступа пользователей

    Файлам трассировки IBM MQ Explorer присваиваются имена в формате AMQYYYYMMDDHHmmssmmm.TRC.n, который указывает начальное время сеанса трассировки. При достижении максимального размера файла трассировки все файлы трассировки сеанса переименовываются путем увеличения суффикса .n на единицу. Затем создается файл с суффиксом .0, который всегда является последним.

  4. Удалите модули AspectJ и Equinox Weaving. После выполнения трассировки IBM MQ Explorer модули AspectJ и Equinox можно удалить из среды Eclipse. Для удаления модулей AspectJ и Equinox Weaving выполните следующие действия:
    1. Выберите Справка, затем выберите О программе....
    2. Выберите Сведения об установке и перейдите на вкладку Установленное программное обеспечение.
    3. Выберите элементы AspectJ Complier и Equinox Weaving SDK.
    4. Нажмите кнопку Удалить... и следуйте инструкциям мастера.