Freigeben über

Ablaufverfolgung und Debugging

Transaction Integrator (TI) bietet eine detaillierte Ablaufverfolgung von Windows Initiated Processing (WIP)-Aufrufen und HIP-Aufrufen (Host Initiated Processing). Diese Ablaufverfolgung wird durch die Aktivierung von Ablaufverfolgung in der App-Konfigurationsdatei zusammen mit einer Host-Integrations-Trace-Definitionsdatei (.hitd) durchgeführt, die beschreibt, was nachverfolgt werden soll. Die Ablaufverfolgung kann über die hitd-Datei aktiviert und deaktiviert werden. Die Ablaufverfolgung kann auch über die App-Konfigurationsdatei aktiviert und deaktiviert werden. Der TI-Prozess muss jedoch neu gestartet werden, damit sich die neue Konfiguration auswirkt, da die App-Konfigurationsdatei nur gelesen wird, wenn der TI-Prozess gestartet wird.

Die folgenden Anweisungen zeigen, wie Sie die Ablaufverfolgung einrichten, in der sich die Ablaufverfolgungsdateien in einem Ordner "C:\Tracing" befinden. Bei Bedarf kann ein anderer Ordner verwendet werden – wichtig ist, dass das Konto, das den TI-Prozess ausführt, Lese-/Schreibzugriff auf den Protokollordner hat.

  1. Erstellen Sie den Ablaufverfolgungsordner C:\Tracing

  2. Erstellen Sie eine Host-Integrations-Ablaufverfolgungs-Definitionsdatei (HITD)

  3. Starten Sie den Trace Viewer (HIS muss installiert sein): Start - Ausführen – histraceviewer

  4. Wählen Sie im Menü "Datei" die Option "Neue Definitionsdatei" aus. TI_Trc02b1

  5. Transaktionsintegrator WIP auswählen: TI_Trc_02c

  6. Ablaufverfolgungsgröße und Auswahl: Ablaufverfolgungsebenen können für jede Komponente festgelegt werden. Wenn eine Protokollierungsebene auf einer übergeordneten Komponente festgelegt wird, gilt diese Protokollierungsebene auch für untergeordnete Komponenten.

    • Klicken Sie mit der rechten Maustaste auf "Ablaufverfolgungsebenen", und wählen Sie "Neue Ebene" aus. TI_Trc_02d
    • Wählen Sie eine oder mehrere Ebenen aus, und klicken Sie auf "OK". TI_Trc_02e
    • Wenn Sie alle Optionen auswählen, wird "ALLE" angezeigt, nachdem Sie auf "OK" geklickt haben. TI_Trc_02f
    • Speichern Sie die neue HITD-Datei als TI_Trace im Verzeichnis "C:\Tracing". Schließen Sie den Tracing-Viewer. TI_Trc_02g

  7. Aktualisieren Sie die Anwendungskonfigurationsdatei mit Trace-Konfigurationsinformationen.

    Für die von Windows initiierte Verarbeitung (WIP) kann das app.config im TI .Net-Projekt mit den Informationen zur Ablaufverfolgungskonfiguration geändert werden und wird beim Kompilieren der Anwendung in der <appname>-.exe.config-Datei eingeschlossen. Wenn die Anwendung bereits kompiliert wurde, kann der <App-Name>.exe.config Datei direkt mit diesen Informationen geändert werden.

    Wenn der BizTalk-Adapter für Hostanwendungen (BAHA) in BizTalk verwendet wird, ist die Konfigurationsdatei, die geändert werden muss, die Exe-Konfigurationsdatei von BizTalk Server für den BizTalk-Host, der für den BAHA-Port innerhalb der BizTalk-Anwendung ausgewählt ist. Die Konfigurationsdatei befindet sich in %BTSINSTALLPATH% und hat einen Namen von entweder BTSNTSvc.exe.config oder BTSNTSvc64.exe.config, je nachdem, ob es sich um einen 32-Bit- oder 64-Bit-Hostprozess handelt, den der BAHA-Port verwendet.

    Wenn die vom Host initiierte Verarbeitung (Host Initiated Processing, HIP) verwendet wird, handelt es sich um die HIPService.exe.config Datei, die geändert werden muss. Diese Datei befindet sich in %SNAROOT%.

    Fügen Sie die folgende Abschnittsanweisung innerhalb des configSections-Elements hinzu. Hinzufügen eines configSections-Elements, wenn ein Element nicht vorhanden ist

    Die <configSections-Anweisung> muss sich unmittelbar nach <der Konfiguration> und vor dem <Startabschnitt> befinden.

    Geben Sie für HIS 2016 die folgende Zeile innerhalb des configSections-Elements ein:

    <configSections>
   <section name="hostIntegration.tracing" type="Microsoft.HostIntegration.ConfigurationSectionHandlers.Tracing.TracingConfigurationSectionHandler, Microsoft.HostIntegration.ConfigurationSectionHandlers, Version=10.0.1000.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />
</configSections>

    Geben Sie für HIS 2013 die folgende Zeile innerhalb des configSections-Elements ein (der Unterschied ist die Versionsänderung):

    <configSections>
   <section name="hostIntegration.tracing" type="Microsoft.HostIntegration.ConfigurationSectionHandlers.Tracing.TracingConfigurationSectionHandler, Microsoft.HostIntegration.ConfigurationSectionHandlers, Version=9.0.1000.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />
</configSections>

    Fügen Sie die folgenden grundlegenden Konfigurationselemente für die Ablaufverfolgung dem Abschnitt am Ende des Konfigurationsabschnitts hinzu, unmittelbar vor der Schließungsanweisung </configuration>.

    <hostIntegration.tracing xmlns="http://schemas.microsoft.com/HIS/Tracing/2020">
      <traceOptions traceDefinitionFile="C:\Tracing\TI_Trace.hitd"
                    writeTraceFile="true"
                    fileNamePreamble="TI_Tracing"
                    traceFileFolder="C:\Tracing\" />
      </hostIntegration.tracing>

  8. Führen Sie die Anwendung aus, um mit der Ablaufverfolgung zu beginnen. Wenn Änderungen an der Anwendungskonfigurationsdatei vorgenommen wurden, muss der Prozess, den die TI-Runtime verwendet, neu gestartet werden, um die Ablaufverfolgung zu aktivieren. Wenn Sie BizTalk verwenden, muss die Hostinstanz neu gestartet werden. Wenn Sie IIS verwenden, muss die Website neu gestartet werden. Wenn Sie eine .Net-Exe ausführen, muss dieses Programm neu gestartet werden.

    • Suchen Sie im Ordner "C:\Tracing", um eine oder mehrere HITF-Dateien (Host Integration Trace File) anzuzeigen. Der Name der Datei ist TI_Tracing_<Prozess-ID-Nummer>_<Datum und Uhrzeit>.hitf. Beispiel:

      TI_TRACING_6076_AUG_29_2017_13_00_52_421.HITF

    • Doppelklicken Sie auf die HITF-Datei, um sie im Trace Viewer zu öffnen und zu sehen, was nachverfolgt wurde. Wenn der TI-Prozess noch läuft, können sich einige der Ablaufverfolgungsinformationen im Puffer befinden. Das Beenden der Anwendung oder das Durchführen eines weiteren TI-Aufrufs innerhalb der Anwendung wird den Puffer leeren, um die gesamte Ablaufverfolgung des ersten TI-Aufrufs anzuzeigen.

          TBGen invoke entered for Class: BankingCicsElmLink.Accounts
    Non-Persistent
    Attempting to acquire library reader and load HIS object assembly
    Method: GetBalance
    Using configured RE for this object
    Remote Environment: ELM Link RE
    Aggregate Converter: Microsoft.HostIntegration.TI.AggregateConverter, Microsoft.HostIntegration.TI.AggregateConverter, Version=10.0.1000.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
    Primitive Converter: Microsoft.HostIntegration.Common.BasePrimitiveConverter, Microsoft.HostIntegration.Common.BasePrimitiveConverter, Version=10.0.1000.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
    Transport: Microsoft.HostIntegration.TI.ELMTransport, Microsoft.HostIntegration.TI.ELMTransport, Version=10.0.1000.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
    State Machine: Microsoft.HostIntegration.TI.GenericLinkStateMachine, Microsoft.HostIntegration.TI.GenericLinkStateMachine, Version=10.0.1000.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
    Invoking the state machine
    Generic Link state machine entered for method: GetBalance
    ELM Transport Initialized, Link: True, Codepage: 37
    Header length: 35
    Header Length: 35, Trailer Length: 0
    Non-Persistent

  9. Ablaufverfolgung deaktivieren

    • Öffnen Sie die Datei TI_Trace.hitd im Trace Viewer, und entfernen Sie die Trace-Ebenen. Wenn die HITD-Datei gespeichert wird, wird die Ablaufverfolgung dynamisch ausgeschaltet. Die TI-Anwendung muss nicht neu gestartet werden.

Beispieldateien für Anwendungskonfigurationen für verschiedene Szenarien

  • Beispiel für ein .Net WIP-Anwendungsprogramm
      <?xml version="1.0"?>
      <configuration>
        <configSections>
          <section name="hostIntegration.ti.wip" type="Microsoft.HostIntegration.ConfigurationSectionHandlers.Ti.Wip.WipConfigurationSectionHandler, Microsoft.HostIntegration.ConfigurationSectionHandlers, Version=10.0.1000.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />
          <section name="hostIntegration.tracing" type="Microsoft.HostIntegration.ConfigurationSectionHandlers.Tracing.TracingConfigurationSectionHandler, Microsoft.HostIntegration.ConfigurationSectionHandlers, Version=10.0.1000.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />
        </configSections>

        <hostIntegration.ti.wip xmlns="http://schemas.microsoft.com/his/Config/TiWip/2020">
          <readOrder appConfig="first" cache="unused" registry="unused"/>
          <remoteEnvironments>
            <remoteEnvironment isDefault="true" name="ELM Link RE" timeout="5" codePage="37">
              <elmLink ipAddress="localhost" ports="7511" requestHeaderFormat="Microsoft"/>
            </remoteEnvironment>
          </remoteEnvironments>
        </hostIntegration.ti.wip>

        <startup>
          <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6"/>
        </startup>

        <hostIntegration.tracing xmlns="http://schemas.microsoft.com/his/Tracing/2020">
          <traceOptions traceDefinitionFile="C:\Tracing\TI_Trace.hitd"
                        writeTraceFile="true"
                        fileNamePreamble="TI_Tracing"
                        traceFileFolder="C:\Tracing\" />
        </hostIntegration.tracing>
      </configuration>
  • Beispiel für eine BizTalk-Anwendung mit dem BizTalk-Adapter für Hostanwendungen – %BTSINSTALLPATH%\BTSNTSvc.exe.config or %BTSINSTALLPATH%\BTSNTSvc64.exe.config Datei: 
    Here is my text
  • Beispiel für eine IIS-Anwendung mit der TI-Laufzeit 
    Here is my text
  • Beispiel für eine VOM TI-Host initiierte Verarbeitungsanwendung (HIP) – %SNAROOT%\HIPService.exe.config Datei: 
    Here is my text

Siehe auch

SNA Trace Utility – Das SNA Trace-Hilfsprogramm kann hilfreich sein, wenn das TI-Objekt APPC über ein HostIntegration Server Gateway verwendet. Dieses Dienstprogramm erfasst den APPC-Datenverkehr zu und vom Host. Wenn das TI-Objekt direkt über TCP/IP mit dem Hostsystem kommuniziert, hilft dieses Hilfsprogramm nicht.

  • Last updated on