Oracle Database Gateway for APPCインストレーションおよび構成ガイド 11gリリース1(11.1) for Microsoft Windows E05712-01 |
|
![]() 戻る |
![]() 次へ |
この章では、Microsoft Windowsプラットフォーム上でSNAプロトコルを使用するゲートウェイ用にOracleデータベースを構成するために必要な手順の概要を説明します。コミット確認を実装する場合は、その構成方法も示します。
この章では、ゲートウェイ・コンポーネント(オプションのコミット確認を含む)のインストールと構成を検証するために必要な手順についても説明します。含まれる項は、次のとおりです。
SNAを使用するOracle Database Gateway for APPCの構成には、次のコンポーネントでの作業が含まれます。
Oracleデータベース
Microsoft Windowsシステム
ネットワーク
OLTP
この章では、正しくゲートウェイとSNA通信インタフェースを構成するために、システムに固有のパラメータを入力する必要があります。
構成プロセスを完了するために知っておく必要があるインストール・パラメータのワークシートによる一覧は、付録D「構成ワークシート」を参照してください。始める前に、それらの固有パラメータの名前をネットワーク管理者から入手してください。
ゲートウェイのインストール、アップグレードまたは移行の際に、ゲートウェイとOracleデータベースの関係を確立する方法は3つあります。
ゲートウェイとOracleデータベースの場所によっては、一部のゲートウェイ管理ファイルをOracleデータベースのインストール先に転送する必要があることがあります。
使用するゲートウェイの場所とOracleデータベースの場所の組合せに該当する説明に従ってください。
Oracleデータベースとゲートウェイを同一のマシンの同一のORACLE_HOMEにインストールする場合
ファイルを転送する必要はありません。「サーバー構成の統合: ゲートウェイの初回インストール」に進みます。
Oracleデータベースとゲートウェイを別のシステムにインストールする場合
ゲートウェイの%ORACLE_HOME%\dg4appc\admin
ディレクトリにあるゲートウェイ管理ファイルを見つけます。接尾辞が.sql
、.pkh
または.pkb
であるこのディレクトリのすべてのファイルを、OracleデータベースOracleホーム・ディレクトリの、類似した名前を持つディレクトリにコピーする必要があります。
次に、ゲートウェイの%ORACLE_HOME%\dg4appc\demo
ディレクトリにあるゲートウェイ・デモ・ファイルとサブディレクトリを見つけます。pgavsn.sql
とpgaecho.sql
ファイルを、Oracleデータベースの、類似した名前を持つディレクトリにコピーします。
インストールされたOLTPに関係がある他のサブディレクトリとファイルをリモート・ホストにコピーします。たとえば、CICSが唯一のOLTPである場合は、ゲートウェイの%ORACLE_HOME%\dg4appc\demo\CICS
ファイルを、Oracleデータベースの類似した名前を持つディレクトリにコピーします。
注意: %ORACLE_HOME%\dg4appc\demo ディレクトリからファイルを転送する前に、必要なTIPを生成したことを確認します。TIPも転送する必要があります。
PGAUを使用するTIP生成の詳細は、『Oracle Database Gateway for APPCユーザーズ・ガイド』を参照してください。 |
Oracleデータベースとゲートウェイが同一マシン上の異なるディレクトリにある場合
ゲートウェイのOracleホームを、OracleデータベースのOracleホーム・ディレクトリに変更する必要があります。
たとえば、ゲートウェイのOracleホームが次のように設定されていて、
C:\> echo %ORACLE_HOME% C:\oracle\pga\11.1
サーバーのOracleホームが\oracle\pga\11.1
ディレクトリにある場合、次のようにする必要があります。
C:\> SET ORACLE_HOME=C:\oracle\pga\11.1
次のコマンドを使用してディレクトリを作成します。
C:\> cd %ORACLE_HOME% C:\> mkdir dg4appc C:\> mkdir dg4appc\admin
システムで使用できる任意のファイル転送機構を使用して、ゲートウェイのOracleホーム%ORACLE_HOME%\dg4appc\admin
ディレクトリからOracleデータベースのOracleホーム%ORACLE_HOME%\dg4appc\admin
ディレクトリに、.sql
、.pkh
および.pkb
ファイルをすべてコピーします。
ゲートウェイ・ディレクトリからOracleデータベース・ディレクトリにdemoファイルを転送してもかまいません。ゲートウェイのOracleホーム%ORACLE_HOME%\dg4appc\demo
ディレクトリからOracleデータベースの%ORACLE_HOME%\dg4appc\demo
ディレクトリにファイルとディレクトリを再帰的にコピーします。
次に例を示します。
C:\> cd %ORACLE_HOME%\dg4appc C:\> mkdir\demo C:\> cd demo C:\> xcopy C:\oracle\pga\11.1\demo /E /I /Q
注意: %ORACLE_HOME%\dg4appc\demo ディレクトリからファイルを転送する前に、必要なTIPを生成したことを確認します。TIPも転送する必要があります。
PGAUを使用するTIP生成の詳細は、『Oracle Database Gateway for APPCユーザーズ・ガイド』を参照してください。 |
初回インストールの場合は、「サーバー構成の統合: ゲートウェイの初回インストール」に進みます。
アップグレードの場合は、「旧ゲートウェイからのOracleデータベースのアップグレードまたは移行」に進みます。
それらの手順の後で、必要に応じて「複数ユーザー許容時の構成手順(オプション)」を実行します。
Oracle Database Gateway for APPCを初めてインストールした場合は、次の手順に従ってOracleデータベースを構成します。
UTL_RAW
PL/SQLパッケージがOracleデータベースにインストールされたことを確認します。PGAUによって生成されたTIP仕様はすべて、RAWデータ操作ルーチンを提供するUTL_RAW
を使用します。
SQL*Plusから、次のコマンドを入力します。
SQL> DESCRIBE UTL_RAW
DESCRIBE
文により、画面に出力が表示されます。出力を最後までブラウズすると、比較ファンクションなどいくつかのファンクションがあります。この出力が表示されない場合、次の手順dを使用してUTL_RAW
のインストールを続行します。
DESCRIBE
文が成功した場合、OracleデータベースにUTL_RAW
がインストールされており、手順 2に進むことができます。
SQL*Plusから、Oracleデータベースの%ORACLE_HOME%\rdbms\admin
ディレクトリで、次の順序でutlraw.sqlとprvtrawb.plbスクリプトを実行します。
C:\> cd %ORACLE_HOME%\rdbms\admin SQL> @utlraw.sql SQL> @prvtrawb.plb
DBMS_OUTPUT
標準PL/SQLパッケージがOracleデータベースで有効化されていることを確認します。配布メディア上のサンプル・プログラムとインストール検証プログラムは、この標準パッケージを使用します。
必要に応じて、SQL*Plusを使用して、ユーザーSYS
としてOracleデータベースに接続します。
SQL*Plusから、次のコマンドを入力します。
SQL> DESCRIBE DBMS_OUTPUT
DESCRIBE
文により、画面に出力が表示されます。出力を最後までブラウズすると、put_lineファンクションなどいくつかのファンクションがあります。
この出力が表示されない場合、DBMS_OUTPUT
パッケージを作成する必要があります。DBMS_OUTPUT
パッケージの作成の詳細は、『Oracle Databaseアドバンスト・アプリケーション開発者ガイド』を参照してください。DBMS_OUTPUT
パッケージのインストールが正常に完了したら、DESCRIBE
文を発行します。
DESCRIBE
文が成功した場合、OracleデータベースにDBMS_OUTPUT
が作成されており、手順3に進むことができます。
UTL_PG
PL/SQLパッケージをインストールします。PGAUによって生成されたTIP仕様はすべて、RAWデータとの間の数値変換ルーチンを実行するためにUTL_PG
を使用します。
必要に応じて、SQL*Plusを使用して、ユーザーSYS
としてOracleデータベースに接続します。
次のコマンドを入力します。
SQL> DESCRIBE HS_FDS_CLASS
DESCRIBE
文により、画面に出力が表示されます。DESCRIBE
文が成功した場合、異機種間カタログがOracleデータベース上に作成されており、手順5に進むことができます。それ以外で、DESCRIBE
文が成功しなかった場合にかぎり、次の手順に従います。手順cで異機種間サービスを作成します。
次のようにして、Oracle Database Gateway for APPCにアクセスするパブリック・データベース・リンクを作成します。
SQL*Plusを使用して、ユーザーSYSTEM
としてOracleデータベースに接続します。Oracleデータベースとゲートウェイが同一システム上にあるか異なるシステム上にあるかに関係なく、次のSQL*Plusサンプルを使用できます。次のサンプルで、pgasrv
は、後述のようにtnsnames.oraファイルを変更するときにゲートウェイに割り当てられるtns_name_entry
です。
SQL> CREATE PUBLIC DATABASE LINK PGA USING 'PGASRV'
ゲートウェイ管理者ユーザーPGAADMIN
を作成し、PG DDをインストールします。
SQL*Plusを使用して、ユーザーSYSTEM
としてOracleデータベースに接続します。
SQL*Plusから、%ORACLE_HOME%\dg4appc\admin
ディレクトリでpgacr8au.sqlスクリプトを実行します。このスクリプトは、PGAADMIN
ユーザーIDを作成します。
PGAADMIN
に定義された初期パスワードはPGAADMIN
です。パスワードを変更するにはALTER USER
コマンドを使用します。パスワードに関する詳細は、『Oracle Database SQL言語リファレンス』を参照してください。
C:\> cd %ORACLE_HOME%\dg4appc\admin SQL> @pgacr8au.sql
SQL*Plusを使用して、ユーザーPGAADMIN
としてOracleデータベースに接続します。
SQL*Plusから、%ORACLE_HOME%\dg4appc\admin
ディレクトリでpgddcr8.sql
スクリプトを実行します。このスクリプトは、PG DDをインストールします。
C:\> cd %ORACLE_HOME%\dg4appc\admin SQL> @pgddcr8.sql
SQL*Plusから、ユーザーSYS
としてOracleデータベースに接続します。
PGAADMIN
にDBMS_PIPE
上での実行権限を付与します。
SQL> GRANT EXECUTE ON DBMS_PIPE TO PGAADMIN
TIPトレース・アクセスPL/SQLルーチンをインストールします。これらのルーチンは、DBMS_PIPES
スタンダードPL/SQLパッケージがインストールされており、PGAADMIN
がその上で実行権限を持っていることを必要とします。DBMS_PIPES
の詳細情報は、『Oracle Databaseアドバンスト・アプリケーション開発者ガイド』を参照してください。
GPGLOCAL
パッケージをインストールします。このパッケージは、PGAUにより生成されたすべてのTIP仕様のコンパイルと実行のために必要です。TIP開発者はGPGLOCAL
上での実行権限を付与されている必要があります(「複数ユーザー許容時の構成手順(オプション)」の手順3を参照してください)。
SQL*Plusから、%ORACLE_HOME%\dg4appc\admin
ディレクトリでgpglocal.pkh
スクリプトを実行します。このスクリプトは、GPGLOCAL
パッケージの仕様部をコンパイルします。
C:\> cd %ORACLE_HOME%\dg4appc\admin SQL> @gpglocal.pkh
SQL*Plusから、%ORACLE_HOME%\dg4appc\admin
ディレクトリでgpglocal.pkb
スクリプトを実行します。このスクリプトは、GPGLOCAL
パッケージの本体をコンパイルします。
C:\> cd %ORACLE_HOME%\dg4appc\admin SQL> @gpglocal.pkb
この項の手順は、旧バージョンのOracle Database Gateway for APPCがシステムにインストールされていて、ゲートウェイの11.1.0.6用に構成する必要がある場合のみ実行してください。
次のようにして、Oracle Database Gateway for APPCを最新のバージョン・レベルにアップグレードします。
SQL*Plusを使用して、ユーザーSYS
としてOracleデータベースに接続します。
UTL_RAW
パッケージ本体をインストールします。SQL*Plusから、%ORACLE_HOME%\rdbms\admin
ディレクトリでprvtrawb.plb
スクリプトを実行します。このスクリプトは、UTL_RAW
パッケージ本体をアップグレードします。
C:\> cd %ORACLE_HOME%\rdbms\admin SQL> @prvtrawb.plb
UTL_PG
パッケージ本体をインストールします。SQL*Plusから、%ORACLE_HOME%\rdbms\admin
ディレクトリでprvtpgb.plb
スクリプトを実行します。このスクリプトはUTL_PG
パッケージ本体をアップグレードします。
C:\> cd %ORACLE_HOME%\rdbms\admin SQL> @prvtpgb.plb
prvtpgb.plb
およびprvtrawb.plb
スクリプトが正常に完了するはずです。仕様部がないか無効であることが原因で失敗した場合、9.4.1項「パッケージの仕様部を再インストールする必要がある場合」の説明に従って、パッケージの仕様部を再インストールすることを検討します。
UTL_RAW
またはUTL_PG
パッケージが無効か削除されている場合、prvtrawb.plb
およびprvtpgb.plb
スクリプトが正常に完了せず、パッケージの仕様部を再インストールしなければならない場合があります。
パッケージの仕様部を再インストールする場合、従属オブジェクト(既存のユーザーTIPやクライアント・アプリケーションなど)はすべて無効にされるため、後から再コンパイルする必要があります。その影響は、TIPおよび従属クライアント・アプリケーションを再コンパイルする間、一度パフォーマンスが遅延することです。
重要: パッケージ・スクリプトの再インストールを行う前に、%ORACLE_HOME%\dg4appc\admin ディレクトリにいることを確認します。 |
TIPは、それ以降のリリースでのカスケード再コンパイルを避けるために、リリース3.3で仕様部ファイルと本体ファイルに分けられました。
手順1 PGAUアップグレードを行う前に、次のスクリプトを実行します。
SQL*Plusから、utlraw.sql
スクリプトを実行します。
必要に応じて、SQL*Plusを使用して、ユーザーSYS
としてOracleデータベースに接続します。
SQL*Plusから、Oracleデータベースの%ORACLE_HOME%\rdbms\admin
ディレクトリで、次の順序でutlraw.sql
とutlpg.sql
スクリプトを実行して、それぞれのパッケージの仕様部をアップグレードします。
C:\> cd %ORACLE_HOME%\rdbms\admin SQL> @utlraw.sql SQL> @utlpg.sql
手順2 UTL_RAWとUTL_PGパッケージ本体のインストールを繰り返します。
スクリプトを実行したら、9.4項「旧ゲートウェイからのOracleデータベースのアップグレードまたは移行」の手順1bとcを繰り返します。続いて「ゲートウェイの旧リリースからのPGAUのアップグレード」という項に進みます。
注意: TIPと従属クライアント・アプリケーションは、パッケージの仕様部を再インストールしてから再コンパイルされる必要があります。TIPのコンパイルの詳細は『Oracle Database Gateway for APPCユーザーズ・ガイド』の第3章にあるTIPのコンパイルに関する項を参照してください。 |
古いバージョンのゲートウェイがすでにインストールされていることがあります。バージョン10のゲートウェイはバージョン9のデータ・ディクショナリ(PG DD)と通信できますが、バージョン9のゲートウェイはバージョン10のデータ・ディクショナリと通信できないことに注意してください。このため、データ・ディクショナリをバージョン10にアップグレードすると、バージョン9のデータ・ディクショナリに対して構成されたゲートウェイから通信できなくなります。
次の構成手順はオプションです。次の手順は、PGAADMIN
以外のユーザーがPGAUを使用するPG DD処理を実行できるようにする場合に実行します。
PG DDへのアクセス、トランザクションの定義およびTIP仕様の生成のためにロールを作成します。PGAADMIN
ユーザーは、必要に応じて、他のユーザーにこれらのロールを付与することができます。
SQL*Plusを使用して、ユーザーPGAADMIN
としてOracleデータベースに接続します。
SQL*Plusから、%ORACLE_HOME%\dg4appc\admin
ディレクトリでpgddcr8r.sql
スクリプトを実行します。このスクリプトは、2つのロール、PGDDDEF
とPGDDGEN
を作成します。PGDDDEF
ロールは、一部のPG DD表に対してはSELECT
、INSERT
、UPDATE
およびDELETE
の各権限を、その他の表に対しては一部の権限を提供して、PGAU
のDEFINE
、GENERATE
、REDEFINE
、REPORT
およびUNDEFINE
の各文の実行を許可します。PGDDGEN
ロールはPG DD表に対する一部の権限を提供し、PGAU
のGENERATE
およびREPORT
文の実行のみを許可します。
C:\> cd %ORACLE_HOME%\dg4appc\admin SQL> @pgddcr8r.sql
TIP開発者には、Oracleデータベースに同梱の次のPL/SQLパッケージへのアクセス権が必要です。
TIP開発者には、これらのパッケージを実行する明示的な許可が必要です。
次の例のように、この許可はプライベートでもかまいません。
C:\> sqlplus SYS\pw@database_specification_string SQL> GRANT EXECUTE ON UTL_RAW TO tip_developer; SQL> GRANT EXECUTE ON UTL_PG TO tip_developer; SQL> GRANT EXECUTE ON DBMS_PIPE TO tip_developer; SQL> CONNECT PGAADMIN\pw@database_specification_string SQL> GRANT EXECUTE ON PGAADMIN.PURGE_TRACE TO tip_developer; SQL> GRANT EXECUTE ON PGAADMIN.READ_TRACE TO tip_developer; SQL> GRANT EXECUTE ON PGAADMIN.GPGLOCAL TO tip_developer; SQL> exit
また、次の例のように、この許可はパブリックでもかまいません。
C:\> sqlplus SYS\pw@database_specification_string SQL> GRANT EXECUTE ON UTL_RAW TO PUBLIC; SQL> GRANT EXECUTE ON UTL_PG TO PUBLIC; SQL> GRANT EXECUTE ON DBMS_PIPE to PUBLIC; SQL> CONNECT PGAADMIN\pw@database_specification_string SQL> GRANT EXECUTE ON PGAADMIN.PURGE_TRACE TO PUBLIC; SQL> GRANT EXECUTE ON PGAADMIN.READ_TRACE TO PUBLIC; SQL> GRANT EXECUTE ON PGAADMIN.GPGLOCAL TO PUBLIC; SQL> EXIT
プライベートの許可も、パブリックな許可も使用できます。どちらの権限でもPGAを使用できます。パブリックな許可の方が容易で、すぐに実行できます。プライベートの許可を使用する場合は、新しいTIP開発者ユーザーIDが作成されるたびに、毎回許可を発行する必要があります。
これらの許可を実行するSQLスクリプトは、%ORACLE_HOME%\dg4appc\admin
ディレクトリにあります。pgddapub.sql
スクリプトは、パッケージへのパブリックなアクセスのためにこれらの許可を実行します。pgddadev.sql
スクリプトは、単一のTIP開発者によるパッケージへの私的なアクセスのために許可を実行します。プライベートの許可を使用する場合、1つのTIP開発者ユーザーIDにつき1回ずつpgddadev.sql
スクリプトを実行する必要があります。
SQL*Plusを使用して、ユーザーPGAADMIN
としてOracleデータベースに接続します。
SQL*Plusから、%ORACLE_HOME%\dg4appc\admin
ディレクトリで該当するスクリプト(pgddapub.sql
またはpgddadev.sql
)を実行します。スクリプトは前述のとおり必要な許可を実行します。必要なユーザーID、パスワードおよびデータベース指定文字列の入力を求められます。
プライベートの許可を使用する場合、パッケージへのアクセスを必要としている開発者1人ごとにこの手順を繰り返します。
C:\> cd %ORACLE_HOME%\dg4appc\admin SQL> @pgddapub.sql
または
SQL> @pgddadev.sql
ゲートウェイの旧リリースからアップグレードする場合で、既存のTIPを新しいファンクションとメンテナンス対応にアップグレードする場合、PGAUのGENERATE
文を使用して既存のTIP仕様を再生成します。
PGAU制御ファイルが生成され、TIPが格納されているディレクトリ・パスでPGAUを呼び出します。
C:\> pgau PGAU> CONNECT PGAADMIN\pgaadmin@database_specification_string PGAU> GENERATE tranname PGAU> EXIT
GENERATE
コマンドの詳細は、『Oracle Database Gateway for APPCユーザーズ・ガイド』の第2章のPGAU GENERATE
コマンドの項を参照してください。
PG DDエントリを再定義する必要はないことに注意してください。
新たに生成されたTIP仕様が格納されている同一のディレクトリ・パスでSQL*Plusを呼び出します。
C:\> sqlplus tip_owner\pw@database_specification_string SQL> @tipname.pkh SQL> @tipname.pkb SQL> exit
PGAU
GENERATE
を実行すると、TIPが仕様部と本体の2つの出力ファイルとして生成されます。仕様部、本体の順で両方コンパイルする必要があります。
GENERATE
コマンドの詳細は、『Oracle Database Gateway for APPCユーザーズ・ガイド』の第2章のPGAU GENERATE
コマンドの項を参照してください。
ゲートウェイを構成するには、次の手順を実行します。
Oracle Database Gateway for APPCのパラメータを調整します。
ゲートウェイ固有のパラメータは、ゲートウェイ・パラメータ・ファイルinitsid.ora
にあります。このファイルは%ORACLE_HOME%\dg4appc\admin
ディレクトリにあります。サンプルのゲートウェイ・パラメータ・ファイルinitPGA.ora
は、このサブディレクトリにあります。
注意: initsid.ora ファイルで、ファイル名の「sid 」の箇所にはdg4appc SID名を入れます。
|
パラメータは2つのカテゴリに分類されます。
このパラメータは、Oracle環境でゲートウェイの一般的な操作を制御します。
重要: 次の手順を実行する前に、付録A「SNAプロトコル用のゲートウェイ初期化パラメータ」のゲートウェイ初期化パラメータとPGAパラメータに関する説明を参照してください。PGA_CAPABILITY パラメータの使用方法に関する説明に特に注意してください。 |
PGAパラメータはゲートウェイのAPPCインタフェース部を制御します。PGAパラメータを指定するには、SET
ゲートウェイ初期化パラメータを使用します。initsid.ora
ファイルの末尾に、PGAパラメータ用のSET
コマンドをすべてまとめておくことをお薦めします。
コミット確認を構成しない場合は、「インストールしたゲートウェイとOLTP構成の検証」に進みます。
注意: コミット確認の実装を計画している場合、先に進む前に、『Oracle Database Gateway for APPCユーザーズ・ガイド』の第5章「コミット確認の実装(SNAのみ)」にある、コミット確認の機能の詳細な説明をお読みください。 |
コミット確認コンポーネントを構成するには、次の手順に従います。
ゲートウェイ・サーバーがトランザクション・ログ情報を格納するOracleデータベースの構成
ゲートウェイ初期化パラメータの構成
OLTPの構成
コミット確認を使用するアプリケーションを使用する前に、次の手順をすべて実行する必要があります。
ゲートウェイ・サーバーがトランザクション・ログ情報を格納するOracleデータベースは、ゲートウェイが実行されるのと同一のシステム上にあるのが理想的です。サーバーの構成は、ゲートウェイDBAユーザーの作成、コミット確認ログ表の作成およびトランザクションのロギング用のゲートウェイ・サーバーが使用するPL/SQLストアド・プロシージャの作成から成っています。
%ORACLE_HOME%\dg4appc\admin
ディレクトリのpgaccau.sql
スクリプトは、ゲートウェイDBAユーザーIDを作成します。デフォルト・ユーザーIDは、PGADBA
に設定されている初期パスワードを持っているPGADBA
です。ユーザーIDまたは初期パスワードを変更する場合、スクリプトを変更する必要があります。
SQL*Plusから、%ORACLE_HOME%\dg4appc\admin
ディレクトリでpgaccau.sql
スクリプトを実行します。このスクリプトは、ゲートウェイDBAのユーザーIDを作成します。このスクリプトを実行後にパスワードを変更する場合、ALTER USER
コマンドを使用してパスワードを変更します。詳細は、『Oracle Database SQL言語リファレンス』を参照してください。
SQL*Plusを使用して、PGADBA
ユーザーとしてOracleデータベースに接続します。
SQL*Plusから、%ORACLE_HOME%\dg4appc\admin
ディレクトリでpgaccpnd.sql
スクリプトを実行します。このスクリプトは、ゲートウェイ・サーバーがコミット確認トランザクション・ログのために使用するPGA_CC_PENDING
表を作成します。
SQL*Plusから、%ORACLE_HOME%\dg4appc\admin
ディレクトリでpgacclog.sql
スクリプトを実行します。このスクリプトは、ゲートウェイ・サーバーがPGA_CC_PENDING
表を更新するために使用するPGA_CC_LOG
PL/SQLストアド・プロシージャを作成します。
Oracleデータベースから切断します。
ゲートウェイ初期化パラメータについては、付録A「SNAプロトコル用のゲートウェイ初期化パラメータ」で説明しています。ゲートウェイでコミット確認をサポートするために必要なパラメータは次のとおりです。
PGA_CAPABILITY
PGA_LOG_DB
PGA_LOG_USER
PGA_LOG_PASS
PGA_RECOVERY_USER
PGA_RECOVERY_PASS
PGA_RECOVERY_TPNAME
これらのパラメータをinitsid.ora
ファイルに追加する必要があります。ここでsid
はコミット確認ゲートウェイのゲートウェイSIDです。
Oracle Database Gateway for APPCでサポートされているゲートウェイ初期化パラメータの詳細情報は、付録A「SNAプロトコル用のゲートウェイ初期化パラメータ」を参照してください。
コミット確認トランザクション・ログ・データベースの定義とインストール
コミット確認のFORGET/RECOVERYトランザクションの定義とインストール
ゲートウェイ付属のサンプル・コミット確認アプリケーションの定義とインストール
注意: コミット確認サポートに必要な変更を実装するために、OLTPの再起動が必要になることがあります。OLTPシステム管理者と相談しておいてください。 |
Transaction Server for z/OSとIMS/TMの構成に関する詳細な説明は、それぞれ %ORACLE_HOME%\dg4appc\demo\CICS\README.doc
および%ORACLE_HOME%\dg4appc\demo\IMS\README.doc
の各ファイルにあります。
コミット確認の詳細情報は、『Oracle Database Gateway for APPCユーザーズ・ガイド』の第5章「コミット確認の実装(SNAのみ)」を参照してください。
コミット確認の構成検証手順については、この章の9.9.3項「コミット確認使用時のOLTP構成の検証」で説明します。
ただし、先に9.9項に進んでゲートウェイのインストールを確認してください。
ゲートウェイのインストールとOLTP構成を検証するには、Oracle Database Gateway for APPCをインストールした後で、次の手順を実行します。また、コミット確認を構成する場合は、コミット確認用にOLTP構成を検証する手順に従います。
注意: データベース・リンク名がPGAでない場合は、デモ用の.sqlファイルを変更して、「サーバー構成の統合: ゲートウェイの初回インストール」の手順5で作成した特定のデータベース・リンク名を付けます。次の.sqlファイルを変更する必要があります。 |
PGAが以前に作成したデータベース・リンクを使用してゲートウェイのソフトウェア・インストールを検証するには、次の手順を実行します。
%ORACLE_HOME%\dg4appc\demo\pgavsn.sql
を実行します。
C:\> cd %ORACLE_HOME%\dg4appc\demo SQL> @pgavsn.sql
端末にサーバーのバージョン番号バナーが表示されます。次のように出力されます。
Oracle Database Gateway for APPC. Version 11.1.0.6 Fri Jun 3 13:12:49 2007 Copyright (c) Oracle Corporation 1979, 2007. All rights reserved.
PL/SQLプロシージャが正常に終了しました。
%ORACLE_HOME%\dg4appc\demo\pgaecho.sql
を実行します。
C:\> cd %ORACLE_HOME%\dg4appc\demo SQL> @pgaecho.sql
次のように出力されます。
==> Congratulations, your installation was successful. <==
OLTP構成の検証手順は、使用するOLTPや、OLTPが動作しているプラットフォームによって異なります。現在サポートされているOLTPは、CICS Transaction Server for z/OS、IMS/TM、APPC/MVSおよびz/OSです。インストールを検証するには次の手順に従ってください。
OLTPがCICS Transaction Server for z/OSの場合、次の手順を実行して、CICSの構成を検証します。
FLIP
トランザクションが正しくインストールされていることを検証するには、CICS Transaction Server for z/OSにログオンして、次のトランザクションを入力します。ただし、FLIP
の箇所を、CICS Transaction Server for z/OSをゲートウェイ用に構成する際にFLIP
に選択したトランザクションIDに置き換えます。
FLIP THIS MESSAGE
次の出力が表示されます。
EGASSEM SIHT PILF
Windowsプラットフォームから、pgacics.sqlファイルを編集します。このファイルは%ORACLE_HOME%\dg4appc\demo\CICS\pgacics.sql
にあります。
ファイル先頭のコメントに従って、ゲートウェイとCICS Transaction Server for z/OSへのアクセスに使用される次の3つの項目をカスタマイズします。
CICS Transaction Server for z/OSにログオンし、このトランザクションを入力します。ここで、name
はCICS構成手順で実行されたDFHCSDUP
ジョブによってインストールされたCONNECTION
定義の名前です。
CEMT SET CONNECTION(name) ACQUIRED
このトランザクションは、WindowsへのCICS接続をアクティブ化します。
SQL*Plusを使用して、ユーザーPGAADMIN
としてOracleデータベースに接続します。
C:\> cd %ORACLE_HOME%\dg4appc\demo\CICS SQL> @pgacics.sql
次のメッセージが表示されます。
==> Congratulations, your gateway is communicating with CICS <==
CICS Transaction Server for z/OSのインストール検証はこれで完了です。
OLTPがIMS/TMの場合は、次の手順を実行してIMS/TM構成を検証します。
FLIP
トランザクションが正しくインストールされていることを検証するには、IMS/TMシステムにログオンして、次のトランザクションを入力します。ただし、FLIP
の箇所を、IMS/TMシステムをゲートウェイ用に構成する際にFLIP
に選択したトランザクションIDに置き換えます。
FLIP THIS MESSAGE
次の出力が表示されます。
EGASSEM SIHT PILF
Windowsプラットフォームから、次の場所にあるpgaims.sql
ファイルを編集します。
%ORACLE_HOME%\dg4appc\demo\IMS\pgaims.sql
.ファイル先頭のコメントに従って、ゲートウェイとIMS/TMシステムへのアクセスに使用される次の3つの項目をカスタマイズします。
IMS/TMトランザクションID
サイド・プロファイル名
Logmodeエントリ名
C:\> cd %ORACLE_HOME%\dg4appc\demo\IMS SQL> @pgaims.sql
次のメッセージが表示されます。
==> Congratulations, your gateway is communicating with IMS/TM <==
これでIMS/TMのインストール検証は完了です。
OLTPがAPPC/MVSの場合は、次の手順を実行してAPPC/MVS構成を検証します。
APPC/MVSサブシステムがアクティブであることを確認します。
Windowsプラットフォームから、pgamvs.sql
ファイルを編集します。このファイルは%ORACLE_HOME%\dg4appc\demo\MVS\pgamvs.sql
にあります。ファイル先頭のコメントに従って、ゲートウェイとAPPC/MVSシステムへのアクセスに使用される次の3つの項目をカスタマイズします。
APPC/MVSトランザクションID
サイド・プロファイル名
Logmodeエントリ名
pgamvs.sql
を実行します。
C:\> cd %ORACLE_HOME%\dg4appc\demo\MVS SQL> @pgamvs.sql
次のメッセージが表示されます。
=> Congratulations, your gateway is communicating with APPC/MVS <=
これでAPPC/MVSのインストール検証は完了です。
9.8項「コミット確認の構成」でコミット確認を構成した場合、次の項を参考にして構成を実証します。
注意: コミット確認のコンポーネントと機能に関する背景情報は、『Oracle Database Gateway for APPCユーザーズ・ガイド』の第5章「コミット確認の実装(SNAのみ)」を参照してください。 |
ゲートウェイには、Transaction Server for z/OSとIMS/TMでコミット確認サポートを実装するためのサンプルが用意されています。それぞれ%ORACLE_HOME%\dg4appc\demo\CICS
、および%ORACLE_HOME%\dg4appc\demo\IMS
ディレクトリにあります。各ディレクトリのREADME.doc
ファイルには、インストールとサンプルの使用方法の詳しい情報が記述されています。サンプル・プログラムをコンパイルおよびリンクするためのJCLファイルも提供されます。次の場合にゲートウェイに含まれているサンプルを参考にしてください。
コミット確認トランザクション・ログ・データベースの作成と初期化、およびOLTPに対するそれらのデータベースの定義。Transaction Server for z/OSでは、サンプルはVSAMファイルをログ・データベースに使用します。IMS/TMでは、SHISAM/VSAMデータベースが使用されます。
ゲートウェイからOracleグローバル・トランザクションIDを受け取り、それをコミット確認トランザクション・ログ・データベースに記録するためのサブルーチンの使用。これらのサブルーチンはpgacclg.asm
ファイルで提供されます。プログラムでそれらを使用すると、プログラムに対するコード変更の手間が軽減されます。
Transaction Server for z/OSでは、提供されているサブルーチンはEXEC CICS LINKインタフェースを使用して呼び出されます。IMS/TMでは、提供されているサブルーチンは、アプリケーション・プログラム言語で、標準のCALL
文または同等のものを使用して呼び出されます。これらのサブルーチンはどちらも370アセンブラで作成されており、言語間インタフェースの問題やコンパイラへの依存性がありません。
FORGET/RECOVERYトランザクションのOLTPへのインストール。これらはpgareco.asm
ファイルで提供されます。FORGET/RECOVERYトランザクションは、正常にコミットされたトランザクションをフォーゲットするためにゲートウェイが呼び出したり、リカバリ処理時にトランザクションの状態を問い合せたりできるように、APPCを介してアクセスできる必要があります。これらのトランザクションは、フォーゲット処理時には特定のOracleグローバル・トランザクションIDのエントリをOLTPコミット確認トランザクション・ログ・データベースから削除し、リカバリ処理時には特定のOracleグローバル・トランザクションIDをOLTPコミット確認トランザクション・ログ・データベースに問い合せます。Transaction Server for z/OSとIMS/TMのどちらでも、これらのトランザクションは370アセンブラで作成されています。
サンプル・コミット確認トランザクション・ログ・データベースとサブルーチンの使用。Transaction Server for z/OSでは、サンプルのDB2更新トランザクション、DB2C
がpgadb2c.cob
ファイルで提供されています。これはDB2のサンプルEMP
表を更新するCOBOLの例です。IMS/TMでは、サンプルのDLI更新トランザクション、PGAIMSU
がpgaimsu.cob
ファイルで提供されています。これはDLIのサンプルPARTS
データベースを更新するCOBOLの例です。
次に示すのは、必要に応じて実行できるオプションの手順です。ゲートウェイの動作と、OLTPとのインタフェースを理解するために、使用するOLTP用のサンプル・アプリケーションをインストールすることをお薦めします。
Oracle Database Gateway for APPCパッケージには、ゲートウェイの機能を例示するサンプルPL/SQLプロシージャとOLTPトランザクション・プログラムが含まれます。次の場合のサンプルが用意されています。
APPC/MVS
z/OSデータセット情報
CICS Transaction Server for z/OS
DB2照会
DB2複数行照会
DB2更新
VSAM照会
VSAM更新
DLI照会
FEPI DB2照会
FEPI VSAM照会
IMS/TM
製品の新しいリリースには、この他のサンプルが配布メディアに追加されています。可能なかぎり、サンプル・アプリケーションはデータベース製品に付属しているサンプル・データベースを使用します。
このリリースでのサンプル・アプリケーションのインストールと使用方法に関する完全版マニュアルは、次のディレクトリのREADME.doc
ファイルを参照してください。
%ORACLE_HOME%\dg4appc\CICS\sample_CICS_applications.txt
%ORACLE_HOME%\dg4appc\IMS\sample_IMS_applications.txt
%ORACLE_HOME%\dg4appc\MVS\sample_MVS_applications.txt