Utilisation de la fonction de trace de IBM MQ Explorer dans d'autres environnements Eclipse
IBM® MQ Explorer peut être installé dans votre environnement Eclipse ou un produit Eclipse pour faciliter le développement des applications Java™, ou développer vos propres extensions.
Pourquoi et quand exécuter cette tâche
Vous pouvez collecter la trace de IBM MQ Explorer si vous avez installé IBM MQ Explorer dans votre propre produit Eclipse ou basé sur Eclipse en suivant la procédure.
Généralement, vous activez le traçage uniquement lorsque le 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
- Le mécanisme de trace de IBM MQ Explorer nécessite d'avoir installé les modules d'extension AspectJ et Equinox Weaving. Pour confirmer qu'ils sont installés :
- Cliquez sur Help
- Cliquez sur About...
- Cliquez sur Installation Details
- Cliquez sur l'onglet Plug-ins.
Le module d'extension org.eclipse.equinox.weaving.caching.j9 n'existe plus, mais vous en avez besoin si vous utilisez les éditions IBM MQ version 9.0 Long Term Support ou IBM MQ version 9.0 Continuous Delivery antérieures à version 9.0.4. Vérifiez que les modules d'extension 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
- Si ce n'est pas déjà fait, installez les modules d'extension 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 quel site de téléchargement à utiliser pour votre version d'Eclipse, voir https://www.eclipse.org/ajdt/downloads/.
Si vous utilisez Eclipse 4.4.2, vous devez utiliser AJDT 2.2.4 ; n'utilisez pas AJDT 2.2.3. Cette instruction s'applique si vous utilisez les éditions IBM MQ version 9.0 Long Term Support ou IBM MQ version 9.0 Continuous Delivery antérieures à version 9.0.4.
IBM MQ version 9.0.4 utilise Eclipse 4.6.3. Si vous utilisez Eclipse 4.6.3, vous devez vous procurer une version compatible avec Eclipse 4.6 sur le site AJDT.
Ces versions sont actuellement disponibles en tant que versions de développement uniquement. Sélectionnez la version la plus récente.
Pour installer les modules d'extension AspectJ et Equinox Weaving, effectuez les sous-étapes suivantes :- Cliquez sur Help, puis cliquez sur Install New Software....
- Cliquez sur Add..., puis entrez l'emplacement du site de téléchargement approprié pour votre version d'Eclipse. Par exemple, pour Eclipse 4.4, entrez http://download.eclipse.org/tools/ajdt/44/dev/update.
- Cliquez sur OK. La liste des logiciels disponibles s'affiche.
- Développez la catégorie Other AJDT Tools (Optional) et sélectionnez AspectJ Compiler and Equinox Weaving SDK.
- Cliquez sur Next et suivez les instructions de l'assistant.
- Pour 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 commandes runwithtrace pour Windows. Pour le script à utiliser pour les systèmes d'exploitation Linux, voir
Script de commandes 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 en utilisant runwithtrace, des paramètres supplémentaires sont ajoutés pour activer la fonction de trace de IBM MQ Explorer. Notez que le fichier runwithtrace n'utilise pas de paramètres lui-même.
L'emplacement de la sortie du fichier de trace est inscrit sur la ligne de commande lorsque la commande s'exécute, car l'emplacement réel est dépendant :- de l'état de l'installation IBM WebSphere MQ
- des droits de l'utilisateur
Les fichiers IBM MQ Explorer trace nt un nom au format AMQAAAAMMJJHHmmssmmm.TRC.n qui indique la date et l'heure 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.
- Désinstallez les modules d'extension AspectJ et Equinox Weaving. Lorsque vous terminez la trace IBM MQ Explorer,
vous pouvez supprimer les plug-in AspectJ et Equinox Weaving de l'environnement Eclipse. Pour désinstaller les modules d'extension AspectJ et Equinox Weaving :
- Cliquez sur Help puis sur About....
- Cliquez sur Installation Details puis sur l'onglet Installed Software.
- Sélectionnez les éléments AspectJ Complier et Equinox Weaving SDK.
- Cliquez sur Uninstall... et suivez les instructions de l'assistant.
Sous-rubriques
- Script de commandes runwithtrace pour Windows
Pour activer la fonction de trace de MQ Explorer, fermez et redémarrez MQ Explorer avec le script de commandes runwithtrace. Cette rubrique présente une copie de ce script, qui peut être utilisé sur les systèmes Windows. - Script de commandes runwithtrace pour Linux
Pour activer la fonction de trace de MQ Explorer, fermez et redémarrez MQ Explorer avec le script de commandes runwithtrace. Cette rubrique présente une copie de ce script, qui peut être utilisé sur les systèmes Linux.

Commentaires
