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

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

次のトピックでは、UNIXベースのプラットフォームでSNAプロトコルを使用してゲートウェイ用にOracleデータベースを構成する方法について説明します。 コミット確認を実装する場合は、その構成方法も示します。

これらのトピックでは、ゲートウェイ・コンポーネントのインストールと構成を検証するために必要なステップ(オプションのCommit-Confirmを含む)が提供されています。

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

  • Oracleデータベース

  • UNIXシステム

  • ネットワーク

  • OLTP

始める前に

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

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

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

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

ゲートウェイとOracleデータベースの場所によっては、一部のゲートウェイ管理ファイルをOracleデータベースのインストール先に転送する必要があることがあります。

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

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

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

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

Oracleデータベースとゲートウェイが別のシステム上にインストールされている場合、次のタスクを実行する必要があります。

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

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

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

    注意:

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

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

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

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

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

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

    $ ORACLE_HOME=/oracle/pga/12.2; export ORACLE_HOME
  2. 次のコマンドを使用してディレクトリを作成します。
    $ cd $ORACLE_HOME
$ mkdir dg4appc
$ mkdir dg4appc/admin
  3. ご使用のシステムで使用可能なファイル転送メカニズムを使用して、.sql、.pkh、および.pkbファイルのすべてを、ゲートウェイのOracleホーム $ORACLE_HOME/dg4appc/adminディレクトリからOracleデータベースのOracleホームOracleホーム$ORACLE_HOME/dg4appc/adminディレクトリにコピーします。
  4. ゲートウェイ・ディレクトリからOracleデータベース・ディレクトリにdemoファイルを転送することもできます。 ファイルおよびディレクトリを、ゲートウェイのOracleホーム$ORACLE_HOME/dg4appc/demoディレクトリからOracleデータベースの$ORACLE_HOME/dg4appc/demoディレクトリに再帰的にコピーします。

    次に例を示します。

    $ cp -p -R /oracle/pga/12.2/dg4appc/demo $ORACLE_HOME/dg4appc

    注意:

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

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

これが初回インストールの場合は、「Oracle Database構成: 初めてのゲートウェイ・インストール」を実行してください。

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

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

Oracleデータベース構成: ゲートウェイの初回インストール

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スクリプトを実行します。 

      SQL> @$ORACLE_HOME/rdbms/admin/utlraw.sql
SQL> @$ORACLE_HOME/rdbms/admin/prvtrawb.plb

  2. DBMS_OUTPUT標準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スクリプトを実行します。 

      SQL> @$ORACLE_HOME/rdbms/admin/utlpg.sql
SQL> @$ORACLE_HOME/rdbms/admin/prvtpgb.plb

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

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

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

      SQL> DESCRIBE HS_FDS_CLASS

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

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

      SQL> $ORACLE_HOME/rdbms/admin/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言語リファレンス」を参照してください。 

      SQL> @$ORACLE_HOME/dg4appc/admin/pgacr8au.sql

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

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

      SQL> @$ORACLE_HOME/dg4appc/admin/pgddcr8.sql

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

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

      SQL> GRANT EXECUTE ON DBMS_PIPE TO PGAADMIN

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

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

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

      SQL> @$ORACLE_HOME/dg4appc/admin/pgatiptr.sql

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

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

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

      SQL> @$ORACLE_HOME/dg4appc/admin/gpglocal.pkh

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

      SQL> @$ORACLE_HOME/dg4appc/admin/gpglocal.pkb

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

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

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

  1. SQL*Plusを使用して、SYSユーザーとしてOracleデータベースに接続します。
  2. UTL_RAWパッケージ本体をインストールします。 SQL*Plusから、$ORACLE_HOME/rdbms/adminディレクトリでprvtrawb.plbスクリプトを実行します。 このスクリプトは、UTL_RAWパッケージ本体をアップグレードします。 
    SQL> @$ORACLE_HOME/rdbms/admin/prvtrawb.plb
  3. UTL_PGパッケージ本体をインストールします。 SQL*Plusから、$ORACLE_HOME/rdbms/adminディレクトリでprvtpgb.plbスクリプトを実行します。 このスクリプトはUTL_PGパッケージ本体をアップグレードします。 
    SQL> @$ORACLE_HOME/rdbms/admin/prvtpgb.plb

    prvtpgb.plbおよびprvtrawb.plbスクリプトが正常に完了するはずです。 仕様部がないか無効であることが原因で失敗した場合、次の項の説明に従って、パッケージの仕様部を再インストールすることを検討します。

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

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

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

注意:

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

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

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

SQL*Plusから、utlraw.sqlスクリプトを実行します。

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

  2. SQL*Plusから、Oracleデータベースの$ORACLE_HOME/rdbms/adminディレクトリで、次の順序でutlraw.sqlとutlpg.sqlスクリプトを実行して、それぞれのパッケージの仕様部をアップグレードします。 

    SQL> @$ORACLE_HOME/rdbms/admin/utlraw.sql
SQL> @$ORACLE_HOME/rdbms/admin/utlpg.sql
ステップ2 UTL_RAWとUTL_PGパッケージ本体のインストールを繰り返します。

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

注意:

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

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

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

  1. 必要に応じて、SQL*Plusを使用して、ユーザーPGAADMINとしてOracleデータベースに接続します。
  2. SQL*Plusから、$ORACLE_HOME/dg4appc/adminディレクトリでpgddupgr.sqlスクリプトを実行します。 このスクリプトは、PG DDをアップグレードします。

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

古いバージョンのゲートウェイがすでにインストールされていることがあります。 バージョン10のゲートウェイはバージョン9のデータ・ディクショナリ(PGDD)と通信できますが、バージョン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のパブリック・シノニムを作成します。 

      SQL> @$ORACLE_HOME/dg4appc/admin/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ロールは、他の人に対してSELECT、INSERT、UPDATE、および「PG DD」表の一部に対してDELETE権限、およびSELECT権限を提供し、PGAUのDEFINE、GENERATE、REDEFINE、REPORT、およびUNDEFINE文の実行を可能にします。 PGDDGENロールはPG DD表に対する一部の権限を提供し、PGAUのGENERATEおよびREPORT文の実行のみを許可します。 

      SQL> @$ORACLE_HOME/dg4appc/admin/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開発者には、これらのパッケージを実行する明示的な許可が必要です。

    次の例のように、この許可はプライベートでもかまいません。

    $ 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

    また、次の例のように、この許可はパブリックでもかまいません。

    $ 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スクリプトを実行する必要があります。

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

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

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

      SQL> @$ORACLE_HOME/dg4appc/admin/pgddapub.sql
SQL> @$ORACLE_HOME/dg4appc/admin/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を呼び出します。

      $ 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を呼び出します。

    $ 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パラメータをカスタマイズします。

    ゲートウェイに対するパラメータspecificは、ゲートウェイ・パラメータ・ファイルinit sidで提供されます。oraは、 $ORACLE_HOME/dg4appc/adminディレクトリにあります。 サンプルファイル、 initPGA.oraはこのsubdirectory.で提供されています

    注意:

    init sidにあります。oraファイルを、このファイル名の"sid"の代わりにdg4appc SID名に置き換えてください。

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

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

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

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

      注意:

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

    • PGAパラメータ

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

      注意:

      間違ったパラメータは無視されます。 ただし、$ORACLE_HOME/dg4appc/admin/init sid。oraファイルが見つからない場合、ゲートウェイへのすべての呼び出しが失敗し、PGA-20928エラーが返されます。

コミット確認の構成

注意:

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

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

コミット確認使用時の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のみ)の実装"を参照してください。 後で「"Commit-ConfirmのためのOLTP構成の確認"」でCommit-Confirmの構成を確認するステップを実行します。

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

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

注意:

データベース・リンク名がPGAでない場合は、.sqlファイルを変更して、「"Oracle Database構成: 初めてのゲートウェイ・インストール"」のステップ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を実行します。
    SQL> @$ORACLE_HOME/dg4appc/demo/pgavsn.sql

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

    Oracle Database Gateway for APPC.
Version 12.2.0.1.0 Wed Aug 24 14:39:15 
2016

Copyright (c) Oracle Corporation 1979,2016.  All rights reserved.

    PL/SQLプロシージャが正常に終了しました。

  3. $ORACLE_HOME/dg4appc/demo/pgaecho.sqlを実行します。
    SQL> @$ORACLE_HOME/dg4appc/demo/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にログオンし、次のトランザクションを入力します。FLIPを、ゲートウェイ用z/OS用にCICS Transaction Serverを構成するときにFLIP:
    FLIP THIS MESSAGE

    次のような出力結果が表示されます。

    EGASSEM SIHT PILF
  2. UNIXにログオンします。
  3. $ORACLE_HOME/dg4appc/demo/CICS/pgacics.sqlにあるpgacics.sqlファイルを変更します。 ファイル先頭のコメントに従って、ゲートウェイとCICS Transaction Server for z/OSへのアクセスに使用される次の3つの項目をカスタマイズします。

    • CICSトランザクションID

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

    • Logmodeエントリ名

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

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

  6. SQL*Plusを使用して、ユーザーPGAADMINとしてOracleデータベースに接続します。
  7. pgacics.sqlを実行します。
    SQL> @$ORACLE_HOME/dg4appc/demo/CICS/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システムにログオンし、次のトランザクションを入力します。ゲートウェイ用にIMS/TMシステムを構成したときにFLIPをFLIP:
    FLIP THIS MESSAGE

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

    EGASSEM SIHT PILF
  2. UNIXにログオンします。
  3. pgaims.sqlファイルを修正します。このファイルは、 $ORACLE_HOME/dg4appc/demo/IMS/pgaims.sqlにあります。 ファイル先頭のコメントに従って、ゲートウェイとIMS/TMシステムへのアクセスに使用される次の3つの項目をカスタマイズします。

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

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

    • Logmodeエントリ名

  4. システム上でSNA通信パッケージが起動したことを確認します。
  5. SQL*Plusを使用して、ユーザーPGAADMINとしてOracleデータベースに接続します。
  6. pgaims.sqlを実行します。
    SQL> @$ORACLE_HOME/dg4appc/demo/IMS/pgaims.sql

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

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

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

APPC/MVSの検証

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

  1. APPC/MVSサブシステムがアクティブであることを確認します。
  2. UNIXにログオン
  3. $ORACLE_HOME/dg4appc/demo/MVS/pgamvs.sqlにある pgamvs.sqlファイルを変更します。 ファイル先頭のコメントに従って、ゲートウェイとAPPC/MVSシステムへのアクセスに使用される次の3つの項目をカスタマイズします。

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

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

    • Logmodeエントリ名

  4. システム上でSNA通信パッケージが起動したことを確認します。
  5. SQL*Plusを使用して、ユーザーPGAADMINとしてOracleデータベースに接続します。
  6. pgamvs.sqlを実行します。
    SQL> @$ORACLE_HOME/dg4appc/demo/MVS/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にあります。 各ディレクトリの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トランザクション 
    
                              
    これらはpgareco.asmファイルで提供されます。 FORGETおよびRECOVERYトランザクションは、正常にコミットされたトランザクションをフォーゲットするためにゲートウェイが呼び出したり、リカバリ処理時にトランザクション状態を問い合せしたりできるように、OLTPにインストールされ、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データセット情報
    
                           
    • 
                        

                        
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)
    
                           
    • 
                        

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

                        
このリリースでのサンプル・アプリケーションのインストールと使用方法に関する完全版マニュアルは、次のディレクトリとファイルを参照してください。

                        
    
                           
  • 
                              
    $ORACLE_HOME/dg4appc/CICS/sample_CICS_applications.txt
    
                           
    • 
                           
  • 
                              
    $ORACLE_HOME/dg4appc/IMS/sample_IMS_applications.txt
    
                           
    • 
                           
  • 
                              
    $ORACLE_HOME/dg4appc/MVS/sample_MVS_applications.txt
    
                           
    •