OracleAS Adapter for VSAMをデプロイし、Oracle Application Server Containers for J2EE(OC4J)と統合するには、J2CA 1.5 VSAMアダプタを構成する必要があります。
この項の構成は、次のとおりです。
Oracle Application Serverは、標準Java Development Kit(JDK)のJava仮想マシン(JVM)で動作する完全なJava 2 Enterprise Edition(J2EE)環境を提供します。OC4Jは、J2EEに認定されており、J2EE固有のコンテナ、APIおよびサービスをすべて提供します。OC4JはJ2CA 1.5標準をサポートしています。
J2CAは、EISとのアプリケーションの統合を単純化する標準Javaインタフェースを定義します。Oracleアダプタは、リソース・アダプタとしてOC4Jコンテナ内にデプロイされます。
OC4Jクライアント・アプリケーションとリソース・アダプタとの規約は、Common Client Interface(CCI)によって定義されます。OC4Jコンテナとリソース・アダプタとの規約は、サービス・プロバイダ・インタフェース(SPI)によって定義されます。SPI APIは、接続管理、トランザクション管理およびセキュリティ管理を取り扱います。
接続管理により、アプリケーション・コンポーネントは、EISに接続し、アプリケーション・サーバーが提供する接続プーリングを利用できるようになります。
トランザクション管理により、アプリケーション・サーバーは、トランザクション・マネージャを使用して複数のリソース・マネージャ全体のトランザクションを管理できるようになります。セキュリティ管理により、J2EEサーバーとEIS間には、認証、認可および保護された通信が提供されます。
ライフサイクル管理規約により、アプリケーション・サーバーは、アダプタのデプロイ中またはアプリケーション・サーバーの起動中にリソース・アダプタ・インスタンスを初期化できます。また、アプリケーション・サーバーは、サーバーの停止中またはアダプタのアンデプロイ中にリソース・アダプタ・インスタンスに通知できます。
ライフサイクル規約は、アプリケーション・サーバーがリソース・アダプタ・インスタンスのライフサイクルを管理するためのメカニズムを提供します。
操作管理規約により、リソース・アダプタはリソース・アダプタ上にスレッドを作成するかわりに、アプリケーション・サーバーがディスパッチしたスレッドを使用してロジックを実行できます。ハンドシェイクは、Work
インスタンス発行を介して実行されます。これにより、アプリケーション・サーバーのスレッド管理がさらに効果的になり、実行コンテキスト(セキュリティやトランザクションなど)の制御が向上します。
J2CA 1.5 VSAMアダプタに接続する手順は、次のとおりです。
oc4j-ra-xmlファイルを編集します。このファイルは次のパスにあります。
root¥j2ee¥home¥application-deployment¥default¥oracle¥oc4j-ra-xml
rootは、Oracle Application Serverのルート・ディレクトリを示します。
各接続に対して、次の設定を指定します。
<oc4j-connector-factories> <connector-factory location=" " connector-name="Oracle Legacy Adapter"> <config-property name="userName" value=" "/> <config-property name="password" value=" "/> <config-property name="eisName" value=" "/> <config-property name="serverName" value=" "/> <config-property name="workspace" value=" "/> <config-property name="portNumber" value=" "/> <config-property name="persistentConnection" value=" "/> <config-property name="keepAlive" value=" "/> <config-property name="firewallProtocol" value=""/> <config-property name="connectTimeout" value=""/> <config-property name="encryptionProtocol" value=""/> <config-property name="encryptionKeyName" value=""/> <config-property name="encryptionKeyValue" value=""/> <config-property name="fakeXa" value=" "/> </connector-factory> </oc4j-connector-factories>
次の表に、必須およびオプションのプロパティを示します。
表3-1 OC4J接続プロパティ
プロパティ | 説明 |
---|---|
|
Oracle Application Serverがアプリケーション・コンポーネントのコネクション・ファクトリ・インスタンスをバインドするJNDIロケーションを指定します。 |
|
使用するアダプタの名前を設定します。アダプタは、「Oracle Connectへのアクセスの保護」に説明されているように、Oracle Studioを使用してOracle Connectサーバーで定義されます。 |
|
Oracle Connectデーモンが動作しているTCP/IPアドレスまたはホスト名を設定します。 デーモンは、「Oracle StudioでのIBM z/OSプラットフォームの設定」の最初に指定したコンピュータ上で動作します。 関連項目: デーモンの詳細は、付録C「デーモンの高度なチューニング」を参照してください。 |
|
使用するOracle Connectサーバー・ワークスペースの名前を指定します。デフォルトのワークスペースはNavigatorです。 関連項目: ワークスペースの詳細は、「ワークスペース」を参照してください。 |
|
サーバー上でOracle Connectデーモンが動作しているTCP/IPポートを指定します。デフォルトのポートは2551です。 |
(オプション) |
Oracle Connectサーバーにアクセスできるユーザーを指定します。Oracle Connectデーモンの構成で定義されたユーザーです。 関連項目: Oracle Connectサーバーへのアクセスを許可するユーザーの詳細は、「セキュリティ」およびワークスペースの「セキュリティ」を参照してください。 |
(オプション) |
ユーザーの有効なパスワードを指定します。 |
(オプション) |
trueまたはfalseに設定します。trueに設定した場合、接続は、複数のリクエストまたは複数の接続コンテキストの変更全体にわたって存続できます。このプロパティは |
(オプション) |
trueまたはfalseに設定します。trueに設定すると、接続に使用するソケットが常にオープン状態となります。このプロパティは |
(オプション) |
使用するファイアウォール・プロトコルを指定します。指定しないか、またはfixedNat(デーモンの固定アドレスを使用するNatプロトコル)を指定します。デフォルトは |
(オプション) |
接続のタイムアウト(秒単位)を指定します。デフォルトは0(ゼロ)です。これは、接続がタイムアウトしないことを意味します。 |
(オプション) |
使用する暗号化プロトコルの名前を指定します。デフォルトは |
(オプション) |
使用する対称暗号鍵の名前を指定します。 |
(オプション) |
使用する対称暗号鍵の値を指定します。 |
(オプション) |
|
Common Client Interface(CCI)APIを使用して、アダプタ相互作用を実行するアプリケーションを開発できます。
J2CA 1.5 VSAMアダプタでCCI APIを使用する手順は、次のとおりです。
J2CA 1.5 VSAMアダプタのConnectionFactory
を参照します。
このConnectionFactory
を使用してConnection
オブジェクトを作成します。Connection
は、EISへの基礎となるネットワーク接続に対するハンドルです。serverName
プロパティを使用してoc4j-ra-xml
ファイルで識別されます。
このConnectionFactory
を使用してConnection
オブジェクトを作成します。AttuInteractionSpec
オブジェクトを使用して相互作用プロパティを指定します。AttuInteractionSpec
オブジェクトは、EISインスタンスとの相互作用を推進するプロパティを保持します。このオブジェクトは相互作用によって使用され、基礎となるEISに対して指定の機能を実行します。書式は次のとおりです。
AttuInteractionSpec(java.lang.String name, int verb, int timeOut)
次の表に、指定できるプロパティを示します。
表3-2 相互作用仕様プロパティ
プロパティ | 説明 |
---|---|
|
相互作用名を指定します。 |
|
相互作用のモード( |
|
指定された相互作用の実行に対して、EISが待機する時間(ミリ秒単位)を指定します。 |
次に、InteractionSpecのサンプルを示します。
AttuInteractionSpec iSpeq = new AttuInteractionSpec("query", javax.resource.cci.InteractionSpec.SYNC_RECEIVE, 60);javax.resource.cci.RecordFactory rf = new AttuRecordFactory(con, mcf.getLogger()); javax.resource.cci.MappedRecord queryRecord = rf.createMappedRecord("query"), queryRecord.put("##text", "select * from disam:nation"); javax.resource.cci.Record oRec = interaction.execute(iSpec, queryRecord);
interaction
でexecute()
メソッドを起動し、EISへのコールを開始します。相互作用に対するデータは、入出力レコードとして渡します。
相互作用による処理の終了後、Interaction
およびConnection
オブジェクトを閉じます。
各J2CA 1.5 VSAMアダプタには、「J2CA 1.5 VSAMアダプタの構成」に説明されているように、oc4j-ra.xml
ファイルにエントリが必要です。
リソース・アダプタの構成設定を変更するには、oc4j-ra.xml
ファイルで関連するconnector-factory
エントリを編集します。変更内容を有効にするには、Oracle Application Serverを停止して、再起動する必要があります。