IMS™ Java™ データ・バインディングを作成した後、J2EE Connector Architecture を介して IMS と通信する Java Bean を作成する必要があります。
このタスクについて
この Java Bean には、IMS トランザクションを実行するように IMS に要求を実行依頼するメソッドが含まれます。このメソッドは、Java データ・バインディングを使用して、トランザクション用の入出力メッセージを構築します。J2C Bean には、異なる入力メッセージおよび出力メッセージ用の複数データ・バインディングだけでなく、IMS トランザクションを実行する複数のメソッドが含まれる場合があります。J2C Bean のために生成されたコードは、IMS と通信するために、IMS TM リソース・アダプターが提供する CCI を使用します。
手順
- メニュー・バーから J2C 動的ウィザードを開始するには、
「ファイル」>「新規」>「その他」>「J2C」と選択します。
- J2C フォルダーを展開し、「J2C Bean」を選択して、「次へ」をクリックします。
- 「リソース・アダプターの選択」ページで、使用したい IMS TM リソース・アダプターのバージョンを選択します。 「IMS Connector for Java (IBM: 10.5.x)」「IMS Connector
for Java (IBM: 11.3.0)」のいずれかを選択して、「次へ」をクリックします。
- 「接続プロパティー」ページで、「管理」を選択します。
注: ご使用の Java Bean で使用されるような IMS TM リソース・アダプターと、IMS Connect の間の接続の作成方法には 2 つのオプションがあります。この例は二層アプリケーションではないので、
管理接続しか適用できません。
- 管理接続は、接続ファクトリーと呼ばれる J2EE コネクター・アーキテクチャーの構造によって作成され、
アプリケーション・サーバーによって管理されます。Java Bean は、JNDI (Java Naming and Directory Interface) を使用して接続ファクトリーにアクセスします。管理接続をお勧めします。IMS TM リソース・アダプターとアプリケーション・サーバーの接続マネージャーは協力して、接続のプール、再利用、パーシスタンスを提供することで、接続を効率的に管理します。
- 非管理接続は、アプリケーション・サーバーとは連動せず
、IMS リソース・アダプターを介して直接取得されます。非管理接続は、一般に二層アプリケーションによって使用され、プールや再利用はされません。
さらに、IMS TM リソース・アダプターと IMS Connect の間の非管理ソケット接続は永続的でなく、
アプリケーションによる使用ごとにソケットが開閉されるという追加のオー
バーヘッドが発生します。
- 「接続プロパティー」ページの「JNDI ルックアップ名」フィールドの横で、
「新規」をクリックします。 これで新規サーバー・インスタンスを定義します。新規サーバー・インスタンスを定義するために、
ステップ 3 で選択したリソース・アダプターが、サーバー・インスタンスにデプロイされます。ワークスペースにサーバー・インスタンスを作成するには、以下のステップを実行します。
- JNDI ルックアップ・ウィザードの「サーバー・インスタンスの選択」ページで、「新規」を選択します。
- 「新規サーバーの定義」ページで、作成するサーバーのタイプ、例えば 「WebSphere 7.0 Server」を選択します。それから、「次へ」をクリックします。
- 「WebSphere® サーバーの設定」ページで、デフォルト設定を受け入れます。
- 「終了」をクリックします。
ステップ 3 で選択したリソース・アダプターが、サーバー・インスタンスにデプロイされます。
- 「サーバー・インスタンスの選択」ページで、「次へ」をクリックします。
- 作成したサーバー・インスタンスについて、J2C 接続ファクトリーを作成および構成します。 J2C 接続ファクトリー・ウィザードを使用して、ステップ 3 で選択したリソース・アダプターについて定義された
J2C 接続ファクトリーのいずれかを選択できます。また、まだ存在していない、後で定義する接続ファクトリーの JNDI ルックアップ名も指定できます。
サーバー・インスタンスについて J2C 接続ファクトリーを作成および構成するには、
以下のステップを実行します。
- 「J2C 接続ファクトリー」ページで、新規接続ファクトリーの
JNDI 名を入力します。例えば imsCFac と入力します。
- 接続ファクトリーを構成します。IMS Connect に対する TCP/IP 接続について、少なくとも以下のフィールドに値を提供します。
- 「ホスト名:」フィールドには、アプリケーションが使用する IMS Connect の TCP/IP ホスト名を入力します。例えば MYHOST.MYCOMPANY.COM と入力します。
- 「ポート番号:」フィールドには、ポート番号を入力します。例えば 9999 と入力します。
- 「データ・ストア名:」フィールドには、ターゲットの IMS データ・ストアを入力します。
例えば IMSA と入力します。
- 「終了」をクリックします。 サーバー・インスタンスが始動して初期化されます。
- サーバー・インスタンスを構成してサーバーが始動した後で、接続ファクトリーの
JNDI 名が「JNDI ルックアップ名」フィールドに表示されます。
「次へ」をクリックします。
- 「J2C Bean 出力プロパティー」ページで、以下のステップを実行します。
- 「Java プロジェクト名」について、「新規」をクリックします。
- プロジェクト・タイプとして「Java プロジェクト」を選択して、
「次へ」をクリックします。
- 「Java プロジェクトの作成」ページで、新規 Java プロジェクト名について PhoneBookJ2CBean
と入力し、その他のデフォルト設定をすべて受け入れて、「終了」をクリックします。
- 「Java パッケージ名」の横で「新規」をクリックします。
- 「Java パッケージ」ページで、新規 Java パッケージ名について sample.ims
と入力し、「終了」をクリックします。
- 「インターフェース名」について、「PB」を指定します。
- 「バインディング名」について、デフォルトの「PBImpl」を受け入れます。
- 「次へ」をクリックします。
- トランザクションを実行するメソッドを作成するには、Java メソッド・ウィザードを使用して、以下のステップを実行します。
- 「追加」をクリックして、Java メソッドを J2C Bean に追加します。
- 「Java メソッドの追加」ページで、Java メソッド名について runPB
と入力し、「次へ」をクリックします。
- 「Java メソッド」ページで、「入力タイプ」フィールドの横の「参照」
をクリックします。
- 「データ・タイプの選択」ウィンドウで、入力フィールドにアスタリスク
(*) を使用して使用可能なデータ・タイプを表示します。
- 「一致する型」フィールドで、「INPUTMSG」を選択して
「OK」をクリックし、メソッド runPB について INPUTMSG データ・バインディングを使用します。
- 「出力タイプ」フィールドの横で「参照」をクリックします。
- 「データ・タイプの選択」ウィンドウで、入力フィールドにアスタリスク
(*) を使用して使用可能なデータ・タイプを表示します。
- 「一致する型」フィールドで、「OUTPUTMSG」を選択して
「OK」をクリックし、メソッド runPB について OUTPUTMSG データ・バインディングを使用します。
- 「終了」をクリックします。
- Java メソッド・ウィザードが、新規メソッド runPB (INPUTMSG
: OUTPUTMSG) を Java Bean に関するメソッドのリストに表示します。このメソッドが選択されるようにしてください。
- 「runPB」の InteractionSpec プロパティーで、IMSInteractionSpec
値を指定します。この例では、すべてのデフォルト設定を受け入れてから、「終了」をクリックします。
タスクの結果
これでプロジェクト PhoneBookJ2CBean に J2C Bean ができました。これは、異なる Java EE リソースを使用して 1 つ以上の Java EE アプリケーションにデプロイできます。