以前のバージョンの Windows 側開始処理 (WIP) の移行に関する考慮事項

このトピックでは、以前のバージョンのトランザクション インテグレーター Windows-Initiated 処理から移行する方法について説明する次のセクションについて説明します。

• COM タイプ ライブラリの変換

• .NET アセンブリのアップグレード

• その他の考慮事項

COM タイプ ライブラリの変換

タイプ ライブラリ (TLV) はサポートされなくなりました。 既存の COMTI または TI TLB タイプ ライブラリを TI .NET アセンブリに変換してから、再デプロイする必要があります。

変換を実行するには、次の 2 つの方法があります。

• トランザクション インテグレーター変換ツール (TIConverionTool.exe) を使用することをお勧めします。 これは、単一変換とバッチ変換の両方をサポートします。

• 特殊なケースでは、Designerインポート機能を使用して単一の TLV を変換します。

  TIConversionTool.exe は、コマンド プロンプトから実行したり、PowerShell などの別のプログラムから呼び出したりできるコマンド ライン ユーティリティです。 TIConverionTool.exe では、単一操作とバッチ操作の両方がサポートされます。 TIConversionTool.exe は、次のフォルダーにあります。

OS	場所
X64	C:\Program Files\Microsoft Host Integration Server 2020\SysWOW64\
x86	C:\Program Files\Microsoft Host Integration Server 2020\system\

TIConverionTool ユーティリティのコマンド ライン構文の詳細については、「 トランザクション インテグレーター変換ツール」を参照してください。

変換プロセスが完了したら、変換中の TLB が以前に作成された場合に、既存の RU を使用して新しい .NET オブジェクトをデプロイできます。 以前のバージョンの HIS で作成された TLV 用の新しい RE を作成する必要があります。

既存のタイプ ライブラリの削除

新しいアセンブリを展開する前に、TI マネージャーを使用して既存の TLB を削除する必要があります。 新しいバージョンの TI にはより厳しい制約があるため、古い TLB がそれらの制約に違反している場合は、いくつかの警告またはエラーが発生する可能性があります。 たとえば、変換プロセス中に ADO RecordSets は .NET DataTables に変換されます。 変換される TLB が名前空間とインターフェイスの両方に同じ名前を持つ場合、変換ツールはインターフェイス名に_renameを自動的に追加します。 変換される TLB の ProgID の長さが 39 文字を超える場合、変換ツールによってエラーがスローされ、TLB は変換されません。 ProgID が 39 文字を超える TLV の場合、変換を実行するには、Designer/ Import メソッドを使用する必要があります。 TI トランザクション 2010 では IMS 暗黙的および明示的のサポートが削除されており、これらのタイプの TLV は IMS Connect モデルを使用して に変換されます。 詳細については、「 IMS Connect」を参照してください。

Designerを使用したタイプ ライブラリのアップグレード

同じ特性を持つ新しい .NET アセンブリを作成することで、タイプ ライブラリを一度に 1 つずつアップグレードできます。 その後、既存の TLB をインポートできます。 TLB でクライアント コンテキストが有効になっている場合、インポート プロセス中に TLB はオブジェクトの古いスタイルのクライアント コンテキスト配列から新しいクライアント コンテキスト オブジェクト モデルに変換されます。 その後、クライアント アプリケーションを変更して、新しい Context オブジェクト モデルを操作する必要があります。 このプロセスは時間がかかり、エラーが発生しやすく、TIConversionTool ユーティリティでサポートされていない場合にのみ使用してください。 特殊なケースは次のとおりです。

• 永続化Connectionsクライアント コンテキスト オブジェクト モデルを使用する必要があります。または、呼び出しは失敗します。 また、新しいコンテキスト モデルを操作するようにクライアント コードを変更する必要もあります。

• ProgID が 39 文字を超える TLV。

• 動的 RU などの新しいコンテキスト対応機能。

  詳細については、ヘルプ トピック「TI Designerの操作」を参照してください。

.NET アセンブリのアップグレード

.NET アセンブリの作成に使用された HIS のバージョン、ホスティング モデル (.NET リモート処理、Web サービス、WCF サービスまたは直接呼び出し)、プログラミング モデルに応じて、さまざまなオプションがあります。 ほとんどの .NET アセンブリは、変更なしで引き続き機能します。 場合によっては、アセンブリを変換して再デプロイする必要があります。 単一変換とバッチ変換の両方をサポートする TIConversionTool.exe ユーティリティを使用することをお勧めします。 特殊なケースでは、Designerとインポート機能を使用して、一度に 1 つのアセンブリを変換できます。

HIS .NET アセンブリでは、ネットワークの種類 LU6.2 を使用していない限り、必要な変更は必要ありません。 この場合、アセンブリは、TIConverionTool.exe ユーティリティを使用するか、Designerのインポート機能を使用して変換する必要があります。

IMS 暗黙的および IMS 明示的はサポートされなくなり、TIConversionTool.exe を使用して変換されると IMS Connect プログラミング・モデルに変換されます。 詳細については、「 IMS Connect」を参照してください。

変換されたアセンブリの配置

変換プロセスが完了したら、変換するアセンブリの場合は、既存の RE を使用して新しい .NET オブジェクトをデプロイできます。

.NET リモート処理ホスティング モデルのサポートが削除されました。 WCF または Direct Call ホスティング モデルを使用して.NET アセンブリをデプロイする必要があります。

Designerを使用したアセンブリのアップグレード

Designerインポート機能を使用して、特殊なケースでのみ HIS 2006 および HIS 2004 .NET アセンブリを変換します。 インポート プロセス中にアセンブリでクライアント コンテキストが有効にされた場合、オブジェクトの古いスタイルのクライアント コンテキスト配列から新しいクライアント コンテキスト オブジェクト モデルに変換されます。 新しいクライアント コンテキスト オブジェクト モデルを操作するには、クライアント アプリケーションを変更する必要があります。 また、デプロイ プロセスの一環として、新しい一致する RE を作成する必要もあります。

永続化Connections新しいクライアント コンテキスト オブジェクト モデルを使用する必要があります。または、呼び出しは失敗します。 また、新しいコンテキスト モデルを操作するようにクライアント コードを変更する必要もあります。

その他の考慮事項

タイプ ライブラリまたはアセンブリが完全にアップグレードされると、使用したアップグレード プロセスに応じて、古いタイプ ライブラリの次の 2 つの側面が更新される場合があります。

• リモート環境クラス。

• ライブラリ レベルで定義されている既定の変換情報。 データ型の変換の既定値は、.NET と COM では異なります。 詳細については、「Data Types」(データ型) を参照してください。

  状況とアプリケーションの要件に応じて、一方または両方を更新する必要がある場合があります。 次の表では、ユーザー アクション、TI アクション、結果、推奨事項について説明します。

ユーザーの操作	TI アクション	結果	使用する場合
[なし] : 既存の .NET オブジェクトと RU を使用する	次の変更は行われません。 -再 - Ti オブジェクト GUID - .NET アセンブリの既定の変換	- TI .NET オブジェクトと RE は完全に機能します。 - タイプ ライブラリと RE 内のプロパティは変更できなくなりました。 - TI Project で作成された新しい .NET アセンブリを古い RU に関連付けることはできません。 - 既存のクライアントは変更を必要としません。 - COM TLV および NET LU6.2 アセンブリは実行されず、TIConverisionTool.exe ユーティリティを使用して変換する必要があります。	- 以前のバージョンからの初期インプレース アップグレード。 古い TI .NET オブジェクトと古い RU は機能し、変更する必要はありません。
TIConversionTool ユーティリティを使用して TLV と .NET アセンブリを変換する	次の変更は行われません。 - ClientContext モデル - リモート環境クラスを更新しません	- 古い型 TLV と .NET アセンブリは、新しいバージョンで動作するように更新されます。 更新された .NET アセンブリは、新しい RU にのみ関連付けることができます。 変換された TLV と .NET アセンブリも、RU に関連付けすることをお勧めします。 古いタイプ ライブラリを .NET アセンブリに移行する場合、TI では、次を含むすべての Visual Basic バージョン 6.0 Automation データ型も Visual Basic .NET データ型に移行されます。 - 整数から Short - Long から Integer - 通貨から 10 進数 - レコードセットから DataTable へ - UDT から構造体へ NewRecordset 関数を使用して切断されたレコードセットを作成するクライアント アプリケーションは、コードを変更する必要があります。 NewRecordset 関数は.NET ではサポートされていません。 - GUID の変更により、宣言型バインディングを使用する既存の COM クライアントを再コンパイルする必要があります。	- HIS 2009 TLB および .NET LU62 アセンブリの移行。 - HIS 2006 または HIS 2004 TLB および .NET アセンブリからの移行。 - Host Integration Server 2009 環境で新しい RE を作成する必要があります。 - RE 機能の使用。 - HIS でサポートされている環境への移行。 - プログラミング モデルは同じままです。
Designer インポート機能を使用して TLV と .NET アセンブリを変換する	- リモート環境クラスを更新します。 - 新しい .NET アセンブリを生成します 新しいオブジェクト モデル ClientContext を使用します	メソッド プロパティ Include Context Parameter は、自動的に True に設定 されます。 クライアント アプリケーションがクライアント コンテキストをサポートする必要なく、クライアント コンテキストが省略可能なパラメーターであるため、変更せずに動作する必要がある場合。 Visual Studio TI プロジェクトで、 メソッドの [コンテキスト パラメーターを含める] を False に設定します。 ClientContext モデルがオブジェクト配列からモデルからオブジェクト モデルに変換されました。 ClientContext が有効になっている新しいオブジェクト モデルを操作するには、クライアント アプリを変更する必要があります。 古いタイプ ライブラリを .NET アセンブリに移行する場合、TI では、次を含むすべての Visual Basic バージョン 6.0 Automation データ型も Visual Basic .NET データ型に移行されます。 - 整数から Short - Long から Integer - 通貨から 10 進数 - レコードセットから DataTable へ - UDT から構造体へ NewRecordset 関数を使用して切断されたレコードセットを作成するクライアント アプリケーションは、コードを変更する必要があります。 NewRecordset 関数は.NET ではサポートされていません。 GUID の変更により、宣言型バインディングを使用する既存の COM クライアントを再コンパイルする必要があります。	- アプリケーションを拡張することを目的として、Host Integration Server 2009 でサイド バイ サイド操作を行うアプリケーションの新しいインスタンスを作成します。 - 新しいクライアント コンテキスト機能 (クライアント セキュリティ、永続的なConnectionsなど) を使用する。 - プログラミング モデルの変更 - ターゲット環境の変更 (CICS、IMS、IBM i) - 開始変更 (WIP、HIP) - IMS 暗黙的または IMS 明示的な .NET アセンブリの変換 39 文字を超える ProgID を持つ TLV。

参照

アプリケーション統合開発ツール