Collecte de la trace IBM MQ Explorer dans d'autres environnements Eclipse

A l'aide d'une variante de la commande runwithtrace , vous pouvez collecter la trace à partir d'une instance d' IBM® MQ Explorer qui est installée dans votre propre environnement Eclipse ou produit Eclipse.

Avant de commencer

Cette tâche suppose que vous avez installé Explorateur IBM MQ dans votre propre environnement Eclipse ou produit Eclipseet que vous ne pouvez donc pas utiliser la commande exécution avec trace standard comme décrit dans Collecte de la trace IBM MQ Explorer.

A propos de cette tâche

IBM MQ Explorer peut être installé dans votre propre environnement Eclipse ou dans le produit Eclipsepour vous aider à développer des applications Java ou à développer vos propres extensions.

Pour collecter la trace, vous utilisez une commande runwithtrace pour démarrer IBM MQ Explorer. Vous ne pouvez pas utiliser la commande runwithtrace fournie avec le produit. Au lieu de cela, vous utilisez une variante de la commande, comme décrit dans la procédure suivante.

Remarque: Vous activez normalement la fonction de trace uniquement lorsque votre technicien de maintenance IBM vous le demande. La fonction de trace ralentit IBM MQ Explorer et les fichiers de trace peuvent devenir rapidement volumineux.

Procédure

  1. Le mécanisme de trace d' IBM MQ Explorer repose sur l'installation des plug-in AspectJ et Equinox Weaving. Pour confirmer qu'ils sont installés :
    1. Cliquez sur Aide
    2. Cliquez sur A propos de ...
    3. Cliquez sur Détails de l'installation
    4. Cliquez sur l'onglet Plug-in .
    Le plug-in org.eclipse.equinox.weaving.caching.j9 n'existe plus, mais vous avez besoin de ce plug-in si vous utilisez des versions d' IBM MQ 9.0 Prise en charge à long termeou d' IBM MQ 9.0 Distribution continue antérieures à IBM MQ 9.0.4.
    Vérifiez que les plug-in suivants sont installés :
    
    	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 ce n'est pas déjà fait, installez les plug-in AspectJ et Equinox Weaving. Ces plug-in doivent correspondre à la version d'Eclipse que vous utilisez et peuvent être téléchargés à partir du site de téléchargement des outils de développement AspectJ d'Eclipse. Pour déterminer le site de téléchargement à utiliser pour votre version d' Eclipse, voir https://projects.eclipse.org/projects/tools.ajdt.

    Pour plus d'informations sur le niveau Eclipse sur lequel IBM MQ Explorer est basé, voir Nouveautés et modifications dans IBM MQ Explorer.

    Ces versions sont actuellement disponibles en tant que versions de développement uniquement. Sélectionnez la version la plus récente.

    Pour installer les plug-in AspectJ et Equinox Weaving, effectuez les sous-étapes suivantes :
    1. Cliquez sur Aide , puis sur Installer un nouveau logiciel ...
    2. Cliquez sur Ajouter ... Puis entrez l'emplacement du site de téléchargement approprié pour la version Eclipse.
      Par exemple, pour Eclipse 4.4, entrez https://download.eclipse.org/tools/ajdt/44/dev/update.
    3. Cliquez sur OK
      La liste des logiciels disponibles s'affiche.
    4. Développez la catégorie Other AJDT Tools (Optional) et sélectionnez AspectJ Compiler and Equinox Weaving SDK.
    5. Cliquez sur Suivant et suivez les instructions de l'assistant.
  3. Tracer IBM MQ Explorer.

    Fermez et redémarrez IBM MQ Explorer à l'aide du script runwithtrace . Pour le script à utiliser pour les systèmes d'exploitation Windows , voir Script de commande runwithtrace pour Windows. Pour le script à utiliser pour les systèmes d'exploitation Linux® , voir Script de commande runwithtrace pour Linux.

    Le script doit être exécuté à partir du répertoire qui contient le fichier exécutable Eclipse.

    Lorsque vous démarrez IBM MQ Explorer à l'aide de la commande runwithtrace , des paramètres supplémentaires sont intégrés pour activer le traçage d' IBM MQ Explorer. Notez que le fichier runwithtrace n'utilise pas de paramètres lui-même.

    L'emplacement de sortie du fichier de trace est imprimé sur la ligne de commande lorsque la commande s'exécute, car l'emplacement réel dépend
    • le statut de l'installation IBM MQ .
    • Les droits utilisateur.

    Les fichiers de trace IBM MQ Explorer ont un nom au format AMQYYYYMMDDHHmmssmmm.TRC.n qui indique l'heure de début de la session de trace. Lorsqu'un fichier de trace atteint sa taille maximale, l'utilitaire de trace renomme tous les fichiers de trace à partir de la session en incrémentant le suffixe de fichier .n de un. La fonction de trace crée ensuite un nouveau fichier avec le suffixe .0, qui contient toujours la dernière trace.

  4. Désinstallez les plug-in AspectJ et Equinox Weaving. Lorsque vous avez terminé avec la trace IBM MQ Explorer , vous pouvez supprimer les plug-in AspectJ et Equinox Weaving de l'environnement Eclipse . Pour désinstaller les plug-in AspectJ et Equinox Weaving :
    1. Cliquez sur Aide , puis sur A propos de ....
    2. Cliquez sur Détails de l'installation , puis sur l'onglet Logiciels installés .
    3. Sélectionnez les éléments AspectJ Complier et Equinox Weaving SDK.
    4. Cliquez sur Désinstaller ... et suivez les instructions de l'assistant.