Utilisation de la fonction de trace IBM MQ Explorer

Vous pouvez utiliser la trace IBM® MQ Explorer pour déterminer l'origine d'un problème.

Pourquoi et quand exécuter cette tâche

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.

Lorsque vous démarrez IBM MQ Explorer en utilisant runwithtrace, des paramètres supplémentaires sont ajoutés pour activer la fonction de trace d'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 :
  • du statut de l'installation d'IBM MQ
  • des droits de l'utilisateur

Les fichiers IBM MQ Explorer trace ont 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.

Pour tracer IBM MQ Explorer, procédez comme suit.

Procédure

  1. Fermez IBM MQ Explorer.
  2. [Windows] Sur les systèmes Windows, utilisez runwithtrace.cmd pour exécuter IBM MQ Explorer avec la fonction de trace activée.
    La commande runwithtrace se trouve à l'un des emplacements suivants :
    • Si vous exécutez l'instance IBM MQ Explorer qui a été installée dans le cadre d'une installation de serveur IBM MQ complète, la commande runwithtrace se trouve dans CHEMIN_INSTALLATION_MQ\MQExplorer\Eclipse, où CHEMIN_INSTALLATION_MQ est le chemin d'installation d'IBM MQ.
    • Si vous avez installé le produit IBM MQ Explorer autonome (SupportPac MS0T), la commande runwithtrace se trouve dans le même répertoire que la commande MQExplorer.
  3. [Linux] Sur les systèmes Linux®, utilisez runwithtrace pour exécuter IBM MQ Explorer avec la fonction de trace activée.
    La commande runwithtrace se trouve à l'un des emplacements suivants :
    • Si vous exécutez l'instance IBM MQ Explorer qui a été installée dans le cadre d'une installation de serveur IBM MQ complète, la commande runwithtrace se trouve dans /opt/mqm/mqexplorer/eclipse, où opt/mqm est le répertoire d'installation d'IBM MQ.
    • Si vous avez installé le produit IBM MQ Explorer autonome (SupportPac MS0T), la commande runwithtrace se trouve dans le même répertoire que la commande MQExplorer.