1. インストレーションおよび構成ガイド
  2. SNA通信プロトコルを使用したゲートウェイの構成
機械翻訳について

8 SNA通信プロトコルを使用したゲートウェイの構成

次のトピックでは、Microsoft WindowsプラットフォームでSNAプロトコルを使用してゲートウェイ用にOracleデータベースを構成するために必要なステップの概要を説明します。 Commit-Confirmの構成方法を説明します。 これらのトピックでは、オプションのCommit-Confirmを含む、ゲートウェイ・コンポーネントのインストールと構成を確認するステップも示します。

SNAを使用するOracle Database Gateway for APPCの構成には、次のコンポーネントでの作業が含まれます。

  • Oracleデータベース

  • Microsoft Windowsシステム

  • ネットワーク

  • OLTP

始める前に

以下のトピックでは、ゲートウェイおよびSNA通信インタフェースを正しく構成するために、システム固有のパラメータを入力する必要があります。

構成プロセスを完了する前に知っておく必要があるインストール・パラメータをリストしたワークシートについては、「構成ワークシート」を参照してください。 始める前に、それらの固有パラメータの名前をネットワーク管理者から入手してください。

ゲートウェイのインストールまたはアップグレードを構成するための準備

ゲートウェイのインストール、アップグレードまたは移行の際に、ゲートウェイとOracleデータベースの関係を確立する方法は3つあります。

ゲートウェイとOracleデータベースのロケーションに応じて、一部のゲートウェイ管理ファイルをOracleデータベースがインストールされているロケーションに転送する必要があります。

使用するゲートウェイの場所とOracleデータベースの場所の組合せに該当する説明に従ってください。

Oracleデータベースとゲートウェイを同一のマシンの同一のORACLE_HOMEにインストールする場合

ファイルを転送する必要はありません。 「"サーバー構成の統合: 初めてのゲートウェイ・インストール"」に進みます。

Oracleデータベースとゲートウェイを別のシステムにインストールする場合

  1. ゲートウェイの%ORACLE_HOME%\dg4appc\adminディレクトリにあるゲートウェイ管理ファイルを見つけます。 サフィクスが.sql、.pkh、および.pkbのこのディレクトリ内のすべてのファイルは、OracleデータベースのOracleホーム・ディレクトリ内の同様の名前のディレクトリにコピーする必要があります。

  2. 次に、ゲートウェイの%ORACLE_HOME%\dg4appc\demoディレクトリにあるゲートウェイ・デモ・ファイルとサブディレクトリを見つけます。 pgavsn.sqlとpgaecho.sqlファイルを、Oracleデータベースの、類似した名前を持つディレクトリにコピーします。

  3. インストールされたOLTPに関係がある他のサブディレクトリとファイルをリモート・ホストにコピーします。 たとえば、唯一のOLTPとしてCICSを使用している場合は、ゲートウェイ%ORACLE_HOME%\dg4appc\demo\CICS ファイルをOracleデータベースの同様の名前のディレクトリにコピーします。

    注意:

    %ORACLE_HOME%\dg4appc\demoディレクトリからファイルを転送する前に、必要なTIPを生成したことを確認します。 TIPも転送する必要があります。

    PGAUを使用してTIPを生成する方法については、「Oracle Database Gateway for APPCユーザーズ・ガイド」を参照してください。

Oracleデータベースとゲートウェイが同一マシン上の異なるディレクトリにある場合

ゲートウェイのOracleホームを、OracleデータベースのOracleホーム・ディレクトリに変更する必要があります。

  1. たとえば、ゲートウェイのOracleホームが次のように設定されていて、
    C:\> echo %ORACLE_HOME%
C:\oracle\pga\12.2

    サーバーのOracleホームが\oracle\pga\12.2ディレクトリにある場合、次のようにする必要があります。 

    C:\> SET ORACLE_HOME=C:\oracle\pga\12.2
  2. 次のコマンドを使用してディレクトリを作成します。 
    C:\> cd %ORACLE_HOME%
C:\> mkdir dg4appc
C:\> mkdir dg4appc\admin
  3. ご使用のシステムで使用可能なファイル転送メカニズムを使用して、.sql、.pkh、および.pkbファイルをすべて、ゲートウェイOracleホーム%ORACLE_HOME%\dg4appc\adminディレクトリからOracleデータベースOracleホーム%ORACLE_HOME%\dg4appc\adminディレクトリにコピーします。
  4. ゲートウェイ・ディレクトリから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\12.2\demo /E /I /Q

    注意:

    %ORACLE_HOME%\dg4appc\demoディレクトリからファイルを転送する前に、必要なTIPを生成したことを確認します。 TIPも転送する必要があります。

    PGAUを使用してTIPを生成する方法については、「Oracle Database Gateway for APPCユーザーズ・ガイド」を参照してください。

これが初回インストールの場合は、「"サーバー構成の統合: 初めてのゲートウェイ・インストール"」を実行します。

これがアップグレードの場合は、「"以前のゲートウェイからのOracle Databaseのアップグレードまたは移行"」を実行します。

これらのステップに続いて、「複数のユーザーを許可するためのオプションの構成ステップ」、「複数のユーザーを許可するためのオプションの構成ステップ」を実行することができます。

サーバー構成の統合: ゲートウェイの初回インストール

Oracle Database Gateway for APPCを初めてインストールした場合は、次のステップに従ってOracleデータベースを構成します。

  1. UTL_RAW PL/SQLパッケージがOracleデータベースにインストールされたことを確認します。 PGAUによって生成されたTIP仕様はすべて、RAWデータ操作ルーチンを提供するUTL_RAWを使用します。

    1. SQL*Plusを使用して、ユーザーSYSとしてOracleデータベースに接続します。

    2. SQL*Plusから、次のコマンドを入力します。

      SQL> DESCRIBE UTL_RAW

      DESCRIBE文により、画面に出力が表示されます。 出力を最後までブラウズすると、比較ファンクションなどいくつかのファンクションがあります。 この出力が表示されない場合は、ステップ1.dを実行してUTL_RAWのインストールを続行します。以下。

      DESCRIBE文が成功した場合、OracleデータベースにUTL_RAWがインストールされており、ステップ 2に進むことができます。

    3. SQL*Plusを使用して、ユーザーSYSとしてOracleデータベースに接続します。

    4. SQL*Plusから、Oracleデータベースの%ORACLE_HOME%\rdbms\adminディレクトリで、次の順序でutlraw.sqlとprvtrawb.plbスクリプトを実行します。 

      C:\> cd %ORACLE_HOME%\rdbms\admin
SQL> @utlraw.sql
SQL> @prvtrawb.plb

  2. DBMS_OUTPUT standard PL/SQL パッケージがOracleデータベースで有効になっていることを確認してください。 配布メディア上のサンプル・プログラムとインストール検証プログラムは、この標準パッケージを使用します。

    1. 必要に応じて、SQL*Plusを使用して、ユーザーSYSとしてOracleデータベースに接続します。

    2. SQL*Plusから、次のコマンドを入力します。

      SQL> DESCRIBE DBMS_OUTPUT

    DESCRIBE文により、画面に出力が表示されます。 出力を最後までブラウズすると、put_lineファンクションなどいくつかのファンクションがあります。

    この出力が表示されない場合、DBMS_OUTPUTパッケージを作成する必要があります。 DBMS_OUTPUTパッケージの作成の詳細については、「Oracle Database PL/SQLパッケージと型のリファレンス」を参照してください。 DBMS_OUTPUTパッケージのインストールが正常に完了したら、DESCRIBE文を発行します。

    DESCRIBE文が成功した場合、OracleデータベースにDBMS_OUTPUTが作成されており、ステップ3に進むことができます。

  3. UTL_PG PL/SQLパッケージをインストールします。 PGAUによって生成されたTIP仕様はすべて、RAWデータとの間の数値変換ルーチンを実行するためにUTL_PGを使用します。

    1. 必要に応じて、SQL*Plusを使用して、ユーザーSYSとしてOracleデータベースに接続します。

    2. SQL*Plusから、Oracleデータベースの%ORACLE_HOME%\rdbms\adminディレクトリにあるutlpg.sql および prvtpgb.plbスクリプトを次の順序で実行します: 

      C:\> cd %ORACLE_HOME%\rdbms\admin
SQL> @utlpg.sql
SQL> @prvtpgb.plb

  4. 異機種間サービス(HS)カタログをインストールします。

    1. 必要に応じて、SQL*Plusを使用して、ユーザーSYSとしてOracleデータベースに接続します。

    2. 次のコマンドを入力します。

      SQL> DESCRIBE HS_FDS_CLASS

      DESCRIBE文により、画面に出力が表示されます。 DESCRIBE文が成功を示している場合は、異機種間サービス・カタログがOracleデータベースに作成されているため、ステップ5に進むことができます。 次のステップで異種サービス・カタログを作成します。

    3. 異機種間サービス・カタログを作成する必要がある場合、次のコマンドを入力します。

      C:\> cd %ORACLE_HOME%\rdbms\admin
SQL> @caths.sql

  5. 次のようにして、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'

  6. ゲートウェイ管理者ユーザーPGAADMINを作成し、PG DDをインストールします。

    1. SQL*Plusを使用して、ユーザーSYSTEMとしてOracleデータベースに接続します。

    2. 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

    3. SQL*Plusを使用して、ユーザーPGAADMINとしてOracleデータベースに接続します。

    4. SQL*Plusから、%ORACLE_HOME%\dg4appc\adminディレクトリにpgddcr8.sql スクリプトを実行します。 このスクリプトは、PG DDをインストールします。 

      C:\> cd %ORACLE_HOME%\dg4appc\admin
SQL> @pgddcr8.sql

    5. SQL*Plusから、ユーザーSYSとしてOracleデータベースに接続します。

    6. PGAADMINにDBMS_PIPE上での実行権限を付与します。

      SQL> GRANT EXECUTE ON DBMS_PIPE TO PGAADMIN

  7. TIPトレース・アクセスPL/SQLルーチンをインストールします。 これらのルーチンでは、 DBMS_PIPE標準のPL/SQLパッケージがインストールされていて、 PGAADMINに実行権限があることが必要です。 DBMS_PIPEの詳細については、「Oracle Database PL/SQLパッケージと型のリファレンス」を参照してください。

    1. 必要に応じて、SQL*Plusを使用して、ユーザーPGAADMINとしてOracleデータベースに接続します。

    2. SQL*Plusから、%ORACLE_HOME%\dg4appc\adminディレクトリにある pgatiptr.sqlスクリプトを実行します。 このスクリプトは、PGAUによって生成されたTIP仕様によって作成されたトレース情報の読取りとパージを行うために呼び出せるPL/SQLルーチンを作成します。 また、これらのルーチンのためのパブリック・シノニムも作成します。 スクリプトにより、必要なユーザーIDとパスワードの入力が要求されます。 

      C:\> cd %ORACLE_HOME%\dg4appc\admin
SQL> @pgatiptr.sql

  8. GPGLOCALパッケージをインストールします。 このパッケージは、PGAUにより生成されたすべてのTIP仕様のコンパイルと実行のために必要です。 TIP開発者には、 GPGLOCAL (「"複数のユーザーを許可するためのオプションの構成ステップ"」のステップ3を参照)に対する実行権限を与える必要があります。

    1. SQL*Plusを使用して、ユーザーPGAADMINとしてOracleデータベースに接続します。

    2. SQL*Plusから、%ORACLE_HOME%\dg4appc\adminディレクトリにある gpglocal.pkhスクリプトを実行します。 このスクリプトは、GPGLOCALパッケージの仕様部をコンパイルします。 

      C:\> cd %ORACLE_HOME%\dg4appc\admin
SQL> @gpglocal.pkh

    3. SQL*Plusから、%ORACLE_HOME%\dg4appc\adminディレクトリにある gpglocal.pkbスクリプトを実行します。 このスクリプトは、GPGLOCALパッケージの本体をコンパイルします。 

      C:\> cd %ORACLE_HOME%\dg4appc\admin
SQL> @gpglocal.pkb

旧ゲートウェイからのOracleデータベースのアップグレードまたは移行

ご使用のシステムに以前のバージョンのOracle Database Gateway for APPCがインストールされていて、ゲートウェイの12cリリース2 (12.2)用にそれを構成する必要がある場合は、次の手順onlyに従ってください。

  1. 次のようにして、Oracle Database Gateway for APPCを最新のバージョン・レベルにアップグレードします。

    1. SQL*Plusを使用して、ユーザーSYSとしてOracleデータベースに接続します。

    2. UTL_RAWパッケージ本体をインストールします。 SQL*Plusから、%ORACLE_HOME%\rdbms\adminディレクトリでprvtrawb.plbスクリプトを実行します。 このスクリプトは、UTL_RAWパッケージ本体をアップグレードします。 

      C:\> cd %ORACLE_HOME%\rdbms\admin
SQL> @prvtrawb.plb

    3. UTL_PGパッケージ本体をインストールします。 SQL*Plusから、%ORACLE_HOME%\rdbms\adminディレクトリからprvtpgb.plb スクリプトを実行します。 このスクリプトはUTL_PGパッケージ本体をアップグレードします。 

      C:\> cd %ORACLE_HOME%\rdbms\admin
SQL> @prvtpgb.plb

      prvtrawb.plbおよび prvtpgb.plbスクリプトは正常に完了するはずです。 仕様が存在しないか無効になったために失敗した場合は、「パッケージ仕様を再インストールする必要がある場合」の指示に従ってパッケージ仕様を再インストールすることを検討してください。

パッケージの仕様部を再インストールする必要がある場合

UTL_RAWまたはUTL_PGパッケージが無効か削除されている場合、prvtrawb.plbおよびprvtpgb.plbスクリプトが正常に完了せず、パッケージの仕様部を再インストールしなければならない場合があります。

パッケージ仕様を再インストールすると、依存するオブジェクト(既存のユーザーTIPやクライアント・アプリケーションなど)は無効になり、その後を再コンパイルする必要があります。 その影響は、TIPおよび従属クライアント・アプリケーションを再コンパイルする間、一度パフォーマンスが遅延することです。

注意:

パッケージ・スクリプトの再インストールを行う前に、%ORACLE_HOME%\dg4appc\adminディレクトリにいることを確認します。

TIPは、それ以降のリリースでのカスケード再コンパイルを避けるために、リリース3.3で仕様部ファイルと本体ファイルに分けられました。

ステップ1 PGAUアップグレードを行う前に、次のスクリプトを実行します。

  1. 必要に応じて、SQL*Plusを使用して、ユーザーSYSとしてOracleデータベースに接続します。

  2. 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パッケージ本体のインストールを繰り返します。

スクリプトの実行後、「以前のゲートウェイからのOracle Databaseのアップグレードまたは移行」 「以前のゲートウェイからのOracle Databaseのアップグレードまたは移行」でステップ1b.とc.を繰り返します。 次に、「"以前のゲートウェイ・リリースからのPGAUのアップグレード"」というセクションに進みます。

注意:

TIPと従属クライアント・アプリケーションは、パッケージの仕様部を再インストールしてから再コンパイルされる必要があります。 TIPのコンパイルについては、「Oracle Database Gateway for APPCユーザーズ・ガイド」の第3章 の"TIPのコンパイル"を参照してください。

ゲートウェイの旧リリースからのPGAUのアップグレード

  1. 新しいPGAUを実行する前に、次のようにしてPG DDをアップグレードします。

    1. 必要に応じて、SQL*Plusを使用して、ユーザーPGAADMINとしてOracleデータベースに接続します。

    2. SQL*Plusから、%ORACLE_HOME%\dg4appc\adminディレクトリにpgddupgr.sql スクリプトを実行します。 このスクリプトは、PG DDをアップグレードします。 

      C:\> cd %ORACLE_HOME%\dg4appc\admin
SQL> @pgddupgr.sql

ゲートウェイ複数使用時のOracleデータベース構成

古いバージョンのゲートウェイがすでにインストールされていることがあります。 バージョン10のゲートウェイはバージョン9のデータ・ディクショナリ(PG DD)と通信できますが、バージョン9のゲートウェイはバージョン10のデータ・ディクショナリと通信できないことに注意してください。 このため、データ・ディクショナリをバージョン10にアップグレードすると、バージョン9のデータ・ディクショナリに対して構成されたゲートウェイから通信できなくなります。

複数ユーザー許容時の構成ステップ(オプション)

次の構成ステップはオプションです。 次のステップは、PGAADMIN以外のユーザーがPGAUを使用するPG DD処理を実行できるようにする場合に実行します。

  1. 他のユーザーが表にアクセスできるようにするには、PG DDのパブリック・シノニムを作成します。

    1. SQL*Plusを使用して、ユーザーSYSTEMとしてOracleデータベースに接続します。

    2. SQL*Plusから、%ORACLE_HOME%\dg4appc\adminディレクトリにある pgddcr8s.sqlスクリプトを実行します。 このスクリプトは、PG DDのパブリック・シノニムを作成します。 

      C:\> cd %ORACLE_HOME%\dg4appc\admin
SQL> @pgddcr8s.sql

  2. PG DDへのアクセス、トランザクションの定義およびTIP仕様の生成のためにロールを作成します。 PGAADMINユーザーは、必要に応じて、他のユーザーにこれらのロールを付与することができます。

    1. SQL*Plusを使用して、ユーザーPGAADMINとしてOracleデータベースに接続します。

    2. 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

  3. PGA必須パッケージへのアクセス権付与

    TIP開発者には、Oracleデータベースに同梱の次のPL/SQLパッケージへのアクセス権が必要です。

    • %ORACLE_HOME%\rdbms\admin ディレクトリのDBMS_PIPE

    • %ORACLE_HOME%\rdbms\adminディレクトリのUTL_RAW

    • %ORACLE_HOME%\rdbms\adminディレクトリのUTL_PG

    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開発者によるパッケージへの私的なアクセスのために許可を実行します。 プライベート許可を使用する場合は、各TIP開発者のユーザーIDごとにpgddadev.sql スクリプトを1回実行する必要があります:

    1. SQL*Plusを使用して、ユーザーPGAADMINとしてOracleデータベースに接続します。

    2. SQL*Plusから、%ORACLE_HOME%\dg4appc\adminディレクトリで該当するスクリプト(pgddapub.sqlまたはpgddadev.sql)を実行します。 スクリプトは前述のとおり必要な許可を実行します。 必要なユーザーID、パスワードおよびデータベース指定文字列の入力を求められます。

      プライベートの許可を使用する場合、パッケージへのアクセスを必要としている開発者1人ごとにこのステップを繰り返します。

      C:\> cd %ORACLE_HOME%\dg4appc\admin
SQL> @pgddapub.sql

      または

      SQL> @pgddadev.sql

  4. ゲートウェイの旧リリースからアップグレードする場合で、既存のTIPを新しいファンクションとメンテナンス対応にアップグレードする場合、PGAUのGENERATE文を使用して既存のTIP仕様を再生成します。

    注意:

    PGAU GENERATEコマンドの実行時に、プロシージャ・ゲートウェイ管理ユーティリティ(PGAU)は自動的に拡張され、既存のPG DDエントリに新しい属性を追加します。 この拡張をサポートするには、PGDDGENロールに新しい権限を追加します。 そのために、PGAADMINユーザーとして、SQL*Plusを使用してPG DDが格納されているOracleデータベースに接続します。 次のSQLコマンドを発行します。 

    SQL> GRANT INSERT ON PGA_DATA_VALUES TO PGDDGEN

    1. 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エントリを再定義する必要はないことに注意してください。

  5. 新たに生成された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コマンドのセクションを参照してください。

ゲートウェイの構成

ゲートウェイを構成するには、次のステップを実行します。

  1. Oracle Database Gateway for APPCパラメータをカスタマイズします。

    gatewayに対するパラメータ固有のは、 %ORACLE_HOME%\dg4appc\admin ディレクトリにあるゲートウェイ・パラメータ・ファイル initsid.oraで提供されます。 サンプルファイル、 initPGA.oraは、このsubdirectory.で提供されています

    注意:

    initsid.oraファイルで、このファイル名の"sid"にdg4appc SID名を代入します。

    initsid.oraファイルには、APPCパラメータとTCP/IPパラメータの両方が含まれ、説明で区切られています。 TCP/IPパラメータを削除することによって、initsid.oraファイルを変更する必要があります。 有効なAPPCパラメータについては、「SNAプロトコルのゲートウェイ初期化パラメータ」を参照してください。

    パラメータは2つのカテゴリに分類されます。

    • ゲートウェイ初期化パラメータ

      このパラメータは、Oracle環境でゲートウェイの一般的な操作を制御します。

      注意:

      次のステップを実行する前に、ゲートウェイの初期化およびPGAパラメータの調整については、「SNAプロトコルのゲートウェイ初期化パラメータ」を参照してください。 PGA_CAPABILITYパラメータの使用方法に関する説明に特に注意してください。

    • PGAパラメータ

      PGAパラメータはゲートウェイのAPPCインタフェース部を制御します。 PGAパラメータを指定するには、SETゲートウェイ初期化パラメータを使用します。 initsid.oraファイルの末尾に、PGAパラメータ用のSETコマンドをすべてまとめておくことをお薦めします。

      注意:

      間違ったパラメータは無視されます。 ただし、%ORACLE_HOME%\dg4appc\admin\initsid.oraファイルがない場合、ゲートウェイの呼出しはすべて失敗し、PGA-20928エラーが戻されます。

      Commit-Confirmを構成しない場合は、「"ゲートウェイのインストールとOLTP構成の確認"」に進みます。

コミット確認の構成

注意:

Commit-Confirmを実装する予定の場合は、「Oracle Database Gateway for APPCユーザーズ・ガイド」の第5章、"Commit-Confirmの実装(SNAのみ)"のCommit-Confirm機能の詳細な説明を読んでから、進んでください。

コミット確認コンポーネントを構成するには、次のステップに従います。

コミット確認の構成ステップの内容は次のとおりです。

  • ゲートウェイ・サーバーがトランザクション・ログ情報を格納するOracleデータベースの構成

  • ゲートウェイ初期化パラメータの構成

  • OLTPの構成

コミット確認を使用するアプリケーションを使用する前に、次のステップをすべて実行する必要があります。

コミット確認使用時のOracleデータベース構成

ゲートウェイ・サーバーがトランザクション・ログ情報を格納するOracleデータベースは、ゲートウェイが実行されるのと同一のシステム上にあるのが理想的です。 サーバーの構成は、ゲートウェイDBAユーザーの作成、コミット確認ログ表の作成およびトランザクションのロギング用のゲートウェイ・サーバーが使用するPL/SQLストアド・プロシージャの作成から成っています。

%ORACLE_HOME%\dg4appc\adminディレクトリのpgaccau.sqlスクリプトは、ゲートウェイDBAユーザーIDを作成します。 デフォルトのユーザーIDはPGADBAで、初期パスワードはPGADBAに設定されています。 ユーザーIDまたは初期パスワードを変更する場合、スクリプトを変更する必要があります。

  1. SQL*Plusを使用して、ユーザーSYSTEMとしてOracleデータベースに接続します。
  2. SQL*Plusから、%ORACLE_HOME%\dg4appc\adminディレクトリでpgaccau.sqlスクリプトを実行します。 このスクリプトは、ゲートウェイDBAのユーザーIDを作成します。 このスクリプトを実行後にパスワードを変更する場合、ALTER USERコマンドを使用してパスワードを変更します。 詳細は、「Oracle Database SQL言語リファレンス」.を参照してください。
  3. SQL*Plusを使用して、PGADBAユーザーとしてOracleデータベースに接続します。
  4. SQL*Plusから、%ORACLE_HOME%\dg4appc\admin ディレクトリからpgaccpnd.sqlスクリプトを実行します。 このスクリプトは、ゲートウェイ・サーバーがコミット確認トランザクション・ログのために使用するPGA_CC_PENDING表を作成します。
  5. SQL*Plusから、%ORACLE_HOME%\dg4appc\adminディレクトリでpgacclog.sqlスクリプトを実行します。 このスクリプトは、ゲートウェイ・サーバーがPGA_CC_PENDING表を更新するために使用するPGA_CC_LOG PL/SQLストアド・プロシージャを作成します。
  6. Oracleデータベースから切断します。

コミット確認使用時のゲートウェイ初期化パラメータの構成

ゲートウェイ初期化パラメータは、「SNAプロトコルのゲートウェイ初期化パラメータ」で説明されています。 ゲートウェイでコミット確認をサポートするために必要なパラメータは次のとおりです。

  • PGA_CAPABILITY

  • PGA_LOG_DB

  • PGA_LOG_USER

  • PGA_LOG_PASS

  • PGA_RECOVERY_USER

  • PGA_RECOVERY_PASS

  • PGA_RECOVERY_TPNAME

これらのパラメータは、 initsid.oraファイルに追加する必要があります。sidは、Commit-ConfirmゲートウェイのゲートウェイSIDです。

Oracle Database Gateway for APPCでサポートされているゲートウェイ初期化パラメータの詳細については、「SNAプロトコルのゲートウェイ初期化パラメータ」を参照してください。

コミット確認使用時のOLTP構成

OLTPの構成作業の内容は次のとおりです。

  • コミット確認トランザクション・ログ・データベースの定義とインストール

  • コミット確認のFORGET/RECOVERYトランザクションの定義とインストール

  • ゲートウェイ付属のサンプル・コミット確認アプリケーションの定義とインストール

    注意:

    コミット確認サポートに必要な変更を実装するために、OLTPの再起動が必要になることがあります。 OLTPシステム管理者と相談しておいてください。

z/OSおよびIMS/TM用のトランザクション・サーバーを構成するための詳細な手順は、それぞれ%ORACLE_HOME%\dg4appc\demo\CICS\README.docおよび%ORACLE_HOME%\dg4appc\demo\IMS\README.docファイルに記載されています。

commit-confirmの詳細については、「Oracle Database Gateway for APPCユーザーズ・ガイド」の第5章、"Commit-Confirm(SNAのみ)の実装"を参照してください。

ただし、最初に「ゲートウェイのインストールとOLTP構成の確認」に進み、ゲートウェイのインストールを確認します。

インストールしたゲートウェイとOLTP構成の検証

ゲートウェイのインストールとOLTP構成を検証するには、Oracle Database Gateway for APPCをインストールした後で、次の手順を実行します。 また、コミット確認を構成する場合は、コミット確認用にOLTP構成を検証するステップに従います。

注意:

データベース・リンク名がPGAでない場合は、デモンストレーション.sqlファイルを変更して、「"サーバー構成の統合: 初めてのゲートウェイ・インストール"」のステップ5で作成した特定のデータベース・リンク名を指定します。 次の.sqlファイルを変更する必要があります。

  • pgavsn.sql

  • pgaecho.sql

  • pgacics.sql

  • pgaidms.sql

  • pgaims.sql

  • pgamvs.sql

ゲートウェイのインストール検証

PGAが以前に作成したデータベース・リンクを使用してゲートウェイのソフトウェア・インストールを検証するには、次のステップを実行します。

  1. SQL*Plusを使用して、PGAADMINからOracleデータベースに接続します。
  2. %ORACLE_HOME%\dg4appc\demo\pgavsn.sqlを実行します。
    C:\> cd %ORACLE_HOME%\dg4appc\demo
SQL> @pgavsn.sql

    端末にサーバーのバージョン番号バナーが表示されます。 次のように出力されます。 

    Oracle Database Gateway for APPC.
Version 11.2.0.0.2 Thu Jun 11 14:39:15
2009
 
Copyright (c) Oracle Corporation 1979, 2009.  All rights reserved.
 
 
PL/SQL procedure successfully completed.
  3. %ORACLE_HOME%\dg4appc\demo\pgaecho.sqlを実行します。
    C:\> cd %ORACLE_HOME%\dg4appc\demo
SQL> @pgaecho.sql

    次のように出力されます。

    ==> Congratulations, your installation was successful. <==

OLTP構成の検証

OLTP構成の検証手順は、使用するOLTPや、OLTPが動作しているプラットフォームによって異なります。 現在サポートされているOLTPは、CICS Transaction Server for z/OS、IMS/TM、APPC/MVSおよびz/OSです。 インストールを検証するには次の手順に従ってください。

注意:

「"ゲートウェイのインストール/アップグレードの構成の準備"」で詳述されているファイル転送を完了していない場合は、今すぐ完了してから次のステップに進みます。

CICSの検証

OLTPがCICS Transaction Server for z/OSの場合、次のステップを実行して、CICSの構成を検証します。

  1. FLIPトランザクションが正しくインストールされていることを確認するには、CICS Transaction Server for z/OSにログオンし、次のトランザクションを入力して、ゲートウェイ用z/OS用にCICS Transaction Serverを構成したときにFLIPをFLIP:
    FLIP THIS MESSAGE

    次の出力が表示されます。

    EGASSEM SIHT PILF
  2. Windowsプラットフォームから、pgacics.sqlファイルを編集します。このファイルは%ORACLE_HOME%\dg4appc\demo\CICS\pgacics.sqlにあります。

    ファイル先頭のコメントに従って、ゲートウェイとCICS Transaction Server for z/OSへのアクセスに使用される次の3つの項目をカスタマイズします。

    • CICSトランザクションID

    • サイド・プロファイル名

    • Logmodeエントリ名

  3. システム上でSNAサーバーが起動したことを確認します。
  4. z/OSのCICS Transaction Serverにログオンし、このトランザクションを入力します。ここで、nameは、CICS構成ステップで実行したDFHCSDUPジョブによってインストールされたCONNECTION定義の名前です:
    CEMT SET CONNECTION(name) ACQUIRED

    このトランザクションは、WindowsへのCICS接続をアクティブ化します。

  5. SQL*Plusを使用して、ユーザーPGAADMINとしてOracleデータベースに接続します。
  6. pgacics.sqlを実行します。
    C:\> cd %ORACLE_HOME%\dg4appc\demo\CICS
SQL> @pgacics.sql

    次のメッセージが表示されます。

    ==> Congratulations, your gateway is communicating with CICS <==

CICS Transaction Server for z/OSのインストール検証はこれで完了です。

IMS/TMの検証

OLTPがIMS/TMの場合は、次のステップを実行してIMS/TM構成を検証します。

  1. FLIPトランザクションが正しくインストールされていることを確認するには、IMS/TMシステムにログオンし、FLIPを、ゲートウェイ用にIMS/TMシステムを構成したときにFLIPに対して選択したトランザクションIDで置き換えて:
    FLIP THIS MESSAGE

    次の出力が表示されます。

    EGASSEM SIHT PILF
  2. Windowsプラットフォームから、次の場所にあるpgaims.sqlファイルを編集します。

    %ORACLE_HOME%\dg4appc\demo\IMS\pgaims.sql. ファイル先頭のコメントに従って、ゲートウェイとIMS/TMシステムへのアクセスに使用される次の3つの項目をカスタマイズします。

    • IMS/TMトランザクションID

    • サイド・プロファイル名

    • Logmodeエントリ名

  3. システム上でSNAサーバーが起動したことを確認します。
  4. SQL*Plusを使用して、ユーザーPGAADMINとしてOracleデータベースに接続します。
  5. pgaims.sqlを実行します。
    C:\> cd %ORACLE_HOME%\dg4appc\demo\IMS
SQL> @pgaims.sql

次のメッセージが表示されます。

==> Congratulations, your gateway is communicating with IMS/TM <==

これでIMS/TMのインストール検証は完了です。

APPC/MVSの検証

OLTPがAPPC/MVSの場合は、次のステップを実行してAPPC/MVS構成を検証します。

  1. APPC/MVSサブシステムがアクティブであることを確認します。
  2. Windowsプラットフォームから、pgamvs.sqlファイルを変更します。このファイルは %ORACLE_HOME%\dg4appc\demo\MVS\pgamvs.sqlにあります。 ファイルの先頭にあるコメントに記載されているように、ゲートウェイとAPPC/MVSシステムにアクセスするために使用される次の3つのアイテムをカスタマイズします。

    • APPC/MVSトランザクションID

    • サイド・プロファイル名

    • Logmodeエントリ名

  3. システム上でSNAサーバーが起動したことを確認します。
  4. SQL*Plusを使用して、ユーザーPGAADMINとしてOracleデータベースに接続します。
  5. pgamvs.sqlを実行します。
    C:\> cd %ORACLE_HOME%\dg4appc\demo\MVS
SQL> @pgamvs.sql

    次のメッセージが表示されます。

    => Congratulations, your gateway is communicating with APPC/MVS <=
これでAPPC/MVSのインストール検証は完了です。

                        

                        
                     

                  

               
 コミット確認使用時のOLTP構成の検証

                  

                     

                        
「Commit-Confirmの構成」でcommit-confirmを構成することを選択した場合は、次のセクションで構成の確認に役立ちます。
                        

                        

                           
注意:

                           
commit-confirmのコンポーネントと機能のバックグラウンド情報については、「Oracle Database Gateway for APPCユーザーズ・ガイド」の第5章、"Commit-Confirmの実装"を参照してください。
                           

                        

                        
ゲートウェイには、Transaction Server for z/OSとIMS/TMでコミット確認サポートを実装するためのサンプルが用意されています。 それらはそれぞれ次のディレクトリにあります: 各ディレクトリの%ORACLE_HOME%\dg4appc\demo\CICSおよび%ORACLE_HOME%\dg4appc\demo\IMS. A 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アセンブラで作成されています。 
                              
    
                           
    • 
                           
  • 
                              
    サンプル・コミット確認トランザクション・ログ・データベースとサブルーチンの使用。 z/OS用Transaction Serverの場合、 pgadb2c.cob fileにサンプルDB2更新トランザクションDB2Cが提供されています。 これは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データセット情報
    
                           
    • 
                        

                        
z/OS用CICSトランザクション・サーバー

                        
    
                           
  • 
                              
    DB2照会
    
                           
    • 
                           
  • 
                              
    DB2複数行照会
    
                           
    • 
                           
  • 
                              
    DB2更新
    
                           
    • 
                           
  • 
                              
    VSAM照会
    
                           
    • 
                           
  • 
                              
    VSAM更新
    
                           
    • 
                           
  • 
                              
    DLI照会
    
                           
    • 
                           
  • 
                              
    FEPI DB2照会
    
                           
    • 
                           
  • 
                              
    FEPI VSAM照会
    
                           
    • 
                        

                        
IMS/TM

                        
    
                           
  • 
                              
    IVTNOおよびIVTNVサンプル・トランザクションを使用するIMS照会
    
                           
    • 
                           
  • 
                              
    IMS PARTS照会(CPI-C)
                              
    
                           
    • 
                           
  • 
                              
    IMS PARTS更新(CPI-C)
    
                           
    • 
                        

                        
製品の新しいリリースには、この他のサンプルが配布メディアに追加されています。 可能なかぎり、サンプル・アプリケーションはデータベース製品に付属しているサンプル・データベースを使用します。 

                        
このリリースでのサンプル・アプリケーションのインストールと使用方法に関する完全版マニュアルは、次のディレクトリの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
    
                           
    •