この章では、OracleAS Adapter for CICSの作成例について説明します。OracleAS Adapter for CICSを使用するためには、BPELプロセスまたはメディエータ・プロセスを構成することも必要です。BPELまたはメディエータの使用方法の詳細は、「JDeveloperでのプロジェクトの作成例」を参照してください。
OracleAS Adapter for CICSを使用してアウトバウンド相互作用を作成するには、CICSアダプタを作成し、メタデータをインポートして、データのアクセスに使用する相互作用を作成する必要があります。
必要なデータを入手するために使用する相互作用はCICSアダプタを使用して作成します。これらの相互作用は、JDeveloperでエンドポイントを設定するときにサービスとして使用します。JDeveloperを使用したエンドポイントの作成の詳細は、「JDeveloperでのプロジェクトの作成例」を参照してください。
相互作用を作成するには、次の作業をします。
メインフレーム・コンピュータのCICS配下でHospitalデータベースが使用できることを確認します。
まずメインフレーム・コンピュータへのアクセスを構成します。このアクセスは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」ダイアログ・ボックスを次の図に示します。
ここでは、探している情報を入手するための相互作用を作成できるようにするアダプタを作成します。アダプタを作成するには、次の作業をします。
追加したコンピュータを開いて、「NAV」バインディングを開きます。
「Adapters」フォルダを右クリックして、「New adapter」を選択します。
アダプタの次の情報を入力して「Finish」をクリックします。
Name: findDoctor
Type: CICS
「Finish」をクリックします。
CICSアダプタの設定方法の詳細は、「Oracle Connectアダプタの構成」を参照してください。
正しい情報が設定された「Add Adapter」ダイアログ・ボックスを次の図に示します。
ここでは、CICSデータからアダプタにメタデータをインポートします。データのインポート方法の詳細は、「アウトバウンド相互作用の生成」を参照してください。
この例では、HospitalデータベースのDoctor
列とPatient
列からメタデータをインポートします。このデータベースはOracle Connectの例として用意されていますので、Oracle Connectをメインフレーム・コンピュータにインストールするときにインストールしてください。
メタデータのインポートには、次の情報が必要です。
「Import name」にfindDoctorと入力します。
「Get Input Files」ステップで、hospital.cob
というファイルを追加します。
「Apply Filters」ステップで、単に「Next」をクリックします。
「Add interactions」ステップの「Name」列に「findDoctor」と入力し、「Input」列で「DOCTOR」を選択し、「Output」列で「DOCTOR」を選択します。
「Import Metadata」ステップで、「Yes」を選択して、「Finish」をクリックします。
JDeveloperで接続を設定するには、WSDLファイルとJCAファイルの両方を作成する必要があります。BPELプロセスまたはメディエータ接続を設定する前に、Oracle Studioを使用してファイルを作成します。
JCA構成ファイルの作成方法の詳細は、「JCA構成ファイルの作成」を参照してください。findDoctor
アダプタのファイルを作成するには、次の作業をします。
Oracle Studioの「Cofiguration」ペインから、「NAV」バインディングと「Adaper」フォルダを開きます。
findDoctorアダプタを右クリックして「Generate JCA Configuration Files」を選択します。
BPELプロセスまたはメディエータ接続を作成する場合は、ダイアログ・ボックスで見つかった位置へファイルを保存します。