この章では、OracleAS Adapter for IMS/DBの作成例について説明します。 OracleAS adapter for IMS/DBを使用するには、BPELプロセスかメディエータ・プロセスのいずれかを構成する必要があります。 BPELやメディエータの使用の詳細は、「JDeveloperでのプロジェクト作成の例」を参照してください。
OracleAS Adapter for IMS/DBを使用してアウトバウンド相互作用を作成するには、IMS/DBデータソースを作成し、IMS/DBからメタデータをインポートし、データベース・アダプタを作成して、データのアクセスに使用する相互作用を作成する必要があります。
IMS/DBデータソースを作成するには、次の作業をする必要があります。
メインフレーム・コンピュータのIMS/DB配下でHospitalデータベースが使用できることを確認します。
まずIMS/DBのデータがあるメインフレーム・コンピュータへのアクセスを構成します。 このアクセスはOracle Connectで構成します。Oracle Connectを開いて、「Oracle StudioでのIBM z/OSプラットフォームの設定」の指示に従います。 「Add machine」ダイアログ・ボックスに、次の情報を入力します。
Host name/IP address: Hospitalデータベースがあるメインフレーム・コンピュータの名前かIPアドレスを入力します。 これはOracle Connectと同じディレクトリにインストールする必要があります。
Port: ドメインが実行されているポート番号を入力します。 デフォルトのポートは2551です。
Display name: このフィールドには何も入力する必要はありません(デフォルトでは、ホスト名とポート番号が表示名になります)。
User name: アクセスするコンピュータで管理者パスワードが必要な場合に使用します。 その場合は、コンピュータの管理者の名前を入力します。
Password: 必要であれば、コンピュータの管理者のパスワードを入力します。
Connect via NAT with fixed IP address: 指定されたポートにかかわりなく、各外部IPが1つの内部IPに固定構成でマッピングされるNAT(Network Address Translation)ファイアウォール・プロトコルがマシンで使用されている場合は、これを選択します。
正しい情報が設定された「Add Machine」ダイアログ・ボックスを次の図に示します。
コンピュータの構成をOracle Studioに追加した後、IMS/DBデータソースを「Configuration」ビューに追加できます。 IMS/DBデータソースを追加するには、次の作業をします。
追加したコンピュータを開いて、「NAV」バインディングを開きます。
「Data sources」フォルダを右クリックして、「New data source」を選択します。
「New data source」ダイアログ・ボックスの「Name」フィールドにHospitalと入力します。
「Type」フィールドで、「IMS-DLI」を選択してから、「Finish」をクリックします。 さらに接続情報を追加する必要はありません。
IMS/DBデータソースの追加に関する詳細は、「データソース・ドライバの構成」を参照してください。
正しい情報が設定された「Add data source」ダイアログ・ボックスを次の図に示します。
ここで、IMS/DBのデータからデータソースへメタデータをインポートします。データのインポート方法の詳細は、「IMS/DBデータソースのメタデータのインポート」を参照してください。
この例では、HospitalデータベースのDoctor列とPatient列からメタデータをインポートします。 このデータベースはOracle Connectの例として用意されていますので、Oracle Connectをメインフレーム・コンピュータにインストールするときにインストールしてください。
メタデータのインポートには、次の情報が必要です。
「Get Input Files」ステップで、hospital.dbd、hospital.cobおよびhospital.psbというファイルを追加します。
「Apply Filters」ステップで、単に「Next」をクリックします。
「Select Tables」ステップで、DOCTORとPATIENTを選択します。
「Match DBD to COBOL」画面で、「Next」をクリックします。
「Import Manipulation」ステップで、「Next」をクリックします。
「Metadata Model Selection」ステップで、「Default value for all tables」を選択して、「Next」をクリックします。
「Import Metadata」ステップで、「Yes」を選択して、「Finish」をクリックします。
必要なデータを入手するために使用する相互作用はデータベース・アダプタを使用して作成します。 これらの相互作用は、JDeveloperでエンドポイントを設定するときにサービスとして使用します。 JDeveloperを使用したエンドポイントの作成方法の詳細は、「JDeveloperでのプロジェクト作成の例」を参照してください。
相互作用を作成するには、次の作業をします。
ここで、探している情報を入手するための相互作用を作成できるようにするデータベース・アダプタを作成します。 データベース・アダプタを作成するには、次の作業をします。
追加したコンピュータを開いて、「NAV」バインディングを開きます。
「Adapters」フォルダを右クリックして、「New adapter」を選択します。
アダプタの次の情報を入力して「Finish」をクリックします。
Name: findDoctor
Type: Database
「Create event queue for the adapter」を選択します。
データベース・アダプタの設定方法の詳細は、「Oracle Connectアダプタの設定」を参照してください。
正しい情報が設定された「Add Adapter」ダイアログ・ボックスを次の図に示します。
Oracle Application Server配下のデータを使用する相互作用を作成します。 ここで作成する相互作用は、JDeveloperを使用してエンドポイントを作成する際に使用します。 この例では、findDoctorという相互作用を作成します。 相互作用を作成するには、次の作業をします。
追加したコンピュータを開いて、「NAV」バインディングを開きます。
使用するアダプタを右クリックして「Metadata」で「Show」を選択します。
相互作用を右クリックして、「New」を選択します。
次の情報をウィザードに入力して「Finish」をクリックします。
Name: findDoctor
Type: Database
「Create event queue for the adapter」を選択します。
「Creation Mode」で、「Manual」と「Database query」を選択します。
Interaction Name: findDoctor.
「Create New Query」を選択します。
データベースで医師を検索するためのSelect文を作成します。
相互作用の作成方法の詳細は、「アウトバウンド相互作用の生成」を参照してください。
すべての情報を保存して、Oracle Studioを終了します。
JDeveloperとの接続を設定するには、WSDLおよびJCAの両ファイルを作成する必要があります。 Oracle Studioを使用してファイルを作成してからBPELプロセスやメディエータ接続を設定します。
JCA構成ファイルの作成方法については、「JCA構成ファイルの作成」を参照してください。 findDoctorアダプタのファイルを作成するには、次の作業をします。
Oracle Studioの「Cofiguration」ペインで、「NAV」バインディングおよび「Adaper」フォルダを開きます。
「findDoctor」アダプタを右クリックして「Generate JCA Configuration Files」を選択します。
ダイアログ・ボックスで、BPELプロセスやメディエータ接続の作成時に見つけられる場所にファイルを保存します。