Partager via

Suivi et débogage

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

Les instructions suivantes montrent comment configurer le suivi où se trouvent les fichiers de trace dans un dossier C :\Tracing. Un autre dossier peut être utilisé si nécessaire : il est important que le compte exécutant le processus TI dispose d’un accès en lecture/écriture au dossier de trace.

  1. Créer le dossier de suivi, C :\Tracing

  2. Créer un fichier de définition de trace d’intégration d’hôte (HITD)

  3. Démarrez la visionneuse de trace (HIS doit être installée) : Démarrer - Exécuter – histraceviewer

  4. Dans le menu Fichier, sélectionnez Nouveau fichier de définition. TI_Trc02b1

  5. Sélectionner l’intégrateur de transactions WIP : TI_Trc_02c

  6. Taille de traçage et sélections : les niveaux de traçage peuvent être définis pour chaque composant. Si un niveau de trace est défini sur un composant supérieur, ce niveau de trace s’applique également aux composants subordonnés.

    • Cliquez avec le bouton droit sur « Niveaux de trace », puis sélectionnez « Nouveau niveau ». TI_Trc_02d
    • Sélectionnez un ou plusieurs niveaux, puis cliquez sur OK. TI_Trc_02e
    • La sélection de toutes les options fera que « TOUT » sera affiché après avoir cliqué sur OK. TI_Trc_02f
    • Enregistrez le nouveau fichier HITD en tant que TI_Trace dans le répertoire C :\Tracing. Fermez la visionneuse de traces. TI_Trc_02g

  7. Mettez à jour le fichier de configuration de l’application avec les informations de configuration de trace.

    Pour le traitement initié par Windows (WIP) le app.config dans le projet TI .Net peut être modifié avec les informations de configuration de trace et sera inclus dans le <fichier appname>.exe.config lors de la compilation de l’application. Si l’application a déjà été compilée, le <nom d’application>.exe.config fichier 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 exe BizTalk Server pour l’hôte BizTalk sélectionné pour le port BAHA dans l’application BizTalk. Le fichier config se trouve à %BTSINSTALLPATH% et a un nom de BTSNTSvc.exe.config ou de BTSNTSvc64.exe.config selon qu’il s’agit d’un processus hôte 32 bits ou 64 bits que le port BAHA utilise.

    Si le traitement initié par l’hôte (HIP) est utilisé, il s’agit du fichier HIPService.exe.config qui doit être modifié. Ce fichier se trouve à %SNAROOT%.

    Ajoutez l’instruction de section suivante à l’intérieur de l’élément configSections. Ajouter un élément configSections s’il n’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 la modification 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 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>

  8. Exécutez l’application pour commencer le suivi. Si des modifications ont été apportées au fichier de configuration de l’application, le processus que le runtime TI utilise doit être redémarré pour activer le suivi. 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 une exe .Net, ce programme doit être redémarré.

    • Recherchez dans le dossier C :\Tracing pour afficher un ou plusieurs fichiers HITF (Fichier de trace d’intégration d’hôte). Le nom du fichier sera TI_Tracing_<numéro d'identification du processus>_<date et heure>.hitf. Par exemple:

      TI_TRACING_6076_AUG_29_2017_13_00_52_421.HITF

    • Double-cliquez sur le fichier HITF pour l’ouvrir dans la Visionneuse de suivi et examinez les éléments tracés. Si le processus TI exécute toujours certaines des informations de trace peuvent se trouver dans la mémoire tampon, la fermeture de l’application ou l’exécution d’un autre appel TI au sein de l’application videra la mémoire tampon pour voir la trace complète 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

  9. Désactivation du suivi

    • Ouvrez le fichier TI_Trace.hitd dans Trace Viewer et supprimez les niveaux de trace. Lorsque le fichier hitd est enregistré, le traçage sera 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 .Net WIP
      <?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 d’application BizTalk à l’aide de l’adaptateur BizTalk pour les applications hôtes - fichier %BTSINSTALLPATH%\BTSNTSvc.exe.config or %BTSINSTALLPATH%\BTSNTSvc64.exe.config : 
    Here is my text
  • Exemple d’application IIS utilisant le runtime TI 
    Here is my text
  • Exemple d’application HIP (Host Initiated Processing) TI - fichier %SNAROOT%\HIPService.exe.config : 
    Here is my text

Voir aussi

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

  • Last updated on