Compartir a través de

Seguimiento y depuración

El integrador de transacciones (TI) proporciona un seguimiento detallado de las llamadas de procesamiento iniciado por Windows (WIP) y las llamadas de procesamiento iniciado por host (HIP). Este seguimiento se realiza mediante la habilitación del seguimiento en el archivo de configuración de la aplicación junto con un archivo de definición de seguimiento de integración de host (.hitd) que describe lo que se debe rastrear. El seguimiento se puede activar y desactivar mediante el archivo hitd. El seguimiento también se puede activar y desactivar a través del archivo de configuración de la aplicación; sin embargo, el proceso de TI debe reiniciarse para que la nueva configuración surta efecto porque el archivo de configuración de la aplicación solo se lee cuando se inicia el proceso de TI.

En las instrucciones siguientes se muestra cómo configurar el seguimiento donde se ubicarán los archivos de seguimiento en una carpeta C:\Tracing. Se puede usar una carpeta diferente si es necesario: es importante que la cuenta que ejecuta el proceso de TI tenga acceso de lectura y escritura a la carpeta de seguimiento.

  1. Crear la carpeta de seguimiento, C:\Tracing

  2. Crear un archivo de definición para el seguimiento de la integración del host (HITD)

  3. Inicie el Visor de seguimiento (HIS debe estar instalado): Iniciar - Ejecutar – histraceviewer

  4. En el menú Archivo, seleccione Nuevo archivo de definición. TI_Trc02b1

  5. Seleccionar WIP del integrador de transacciones: TI_Trc_02c

  6. Tamaño de seguimiento y Selecciones: los niveles de seguimiento se pueden establecer para cada componente. Si se establece un nivel de seguimiento en un componente superior, ese nivel de seguimiento también se aplica a los componentes subordinados.

    • Haga clic con el botón derecho en "Niveles de seguimiento" y seleccione "Nuevo nivel". TI_Trc_02d
    • Seleccione uno o varios niveles y haga clic en Aceptar. TI_Trc_02e
    • Al seleccionar todas las opciones, se reflejará "TODAS" después de hacer clic en Aceptar. TI_Trc_02f
    • Guarde el nuevo archivo HITD como TI_Trace en el directorio C:\Tracing. Cierre el Visor de seguimiento. TI_Trc_02g

  7. Actualice el archivo de configuración de la aplicación con información de configuración de seguimiento.

    Para el procesamiento iniciado por Windows (WIP), el app.config en el proyecto .Net de TI se puede modificar con la información de configuración de seguimiento y se incluirá en el <archivo appname>.exe.config cuando se compile la aplicación. Si la aplicación ya se ha compilado, el <archivo appname>.exe.config se puede modificar directamente con esta información.

    Si se está utilizando el adaptador de BizTalk para aplicaciones host (BAHA) dentro de BizTalk, el archivo de configuración que debe modificarse es el archivo de configuración exe de BizTalk Server para el Host de BizTalk seleccionado para el puerto BAHA dentro de la aplicación de BizTalk. El archivo de configuración se encuentra en %BTSINSTALLPATH% y tiene un nombre de BTSNTSvc.exe.config o BTSNTSvc64.exe.config en función de si se trata de un proceso de host de 32 o 64 bits que usa el puerto BAHA.

    Si se usa el procesamiento iniciado por host (HIP), es el archivo HIPService.exe.config que se debe modificar. Este archivo se encuentra en %SNAROOT%.

    Agregue la siguiente instrucción de sección dentro del elemento configSections. Agregar un elemento configSections si no existe uno

    La <instrucción configSections> debe estar inmediatamente después de <configuration> y antes de la <sección de inicio>.

    Para HIS 2016 , escriba la siguiente línea dentro del elemento 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>

    Para HIS 2013 , escriba la siguiente línea dentro del elemento configSections (la diferencia es el cambio de versión):

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

    Agregue los siguientes elementos básicos de configuración de seguimiento a la sección al final de la sección de configuración justo antes de la instrucción de cierre de la <sección /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. Ejecute la aplicación para comenzar el seguimiento. Si se realizaron cambios en el archivo de configuración de la aplicación, el proceso que usa el entorno de ejecución de TI debe reiniciarse para habilitar el seguimiento. Si usa BizTalk, se debe reiniciar la instancia de host. Si usa IIS, se debe reiniciar el sitio web. Si ejecuta un archivo .Net exe, ese programa debe reiniciarse.

    • Busque en la carpeta C:\Tracing para ver uno o varios archivos HITF (archivo de seguimiento de integración de host). El nombre del archivo será TI_Tracing_<número de identificación del proceso>_<fecha y hora>.hitf. Por ejemplo:

      TI_TRACING_6076_AUG_29_2017_13_00_52_421.HITF

    • Haga doble clic en el archivo HITF para abrirlo en el Visor de seguimiento y examine lo que se ha rastreado. Si el proceso de TI sigue en ejecución, parte de la información de seguimiento puede estar en el búfer. Salir de la aplicación o ejecutar otra llamada de TI dentro de la aplicación vaciará el búfer, lo que permitirá ver todo el seguimiento de la primera llamada de 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. Desactivación del seguimiento

    • Abra el archivo TI_Trace.hitd en el Visor de Trazas y quite los niveles de trazas. Cuando se guarda el archivo hitd, el seguimiento se desactivará automáticamente. No es necesario reiniciar la aplicación de TI.

Archivos de configuración de aplicación de ejemplo para varios escenarios

  • Ejemplo de un programa de aplicaciones WIP de .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>
  • Ejemplo de una aplicación de BizTalk mediante el adaptador de BizTalk para aplicaciones host: %BTSINSTALLPATH%\BTSNTSvc.exe.config or %BTSINSTALLPATH%\BTSNTSvc64.exe.config archivo: 
    Here is my text
  • Ejemplo de una aplicación IIS mediante el entorno de ejecución de TI 
    Here is my text
  • Ejemplo de una aplicación de procesamiento iniciado por host de TI (HIP): %SNAROOT%\HIPService.exe.config archivo: 
    Here is my text

Véase también

Utilidad de seguimiento de SNA - La utilidad de seguimiento de SNA puede ser de utilidad si el objeto de TI usa APPC a través de una puerta de enlace de Host Integration Server. Esta utilidad capturará el tráfico APPC hacia y desde el host. Si el objeto ti se comunica directamente a través de TCP/IP con el sistema host, esta utilidad no le ayudará.

  • Last updated on