Traçage et débogage

Article
07/21/2023

Transaction Integrator (TI) fournit un suivi détaillé des appels Windows Initiated Processing (WIP) et des appels Host Initiated Processing (HIP). Ce traçage est effectué via l’activation du suivi dans le fichier de configuration d’application avec un fichier de définition de trace d’intégration de l’hôte (.hitd) qui décrit ce qui doit être suivi. Le traçage peut être activé et désactivé via le fichier hitd. Le traçage peut également être activé et désactivé par le biais du fichier de configuration d’application. Toutefois, le processus TI doit être redémarré pour que la nouvelle configuration prenne effet, car le fichier de configuration d’application est lu uniquement lorsque le processus TI est démarré.

Les instructions suivantes indiquent comment configurer le traçage là où se trouvent les fichiers de trace dans un dossier C:\Tracing. Vous pouvez utiliser un autre dossier si nécessaire. Il est important que le compte qui exécute le processus TI dispose d’un accès en lecture/écriture au dossier de trace.

Créer le dossier de suivi, C :\Tracing
Créer un fichier de définition de trace d’intégration de l’hôte (HITD)
Démarrez Trace Viewer (qui doit être installé) : Démarrer - Exécuter – histraceviewer
Dans le menu Fichier, sélectionnez Nouveau fichier de destination.
Sélectionnez WiP d’intégrateur de transactions :
Taille et sélections de traçage : les niveaux de trace peuvent être définis pour chaque composant. Si un niveau de trace est défini sur un composant supérieur, ce niveau de traçage s’applique également aux composants subordonnés.
- Cliquez avec le bouton droit sur « Niveaux de trace » et sélectionnez « Nouveau niveau ».
- Sélectionnez un ou plusieurs niveaux et cliquez sur OK.
- Si vous sélectionnez toutes les options, « Tout » sera reflété après avoir cliqué sur OK.
- Enregistrez le nouveau fichier HITD en tant que TI_Trace dans le répertoire C:\Tracing. Fermez Trace Viewer.
Mettez à jour le fichier de configuration d’application avec les informations de configuration de trace.

Pour le traitement windows initié (WIP), les app.config dans le projet .Net TI peuvent être modifiés avec les informations de configuration de trace et sont inclus dans le <fichier appname>.exe.config lors de la compilation de l’application. Si l’application a déjà été compilée, le <fichier appname>.exe.config peut être modifié directement avec ces informations.

Si l’adaptateur BizTalk pour les applications hôtes (BAHA) est utilisé dans BizTalk, le fichier de configuration qui doit être modifié est le fichier de configuration exécutable BizTalk Server pour l’hôte BizTalk sélectionné pour le port BAHA dans l’application BizTalk. Le fichier de configuration se trouve dans %BTSINSTALLPATH% et a un nom de BTSNTSvc.exe.config ou BTSNTSvc64.exe.config selon qu’il s’agit d’un processus hôte 32 bits ou 64 bits utilisé par le port BAHA.

Si vous utilisez Host Initiated Processing (HIP), c’est le fichier HIPService.exe.config qui doit être modifié. Ce fichier se trouve dans %SNAROOT%.

Ajoutez l’instruction de section suivante à l’intérieur de l’élément configSections. Ajouter un élément configSections s’il n’en existe pas

L’instruction <configSections> doit être immédiatement après <la configuration> et avant la section de <démarrage> .

Pour HIS 2016, entrez la ligne suivante dans l’élément configSections :
```
<configSections>
   <section name="hostIntegration.tracing" type="Microsoft.HostIntegration.ConfigurationSectionHandlers.Tracing.TracingConfigurationSectionHandler, Microsoft.HostIntegration.ConfigurationSectionHandlers, Version=10.0.1000.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />
</configSections>
```
Pour HIS 2013, entrez la ligne suivante dans l’élément configSections (la différence est le changement de version) :
```
<configSections>
   <section name="hostIntegration.tracing" type="Microsoft.HostIntegration.ConfigurationSectionHandlers.Tracing.TracingConfigurationSectionHandler, Microsoft.HostIntegration.ConfigurationSectionHandlers, Version=9.0.1000.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />
</configSections>
```
Ajoutez les éléments de configuration de suivi de base suivants à la section à la fin de la section de configuration juste avant l’instruction <de fermeture de la section /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>
```

Exécutez l’application pour commencer le traçage. Si des modifications ont été apportées au fichier de configuration de l’application, le processus utilisé par le runtime TI doit être redémarré pour activer le traçage. Si vous utilisez BizTalk, l’instance hôte doit être redémarrée. Si vous utilisez IIS, le site web doit être redémarré. Si vous exécutez un fichier exe .Net, ce programme doit être redémarré.

Examinez le dossier C:\Tracing pour voir un ou plusieurs fichiers HITF (Host Integration Trace File). Le nom du fichier sera TI_Tracing_<process id number>_<date et time.hitf>. Par exemple :

TI_TRACING_6076_AUG_29_2017_13_00_52_421.HITF

Double-cliquez sur le fichier HITF pour l’ouvrir dans Trace Viewer et examiner ce qui a été tracé. Si le processus TI est toujours en cours d’exécution, il se peut que certaines informations de trace se trouvent dans la mémoire tampon, et donc que la fermeture de l’application ou l’exécution d’un autre appel TI au sein de l’application vide la mémoire tampon pour voir l’intégralité de la trace du premier appel TI.

    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

Désactivation du traçage
- Ouvrez le fichier TI_Trace.hitd dans Trace Viewer et supprimez les niveaux de trace. Lorsque le fichier hitd est enregistré, le traçage est désactivé dynamiquement. Il n’est pas nécessaire de redémarrer l’application TI.

Exemples de fichiers de configuration d’application pour différents scénarios

Exemple pour un programme d’application WIP .NET

      <?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>

Exemple pour une application BizTalk utilisant l’adaptateur BizTalk pour les applications hôtes - fichier %BTSINSTALLPATH%\BTSNTSvc.exe.config ou %BTSINSTALLPATH%\BTSNTSvc64.exe.config :
```
Here is my text
```
Exemple pour une application IIS utilisant le runtime TI
```
Here is my text
```
Exemple pour une application de traitement lancée par l’hôte TI (HIP) - fichier %SNAROOT%\HIPService.exe.config :
```
Here is my text
```

Voir aussi

Utilitaire de trace SNA : l’utilitaire de trace SNA peut être utile si l’objet TI utilise APPC via une passerelle Host Integration Server. Cet utilitaire capture le trafic APPC depuis et vers l’hôte. Si l’objet TI communique directement via TCP/IP avec le système hôte, cet utilitaire ne vous aidera pas.

Partager via

Traçage et débogage

Exemples de fichiers de configuration d’application pour différents scénarios

Voir aussi

Ressources supplémentaires