次の方法で共有

トレースとデバッグ

トランザクション インテグレーター (TI) は、Windows 開始処理 (WIP) 呼び出しとホスト開始処理 (HIP) 呼び出しの両方の詳細なトレースを提供します。 このトレースは、アプリ構成ファイルでトレースを有効にし、トレースする必要がある内容を記述する Host Integration Trace Definition ファイル (.hitd) と共に実行します。 トレースは、hitdファイルを通じてオン/オフを切り替えられます。 アプリ構成ファイルを使用してトレースを有効または無効にすることもできますが、TI プロセスが開始されたときにのみアプリ構成ファイルが読み取られるので、新しい構成を有効にするには TI プロセスを再起動する必要があります。

次の手順では、トレース ファイルが C:\Tracing フォルダーに保存されるようにトレースを設定する方法を示します。 必要に応じて別のフォルダーを使用できます。TI プロセスを実行しているアカウントがトレース フォルダーへの読み取り/書き込みアクセス権を持っている必要があります。

  1. トレース フォルダー C:\Tracing を作成する

  2. ホスト統合トレース定義ファイル (HITD) を作成する

  3. トレース ビューアーを起動する (HIS をインストールする必要があります): Start - Run – histraceviewer

  4. [ファイル] メニューの [新しい定義ファイル] を選択します。 TI_Trc02b1

  5. トランザクション インテグレーター WIP の選択: TI_Trc_02c

  6. トレース サイズと選択: トレース レベルはコンポーネントごとに設定できます。 トレース レベルが上位のコンポーネントで設定されている場合、そのトレース レベルは下位コンポーネントにも適用されます。

    • [トレース レベル] を右クリックし、[新しいレベル] を選択します。 TI_Trc_02d
    • 1 つ以上のレベルを選択し、[OK] をクリックします。 TI_Trc_02e
    • すべてのオプションを選択すると、[OK] をクリックすると "ALL" が反映されます。 TI_Trc_02f
    • 新しい HITD ファイルを C:\Tracing ディレクトリにTI_Traceとして保存します。 トレース ビューアーを閉じます。 TI_Trc_02g

  7. トレース構成情報を使用してアプリケーション構成ファイルを更新します。

    Windows Initiated Processing (WIP) の場合、TI .Net プロジェクトの app.config はトレース構成情報で変更でき、アプリケーションのコンパイル時に <appname>.exe.config ファイルに含まれます。 アプリケーションが既にコンパイルされている場合は、 <appname>.exe.config ファイルをこの情報で直接変更できます。

    BizTalk 内で BizTalk Adapter for Host Applications (BAHA) が使用されている場合、変更する必要がある構成ファイルは、BizTalk アプリケーション内の BAHA ポートに対して選択された BizTalk ホストの BizTalk Server exe 構成ファイルです。 構成ファイルは %BTSINSTALLPATH% にあり、BAHA ポートが使用している 32 ビットまたは 64 ビットのホスト プロセスのどちらであるかに応じて、BTSNTSvc.exe.config または BTSNTSvc64.exe.config のいずれかの名前を持ちます。

    ホスト開始処理 (HIP) を使用している場合は、変更する必要がある HIPService.exe.config ファイルです。 このファイルは %SNAROOT%にあります。

    configSections 要素内に次のセクション ステートメントを追加します。 configSections 要素が存在しない場合は追加する

    <configSections> ステートメントは、<configuration> の直後と<startup> セクションの前にする必要があります。

    HIS 2016 の場合は、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>

    HIS 2013 では、configSections 要素内に次の行を入力します (違いはバージョンの変更です)。

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

    次の基本的なトレース構成要素を、 </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. アプリケーションを実行してトレースを開始します。 アプリケーション構成ファイルに変更が加えられた場合、トレースを有効にするには、TI ランタイムが使用しているプロセスを再起動する必要があります。 BizTalk を使用している場合は、ホスト インスタンスを再起動する必要があります。 IIS を使用している場合は、Web サイトを再起動する必要があります。 .Net exe を実行する場合は、そのプログラムを再起動する必要があります。

    • C:\Tracing フォルダーを見て、1 つ以上の HITF (Host Integration Trace File) ファイルを確認します。 ファイルの名前は、TI_Tracing_<process id number>_<date と time>.hitf になります。 例えば次が挙げられます。

      TI_TRACING_6076_AUG_29_2017_13_00_52_421.HITF

    • HITF ファイルをダブルクリックしてトレース ビューアーで開き、トレースされた内容を確認します。 TI プロセスが引き続き一部のトレース情報をバッファー内で実行している場合は、アプリケーションを終了するか、アプリケーション内で別の TI 呼び出しを実行すると、バッファーがフラッシュされ、最初の 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. トレースをオフにする

    • トレース ビューアーで TI_Trace.hitd ファイルを開き、トレース レベルを削除します。 ヒットしたファイルが保存されると、トレースは動的にオフになります。 TI アプリケーションを再起動する必要はありません。

さまざまなシナリオのサンプル アプリケーション構成ファイル

  • .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>
  • BizTalk Adapter for Host Applications を使用した BizTalk アプリケーションのサンプル - %BTSINSTALLPATH%\BTSNTSvc.exe.config or %BTSINSTALLPATH%\BTSNTSvc64.exe.config ファイル: 
    Here is my text
  • TI ランタイムを使用した IIS アプリケーションのサンプル 
    Here is my text
  • TI ホスト開始処理 (HIP) アプリケーションのサンプル - %SNAROOT%\HIPService.exe.config ファイル: 
    Here is my text

こちらもご覧ください

SNA トレース ユーティリティ - SNA トレース ユーティリティは、TI オブジェクトがホスト統合サーバー ゲートウェイ経由で APPC を使用している場合に役立ちます。 このユーティリティは、ホストとの間の APPC トラフィックをキャプチャします。 TI オブジェクトが TCP/IP 経由でホスト システムと直接通信している場合、このユーティリティは役に立たなくなります。