ホスト アプリケーション用 BizTalk Adapter の構成
[ホスト アプリケーション用 BizTalk Adapter の構成] ダイアログ ボックスを使用すると、リモートの IBM CICS、IMS、または iSeries システムへの接続を定義し、管理することができます。 [接続文字列] プロパティ値フィールドをクリックすると起動します。 [ホスト アプリケーション用 BizTalk Adapter の構成] ダイアログ ボックスを使用して、TI .NET アセンブリを追加できます。 これをマッピングの一部として使用し、マッピングのインポート、エクスポート、削除、接続文字列の編集、および TI .NET アセンブリのプロパティの表示を行うことができます。
[ホスト アプリケーション構成] ダイアログ ボックスのコンポーネントには、ツール バー、メニュー、データ グリッド、および結果ペインがあります。 このトピックは、実行できるさまざまなタスクについて説明する次のセクションで構成されています。
以前のバージョンの Host Integration Server からのアップグレード
ツール バーとメニュー コマンド
接続文字列を作成および管理するコマンドには、ツール バーと状況依存メニューのどちらからもアクセスできます。 データ グリッド内の任意の場所を右クリックすると、状況依存のメニューが表示されます。 たとえば、接続文字列を右クリックすると、マッピングの表示、編集、削除、インポート、およびエクスポートを行うことができます。 [接続文字列] をダブルクリックすると、編集モードで表示できます。 DELETE キーを押すと、現在選択している項目が削除され、F1 キーを押すとオンライン ヘルプが開きます。
実行できる操作は次のとおりです。
グローバル アセンブリ キャッシュ (GAC) から TI .NET アセンブリを追加するか、ローカル ファイル パスを使用して、アセンブリをマッピングに追加します。 列には、アセンブリから反映された既定値が設定されます。 必要な値を入力しない場合、既定の接続文字列は使用できません。
選択したマッピングを削除します。 削除を確認するためのダイアログ ボックスが表示されます。
マッピングが選択されている場合は、マッピングの接続文字列の部分を編集します。 接続文字列を編集するには、 [接続文字列] ダイアログ ボックスを開きます。
マッピングを XML にエクスポートすると、マッピングをバックアップできます。 これらは、後でマッピングのインポート機能を使用して復元できます。 インポート/エクスポート機能を使用すると、エンドポイント間でマッピングを共有できます。
[マッピングまたは RE のインポート] を使用すると、 [ホスト アプリケーション用 BizTalk Adapter の構成] ダイアログ ボックスによってエクスポートされた XML をインポートできます。 また、マッピングを選択したとき TI マネージャーによってエクスポートされた RE 定義をインポートすることもできます。
TI .NET アセンブリのプロパティを表示すると、アセンブリのプロパティが表示されます。 XML タグには、このアセンブリがサポートする入力/出力ドキュメントの名前が表示されます。 メソッド名はタグ名の一部ですが、マッピングの検索時には使用されません。 すべてのプロパティは読み取り専用です。
[DataGrid のマッピング] ウィンドウ
[DataGrid のマッピング] ダイアログ ボックスには、次の項目があります。
状態 (完了または不完全)。 接続文字列に接続情報がない場合は、警告として、赤い丸で囲んだ白い感嘆符が表示されます。 不足している情報を追加すると、警告は表示されなくなります。
マッピングの一部として使用されている TI アセンブリの ClassName およびインターフェイス名。
アセンブリ名。 アセンブリが GAC から読み込まれた場合はアセンブリの厳密な名前、ローカル アセンブリである場合はアセンブリへの完全パスです。 アセンブリが追加されるとき、このフィールドは自動入力され、読み取り専用になります。
リモート環境では、接続文字列が定義されます。 これは、BizTalk ホスト アプリケーション アダプターから要求を受信するリモート システムの特性を表します。 接続文字列は、リモート ホストとの通信時に使用されるリモート環境の種類、プログラミング モデル、リモート ホスト ID、ネットワーク トランスポート、およびその他の設定で構成されます。
リモート IBM ホストのリモート エンドポイント DNS 名または IP アドレス。
結果ペインには、現在選択されているマッピングの接続文字列の値が表示されます。
マッピングの作成と管理
このセクションでは、実行できるタスクについて説明します。
アセンブリを追加して接続文字列を作成する
ツール バーのフォルダー アイコンをクリックし、 [GAC からアセンブリを追加] または [ローカル アセンブリの追加] を選択します。 [GAC からアセンブリを追加] すると、選択できる GAC 内のすべてのアセンブリを一覧表示するダイアログ ボックスが開きます。 [ローカル アセンブリの追加] を選択した場合は、ローカルにインストールされているアセンブリを参照できます。
アセンブリは、メニューから [GAC の追加] または [ローカル アセンブリの追加] オプションを使用して追加することもできます。
接続文字列を削除する
削除するマッピングを選択します。 ツール バーの [X] アイコンをクリックすると、選択したマッピングが削除されます。 ダイアログ ボックスが表示されたら、削除を確定します。
また、メニューの [マッピングの削除] オプションを使用してマッピングを削除することもできます。
接続文字列を編集する
接続文字列は、RE インスタンスをハイドレートするために使用されます。 アセンブリを指定すると、既定値が設定されます。 選択したマッピングをダブルクリックするか、 [編集] を選択する、または [接続文字列の編集] メニューを選択して [接続文字列] ダイアログ ボックスを開きます。 これにより、指定した RE の接続文字列を編集できます。 必要な値が入力されていない場合は、エラー フラグが表示されます。
RE オブジェクトは、最低限必要なプロパティ値を検証します。 必要なプロパティ値が設定されていない場合、[接続文字列] セルにフラグが設定されます。 必須のプロパティについては、このトピックの「接続文字列の設定とマッピング」セクションを参照してください。 RE 検証はスコープ内で制限されており、不適切な値によって TI ランタイム エラーが発生する可能性があります。
ダイアログ ボックスには、編集可能なプロパティと編集不可能なプロパティがグリッドで表示されます。 下部にある読み取り専用のテキストボックスには、プロパティ グリッドに入力した値に基づいて作成された接続文字列が表示されます。 プロパティは、RE オブジェクトによって定義されたパブリック メソッドに基づいて収集され、値はオブジェクト自体によって定義されます。 プロパティ値を編集しやすいように、いくつかの型コンバーターおよびプロパティ エディターが用意されています。
リモート環境には、ホストに接続するために必要なプロパティが表示されます。 これらは、プロパティ グリッドのアスタリスク (*) によって示されます。 1 つ以上のプロパティが欠落している場合は、赤い丸で囲んだ白い感嘆符がデータ グリッドに表示されます。 この警告は、実行時のオーバーライドを使用して、不足しているプロパティを指定できることを通知します。
セキュリティ設定は、OR 演算子を使用した組み合わせで新しいセキュリティ設定を作成することによって、定義済みのセキュリティ列挙によって制御されます。
Off フラグは、クライアント、パッケージ、およびユーザー専用です。 他の 3 つのいずれかが選択されている場合、Off はクリアされます。 Off を選択すると、他の 3 つのオプションがすべてクリアされます。
以前のリリースから、軽微な変更だけで SSOApplication エディターが移植されます。 関連アプリケーションをプロパティ グリッドで直接指定するか、エディターを使用して、既に作成されているアプリケーションを選択することができます。
接続文字列の設定とマッピング
次の表は、ホスト環境とプログラミング モデルを定義する、サポートされているプロパティを示しています。 アスタリスクは必須のプロパティを示します。
既定値は、RE オブジェクト自体によって設定され、限定的な検証が実行されます。
SNA ユーザー データ
| プロパティ | 値 |
|---|---|
| プロパティ | Value |
| CodePage | 37 |
| ロケール | 1033 |
| **LocalLUName* | |
| **ModeName* | PA62TKNU |
| 名前 | SNAUserData。 読み取り専用です。 |
| **RemoteLUName* | |
| Security | オフ |
| SSOApplication | |
| SynLevel2Supported | False |
| [TimeOut] | 0 |
\* 必須フィールド。
SNA リンク
| プロパティ | 値 |
|---|---|
| プロパティ | Value |
| AdministrationFlags | 0 |
| CodePage | 37 |
| ロケール | 1033 |
| **LocalLUName* | |
| MirrorTranId | CSMI |
| **ModeName* | PA62TKNU |
| 名前 | SNALink。 読み取り専用です。 |
| **RemoteLUName* | |
| Security | オフ |
| SSOApplication | |
| SyncLevel2Supported | False |
| [TimeOut] | 0 |
\* 必須フィールド。
HTTP ユーザー データ
| プロパティ | 値 |
|---|---|
| プロパティ | Value |
| AliasTransactionId | |
| AllowRedirects | False |
| CodePage | 37 |
| **HttpPort* | |
| **Ipaddress* | |
| ロケール | 1033 |
| 名前 | HttpUserData。 読み取り専用です。 |
| Security | オフ |
| SSOApplication | |
| [TimeOut] | 0 |
| UserAgent | |
| UseSsl | False |
\* 必須フィールド。
HTTP リンク
| プロパティ | 値 |
|---|---|
| プロパティ | Value |
| AliasTransactionId | |
| AllowRedirects | False |
| CodePage | 37 |
| Converter | |
| **HttpPort* | |
| **Ipaddress* | |
| ロケール | 1033 |
| MirrorProgramName | |
| 名前 | HttpLink。 読み取り専用です。 |
| Security | オフ |
| SSOApplication | |
| [TimeOut] | 0 |
| UseConverter | False |
| UserAgent | |
| UseSsl | False |
\* 必須フィールド。
IMS LU6.2
| プロパティ | 値 |
|---|---|
| プロパティ | Value |
| CodePage | 37 |
| ロケール | 1033 |
| **LocalLUName* | |
| **ModeName* | PA62TKNU |
| 名前 | IMSLU62。 読み取り専用です。 |
| **RemoteLUName* | |
| Security | オフ |
| SSOApplication | |
| [TimeOut] | 0 |
\* 必須フィールド。
IMS Connect
| プロパティ | 値 |
|---|---|
| プロパティ | Value |
| CodePage | 37 |
| ImsFormatModName | |
| **Ipaddress* | |
| ItocExitName | |
| ロケール | 1033 |
| 名前 | IMSConnect。 読み取り専用です。 |
| OtmaSystemId | |
| Security | オフ |
| SSOApplication | |
| **TCPPorts* | |
| [TimeOut] | 0 |
\* 必須フィールド。
TRM ユーザー データ/リンク
| プロパティ | 値 |
|---|---|
| プロパティ | Value |
| CodePage | 37 |
| ConcurrentServerTransactionId | MSCS |
| **Ipaddress* | |
| ロケール | 1033 |
| 名前 | TRMUserData。 読み取り専用です。 |
| Security | オフ |
| SSOApplication | |
| **TCPPorts* | |
| [TimeOut] | 0 |
\* 必須フィールド。
ELM ユーザー データ/リンク
| プロパティ | 値 |
|---|---|
| プロパティ | Value |
| CodePage | 37 |
| **Ipaddress* | |
| ロケール | 1033 |
| 名前 | ELMUserData。 読み取り専用です。 |
| Security | オフ |
| SSOApplication | |
| **TCPPorts* | |
| [TimeOut] | 0 |
\* 必須フィールド。
Distributed プログラム呼び出し
| プロパティ | 値 |
|---|---|
| プロパティ | Value |
| CodePage | 37 |
| **Ipaddress* | |
| ロケール | 1033 |
| 名前 | DistributedProgramCall。 読み取り専用です。 |
| Security | オフ |
| SSOApplication | |
| **TCPPorts* | |
| [TimeOut] | 0 |
\* 必須フィールド。
System Z ソケット ユーザー データ/リンク
| プロパティ | 値 |
|---|---|
| プロパティ | Value |
| CodePage | 37 |
| **Ipaddress* | |
| ロケール | 1033 |
| 名前 | SystemzSocketsUserData。 読み取り専用です。 |
| Security | オフ |
| SSOApplication | |
| **TCPPorts* | |
| [TimeOut] | 0 |
\* 必須フィールド。
System I ソケット ユーザー データ
| プロパティ | 値 |
|---|---|
| CodePage | 37 |
| **Ipaddress* | |
| ロケール | 1033 |
| 名前 | SystemSocketUserData。 読み取り専用です。 |
| Security | オフ |
| SSOApplication | *TCPPorts |
| [TimeOut] | 0 |
\* 必須フィールド。
マッピングのインポート
[ホスト アプリケーション用 BizTalk Adapter の構成] でエクスポートしたマッピングをインポートするには、 [マッピングまたは RE のインポート] アイコンをクリックします。 [マッピングのインポート] を選択するか、 [ファイル] メニューの [マッピングのインポート] を選択します。 これで、 [ホスト アプリケーション用 BizTalk Adapter の構成] ダイアログ ボックスでエクスポートした XML を参照できます。 インポートするファイルを選択します。 インポート処理で、既存のマッピングは上書きされません。
RE 定義のインポート
TI マネージャーによってエクスポートされた RE 定義をインポートするには、これを使用します。 マッピングを選択したら、 [マッピングまたは RE のインポート] アイコンをクリックします。 [RE のインポート] を選択するか、 [ファイル] メニューの [RE のインポート] を選択します。 これで、TI マネージャーによってエクスポートされた XML を参照できます。 選択できる RE 定義を一覧表示するダイアログ ボックスが表示されます。 選択したマッピングと同じプログラム モデルを持つ RE 定義のみが表示されます。
マッピングのエクスポート
マッピングを XML ファイルにエクスポートするには、 [マッピングを XML にエクスポートする] アイコンをクリックするか、 [ファイル] メニューの [マッピングのエクスポート] をクリックします。 これで、ファイルを保存できる場所を参照できます。 このファイルをインポートするには、マッピングのインポート機能を使用します。
アセンブリのプロパティ
アセンブリの関連プロパティと、このアセンブリがサポートする入力/出力ドキュメントの XML タグ名を表示できます。 メソッド名はタグ名の一部ですが、マッピングの検索時には使用されません。 すべてのプロパティは読み取り専用です。 マッピングを選択し、[アセンブリのプロパティ] アイコンをクリックするか、メニューから [アセンブリのプロパティを表示] を選択します。
以前のバージョンの Host Integration Server からのアップグレード
このセクションでは、既存の BAHA アプリケーションを移行して接続文字列を使用する方法について説明します。
BAHA で既定の RE を使用した場合は、TI マネージャーを使用して構成をエクスポートし、 [接続文字列] ダイアログ ボックスを使用して構成をインポートします。
既定以外の RE が使用されている場合は、展開オブジェクトを TI マネージャーの新しい RE に関連付け、TI マネージャーで構成をエクスポートします。 [接続文字列] ダイアログ ボックスを使用して構成をインポートします。
[ホストの種類] ダイアログ ボックスが削除されているため、接続文字列を使用せずに BizTalk Server 管理で RE を切り替えることはできません。
BizTalk Server 管理での RE オーバーライドはサポートされていません。 メッセージ コンテキストを使用して RE オーバーライドを行うことはできますが、推奨されません。 代わりに、接続文字列を使用することをお勧めします。
既定以外の SSO アプリケーションが指定されている場合は、TI マネージャーを使用して、既定以外の SSO アプリケーションに RE を関連付け、静的 RE を引き続き使用することができます。 または、接続文字列で指定することもできます。
TI マネージャーによってエクスポートされた XML をインポートする
移行を実行する場合を除き、TI マネージャーは必要ありません。 RE と WIP のオブジェクトの定義を XML ファイルにエクスポートできます。これは、 [接続文字列] ダイアログ ボックスでインポートできます。
警告
マッピングで使用される TI .NET アセンブリには、コンテキスト パラメーターを含める プロパティが True に設定されている必要があります。設定されていないと、実行時に TI メソッドの呼び出しが失敗します。
ホスト アプリケーション用 BizTalk Adapter の構成では、Host Integration Server 2009 で導入された動的な RE 機能を使用します。 動的 RE では、ホスト接続情報がわかっている限り、TI ランタイムが必要とするホスト情報を、メソッド呼び出しの直前に指定できます。 メソッドを呼び出す前に、TI マネージャーで事前に定義された RE に .NET クライアント アセンブリを展開して関連付ける必要はありません。
BAHA の場合、接続情報は、解析される接続文字列に組み込まれ、実行時に作成される RE オブジェクトに設定することができます。 RE に関する情報は、ホスト アプリケーション アダプターをホストしているポートが構成されている場合に指定できます。 これは、BizTalk 管理機能によって管理されるポート構成情報の一部として保存されます。 この方法では、BAHA を使用して .NET アプリケーションをホスト アプリケーションに統合するので、TI デザイナーを使用して TI .NET クライアント アセンブリを作成するだけで済みます。 その他のすべてのタスクは、BizTalk Server で実現できます。
次の表では、ツール バーのメニューとアクションについて説明します。
| ツール バー/メニュー | アクション |
|---|---|
| アセンブリを追加して接続文字列を作成する | GAC から TI .NET アセンブリを追加するか、ローカル ファイル パスを使用して、マッピングにアセンブリを追加します。 すべての列には、アセンブリから反映された既定値が設定されます。 必要な値が入力されていない場合、既定の接続文字列は使用できません。 |
| 接続文字列を削除する | 選択したマッピングを削除します。 削除を確認するためのダイアログ ボックスが表示されます。 |
| 接続文字列を編集する | マッピングが選択されている場合は、マッピングの接続文字列部分を編集し、 [接続文字列] ダイアログ ボックスを開いて接続文字列を編集します。 |
| マッピングを XML にエクスポートする | エクスポートを使用すると、マッピングをバックアップできます。 マッピングは、マッピングのインポート機能を使用して後からインポートできます。 インポート/エクスポート機能を使用すると、エンドポイント間でマッピングを簡単に共有できます。 |
| マッピングまたは RE のインポート | [ホスト アプリケーション用 BizTalk Adapter の構成] ダイアログ ボックスでエクスポートされた XML をインポートするときに使用されます。 また、マッピングを選択したとき TI マネージャーによってエクスポートされた RE 定義をインポートする際にも使用されます。 |
| TI .NET アセンブリのプロパティを表示する | アセンブリの関連プロパティと、このアセンブリがサポートする入力/出力ドキュメントの XML タグ名が表示されます。 メソッド名はタグ名の一部ですが、マッピングの検索時には使用されません。 すべてのプロパティは読み取り専用です。 |