Analyse des erreurs de l’adaptateur MQSeries à l’aide des outils de suivi

  • Article

Les outils de suivi permettent d'analyser les échecs relatifs à la messagerie lors de l'exécution d'une application. Avec l'adaptateur MQSeries, vous devez utiliser deux outils : trace.cmd pour l'adaptateur et l'application BizTalk application, et MQSTrace.cmd pour MQSAgent. Les deux outils utilisent tracelog.exe. Vous devez installer tracelog.exe si vous ne l’avez pas déjà.

Avec trace.cmd et MQSTrace.cmd, vous devez définir une option (-tools) afin que ces outils puissent trouver le fichier tracelog.exe.

Installation de l'utilitaire de suivi

Pour installer l'utilitaire de suivi de l'adaptateur BizTalk, procédez comme suit :

  1. Pour télécharger le fichier Tracelog.exe, visitez le site web de téléchargement du Kit de développement logiciel (SDK) de plateforme Microsoft.

  2. Démarrez le programme d’installation web du Kit de développement logiciel (SDK) de plateforme en cliquant sur le lien du fichier PSDK-x86.exe en bas de la page web.

  3. Lorsque vous y êtes invité, choisissez de procéder à une installation personnalisée.

  4. Dans la boîte de dialogue Installation personnalisée , désactivez toutes les cases à cocher relatives aux composants disponibles.

  5. Développez le composant de kit de développement SDK principal Microsoft Windows , puis le composant Outils .

  6. Choisissez le composant Outils (Intel 64 bits) et cliquez sur Installation sur le disque dur local.

  7. Cliquez sur Suivant, puis de nouveau sur Suivant pour démarrer l'installation.

  8. Recherchez le dossier drive :\MicrosoftPlatformSDKInstallationFolder\bin, puis copiez le fichier Tracelog.exe dans le dossier d’installation microsoft BizTalk Server. qui inclut également le fichier Trace.cmd.

Activation de l'utilitaire de suivi

Pour activer l'utilitaire de suivi de l'adaptateur BizTalk dans BizTalk Server, procédez comme suit :

  1. Accédez au répertoire qui contient trace.cmd. L’emplacement par défaut est le répertoire Microsoft BizTalk Server.

  2. Tapez la commande suivante, en remplaçant le répertoire contenant le fichier tracelog.exe sur votre ordinateur par le répertoire entre guillemets, puis appuyez sur ENTRÉE :

    trace -tools "c:\Program Files\Microsoft SDK\Bin"

  3. Accédez au répertoire contenant MQSTrace.cmd.

  4. Tapez la commande suivante, en remplaçant le répertoire contenant le fichier tracelog.exe sur votre ordinateur par le répertoire entre guillemets, puis appuyez sur ENTRÉE :

    MQSTrace -tools "c:\Program Files\Microsoft SDK\Bin"

Exécution de l'utilitaire de suivi

Pour exécuter l'utilitaire de suivi de l'adaptateur BizTalk, procédez comme suit :

  1. À l’invite de commandes, tapez trace.cmd -start -high, puis appuyez sur ENTRÉE.

  2. Exécutez le scénario d'échec.

  3. À l’invite de commandes, tapez trace.cmd -stop, puis appuyez sur ENTRÉE.

  4. Le fichier bts2006.bin contient la sortie de l'outil de suivi. Contactez les Services de support technique Microsoft à des fins d'analyse. Pour plus d’informations, consultez https://go.microsoft.com/fwlink/?LinkId=41645.

    Pour exécuter l'utilitaire de suivi MQSAgent, procédez comme suit :

  5. À l’invite de commandes, tapez MQSTrace.cmd -start -high, puis appuyez sur ENTRÉE.

  6. Exécutez le scénario d'échec.

  7. À l’invite de commandes, tapez MQSTrace.cmd -stop.

  8. Le fichier MQSAdapterTrace.bin contient la sortie de l'outil de suivi. Contactez les Services de support technique Microsoft à des fins d'analyse. Pour plus d'informations, consultez https://go.microsoft.com/fwlink/?LinkId=41645.