Freigeben über

Analysieren von MQSeries-Adapterfehlern mit den Ablaufverfolgungstools

  • Artikel

Sie verwenden die Ablaufverfolgungstools, um Messagingfehler bei der Ausführung Ihrer Anwendung zu analysieren. Beim MQSeries-Adapter müssen Sie zwei Tools verwenden – ein Tool für den Adapter und Ihre BizTalk-Anwendung (trace.cmd) und das andere Tool für den MQSAgent (MQSTrace.cmd). Beide Tools verwenden tracelog.exe. Sie müssen tracelog.exe installieren, falls dies nicht bereits geschehen ist.

Mit trace.cmd und MQSTrace.cmd müssen Sie eine Option (-tools) festlegen, damit diese Tools die tracelog.exe-Datei finden können.

Installieren des Ablaufverfolgungsprogramms

Führen Sie zum Installieren des Ablaufverfolgungsprogramms für den BizTalk-Adapter die folgenden Schritte aus:

  1. Um die Tracelog.exe-Datei herunterzuladen, besuchen Sie die Microsoft Platform SDK-Downloadwebsite.

  2. Starten Sie das Platform SDK-Webinstallationsprogramm, indem Sie unten auf der Webseite auf den Link für die dateiPSDK-x86.exe klicken.

  3. Wählen Sie die Option zur benutzerdefinierten Installation, wenn Sie dazu aufgefordert werden.

  4. Klicken Sie im Dialogfeld Custom Installation , um alle verfügbaren Features zu deaktivieren.

  5. Erweitern Sie zunächst das Feature Microsoft Windows Core SDK , und erweitern Sie dann das Feature Tools .

  6. Wählen Sie das Feature Tools (Intel 64-bit) aus, und klicken Sie dann auf Will be installed on local hard drive.

  7. Klicken Sie auf Next, und klicken Sie dann erneut auf Next , um die Installation zu starten.

  8. Suchen Sie das Laufwerk:\MicrosoftPlatformSDKInstallationFolder\bin, und kopieren Sie dann die datei Tracelog.exe in den Installationsordner microsoft BizTalk Server. Der Installationsordner von BizTalk Server enthält außerdem die Datei Trace.cmd.

Aktivieren des Ablaufverfolgungsprogramms

Führen Sie zum Aktivieren des Ablaufverfolgungsprogramms für den BizTalk-Adapter in BizTalk Server die folgenden Schritte aus:

  1. Wechseln Sie zu dem Verzeichnis mit trace.cmd. Der Standardspeicherort ist das Microsoft BizTalk Server-Verzeichnis.

  2. Geben Sie den folgenden Befehl ein, und ersetzen Sie dabei das Verzeichnis, in dem die Datei tracelog.exe auf dem Computer gespeichert ist, durch das Verzeichnis in Anführungszeichen. Drücken Sie dann die EINGABETASTE.

    trace -tools „C:\Programme\Microsoft SDK\Bin“

  3. Wechseln Sie zu dem Verzeichnis mit MQSTrace.cmd.

  4. Geben Sie den folgenden Befehl ein, und ersetzen Sie dabei das Verzeichnis, in dem die Datei tracelog.exe auf dem Computer gespeichert ist, durch das Verzeichnis in Anführungszeichen. Drücken Sie dann die EINGABETASTE.

    MQSTrace -tools „C:\Programme\Microsoft SDK\Bin“

Ausführen des Ablaufverfolgungsprogramms

Führen Sie zum Ausführen des Ablaufverfolgungsprogramms für den BizTalk-Adapter die folgenden Schritte aus:

  1. Geben Sie an der Eingabeaufforderung trace.cmd -start -high ein, und drücken Sie dann die EINGABETASTE.

  2. Führen Sie Ihr Fehlerszenario aus.

  3. Geben Sie an der Eingabeaufforderung trace.cmd -stop ein, und drücken Sie dann die EINGABETASTE.

  4. Die Datei bts2006.bin enthält die Ausgabe des Ablaufverfolgungstools. Falls Sie eine Analyse benötigen, wenden Sie sich an den Microsoft-Produktsupport. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?LinkId=41645.

    Führen Sie zum Ausführen des Ablaufverfolgungsprogramms für den MQSAgent die folgenden Schritte aus:

  5. Geben Sie an der Eingabeaufforderung MQSTrace.cmd -start -high ein, und drücken Sie dann die EINGABETASTE.

  6. Führen Sie Ihr Fehlerszenario aus.

  7. Geben Sie an der Eingabeaufforderung MQSTrace.cmd -stop ein.

  8. Die Datei MQSAdapterTrace.bin enthält die Ausgabe des Ablaufverfolgungstools. Falls Sie eine Analyse benötigen, wenden Sie sich an den Microsoft-Produktsupport. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?LinkId=41645.