Recopilación de rastreo de IBM MQ Explorer en otros entornos de Eclipse

Utilizando una variante del mandato runwithtrace , puede recopilar el rastreo de una instancia de IBM® MQ Explorer que está instalada en su propio entorno Eclipse o producto basado en Eclipse.

Antes de empezar

Esta tarea presupone que ha instalado IBM MQ Explorer en su propio entorno Eclipse o producto basado en Eclipsey, por lo tanto, no puede utilizar el mandato runwithtrace estándar tal como se describe en Recopilación del rastreo de IBM MQ Explorer.

Acerca de esta tarea

IBM MQ Explorer se puede instalar en su propio entorno Eclipse o producto basado en Eclipsepara ayudar a desarrollar aplicaciones Java , o para desarrollar sus propias extensiones.

Para recopilar el rastreo, utilice un mandato runwithtrace para iniciar IBM MQ Explorer. No puede utilizar el mandato runwithtrace que se proporciona con el producto. En su lugar, se utiliza una variante del mandato, tal como se describe en el procedimiento siguiente.

Nota: Normalmente, solo habilita el rastreo cuando se lo solicita el representante de servicio de IBM . El rastreo ralentiza IBM MQ Explorer y los archivos de rastreo pueden llegar a ser grandes rápidamente.

Procedimiento

  1. El mecanismo de rastreo de IBM MQ Explorer se basa en los plug-ins AspectJ y Equinox Weaving que se están instalando. Para confirmar que estén instalados:
    1. Pulse Ayuda
    2. Pulse Acerca de ...
    3. Pulse Detalles de instalación
    4. Pulse la pestaña Plug-ins .
    El plug-in de org.eclipse.equinox.weaving.caching.j9 ya no existe, pero necesita este plug-in si utiliza los releases IBM MQ 9.0 Long Term Support o IBM MQ 9.0 Continuous Delivery, anteriores a IBM MQ 9.0.4.
    Verifique que se hayan instalado los plug-ins siguientes:
    
    	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. Si aún no están instalados, instale los plug-ins AspectJ y Equinox Weaving. Estos plug-ins deben coincidir con la versión de Eclipse que esté utilizando, y se puede descargar desde el sitio de descarga de Eclipse AspectJ Development Tools. Para determinar qué sitio de descarga debe utilizar para su versión de Eclipse, consulte https://projects.eclipse.org/projects/tools.ajdt.

    Para obtener información sobre el nivel de Eclipse en el que se basa IBM MQ Explorer , consulte Novedades y cambios en IBM MQ Explorer.

    Actualmente, estas compilaciones están disponibles como compilaciones de desarrollo solo; debe seleccionar la última disponible.

    Para instalar los plug-ins AspectJ y Equinox Weaving, lleve a cabo estos subpasos:
    1. Pulse Ayuda y, a continuación, pulse Instalar nuevo software ...
    2. Pulse Añadir ... y especifique la ubicación del sitio de descarga adecuado para la versión de Eclipse.
      Por ejemplo, para Eclipse 4.4, escriba https://download.eclipse.org/tools/ajdt/44/dev/update.
    3. Pulse Aceptar
      Aparece una lista del software disponible.
    4. Expanda la categoría Otras herramientas AJDT (Opcional) y seleccione AspectJ Compilador y Equinox Weaving SDK.
    5. Pulse Siguiente y siga las instrucciones del asistente.
  3. Rastreo IBM MQ Explorer.

    Cierre y reinicie IBM MQ Explorer utilizando el script runwithtrace . Para que el script se utilice para los sistemas operativos Windows , consulte Script de mandato runwithtrace para Windows. Para que el script se utilice para los sistemas operativos Linux® , consulte script de mandato runwithtrace para Linux.

    El script debe ejecutarse desde el directorio que contenga el archivo ejecutable de Eclipse.

    Cuando inicia IBM MQ Explorer utilizando el mandato runwithtrace , se incorporan parámetros adicionales que habilitan el rastreo de IBM MQ Explorer. Tenga en cuenta que el mandato runwithtrace no incorpora ningún parámetro por sí mismo.

    La ubicación de salida del archivo de rastreo se imprime en la línea de mandatos cuando se ejecuta el mandato porque la ubicación real depende de
    • el estado de la instalación de IBM MQ.
    • los permisos de usuario.

    Los archivos de rastreo de IBM MQ Explorer tienen un nombre con el formato AMQYYYYMMDDHHmmssmmm.TRC.n que indica la hora de inicio de la sesión de rastreo. Cuando un archivo de rastreo alcanza su tamaño máximo, el recurso de rastreo cambia el nombre de todos los archivos de rastreo de la sesión aplicando un incremento de uno al sufijo del archivo .n. A continuación, el recurso de rastreo crea un nuevo archivo con el sufijo .0 que contiene el último rastreo.

  4. Desinstale los plug-ins AspectJ y Equinox Weaving. Cuando termine con el rastreo de IBM MQ Explorer , puede eliminar los plugins AspectJ y Equinox Weaving del entorno Eclipse . Para desinstalar los plug-ins AspectJ y Equinox Weaving:
    1. Pulse Ayuda y, a continuación, pulse Acerca de ....
    2. Pulse Detalles de instalación y, a continuación, pulse el separador Software instalado .
    3. Seleccione los elementos AspectJ Complier y Equinox Weaving SDK.
    4. Pulse Desinstalar ... y siga las instrucciones del asistente.