機械翻訳について

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

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

このトピックでは、オプションのコミット確認を含む、ゲートウェイ・コンポーネントのインストールと構成を確認するために必要なステップについて説明します。

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

  • Oracleデータベース

  • UNIXシステム

  • ネットワーク

  • OLTP

9.1 始める前に

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

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

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

ゲートウェイのインストール、アップグレードまたは移行の際に、ゲートウェイと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も転送する必要があります。

    プロシージャ・ゲートウェイ管理ユーティリティ(PGAU)を使用したヒントの生成の詳細は、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. システムで使用可能な任意のファイル転送メカニズムを使用して、ゲートウェイのOracleホームの $ORACLE_HOME/dg4appc/adminディレクトリからOracleデータベースのOracleホームの$ORACLE_HOME/dg4appc/adminディレクトリに、すべての.sql.pkhおよび.pkbファイルをコピーします。
  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も転送する必要があります。

    PGAUを使用したTIPの生成の詳細は、Oracle Database Gateway for APPCユーザー・ガイドを参照してください。

初回インストールの場合は、「Oracle Database構成: ゲートウェイの初回インストール」に進みます。

アップグレードの場合は、「以前のゲートウェイからのOracle Databaseのアップグレードまたは移行」に進みます。

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

9.3 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. DBMS_PIPEに対する実行権限をPGAADMINに付与します:

      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

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

以前のバージョンのOracle Database Gateway for APPCがシステムにインストールされており、ゲートウェイの12cリリース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
    

    prvtrawb.plbおよびprvtpgb.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スクリプトを実行します:

  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章 の「ヒントのコンパイル」の項を参照してください。

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

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

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

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

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

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

次の構成ステップはオプションです。 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スクリプトを実行します。 このスクリプトは、PGDDDEFおよびPGDDGENという2つのロールを作成します。 PGDDDEFロールは、一部の「PG DD」表に対するSELECT, INSERT, UPDATE権限と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開発者によるパッケージへのプライベート・アクセスの権限付与を実行します。 プライベート権限を使用する場合は、TIP開発者ユーザーIDごとにpgddadev.sqlスクリプトを1回実行する必要があります:

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

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

      SQL> @$ORACLE_HOME/dg4appc/admin/pgddapub.sql
      SQL> @$ORACLE_HOME/dg4appc/admin/pgddadev.sql
      
  4. 以前のリリースのゲートウェイからアップグレードする場合で、既存の ヒントを新しい関数およびメンテナンスでアップグレードする場合は、 PGAU GENERATE文を使用して既存のT IP仕様を再生成します。

    ノート:

    PGAUは、 PGAU GENERATEコマンドの実行時に、既存の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は、2つの出力ファイルにTIPを生成: 仕様と本文。 仕様部、本体の順で両方コンパイルする必要があります。

    GENERATEコマンドの詳細は、Oracle Database Gateway for APPCユーザー・ガイドの第2章 のPGAU GENERATEコマンドの項を参照してください。

9.7 ゲートウェイの構成

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

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

    ゲートウェイに固有のパラメータは、ゲートウェイ・パラメータ・ファイルinit sid.ora ( $ORACLE_HOME/dg4appc/adminディレクトリ内)で提供されます。 このサブディレクトリには、サンプル・ゲートウェイ・パラメータ ファイル initPGA.oraが用意されています。

    ノート:

    init sid.oraファイルで、このファイル名でdg4appc SID名を" sid "に置き換えます。

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

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

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

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

      ノート:

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

    • PGAパラメータ

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

      ノート:

      スペル・ミスのパラメータは、を無視します。 ただし、$ORACLE_HOME/dg4appc/admin/init sid.oraファイルがない場合、ゲートウェイへのすべてのコールが失敗し、PGA-20928エラーが返されます。

9.8 コミット確認の構成

ノート:

コミット確認の実装を計画している場合は、続行する前に、Oracle Database Gateway for APPCユーザー・ガイドの第5章、「コミット確認の実装(SNAのみ)」のcommit-confirmの機能の詳細な説明を参照してください。

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

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

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

  • OLTPの構成

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

9.8.1 コミット確認使用時の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データベースから切断します。

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

ゲートウェイ初期化パラメータについては、「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は、コミット確認ゲートウェイのゲートウェイSIDです。

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

OLTP構成には、次の定義およびインストールが含まれます。

  • コミット確認トランザクション・ログ・データベース

  • コミット確認のFORGETまたはRECOVERYトランザクション

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

    ノート:

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

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のみ)」の を参照してください。 コミット確認の構成を確認するステップは、後述のコミット確認用のOLTP構成の確認を参照してください。

9.9 インストールしたゲートウェイと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

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

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

9.9.2 OLTP構成の検証

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

ノート:

ゲートウェイのインストール/アップグレードを構成するための準備で詳細なファイル転送を完了していない場合は、次のステップに進む前に、ここでファイル転送を完了します。

9.9.2.1 CICSの検証

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

  1. FLIPトランザクションが正しくインストールされていることを確認するには、CICS Transaction Server for z/OSにログオンし、次のトランザクションを入力します。ゲートウェイ用にCICS Transaction Server for z/OSを構成するときに、FLIPFLIP用に選択したトランザクションIDに置き換えます:
    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. CICS Transaction Server for z/OSにログオンし、このトランザクションを実行します。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のインストール検証はこれで完了です。

9.9.2.2 IMS/TMの検証

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

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

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

    EGASSEM SIHT PILF
    
  2. UNIXにログオンします。
  3. $ORACLE_HOME/dg4appc/demo/IMS/pgaims.sqlにある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のインストール検証は完了です。

9.9.2.3 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のインストール検証は完了です。

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

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

ノート:

commit-confirmのコンポーネントおよび機能の詳細は、Oracle Database Gateway for APPCユーザー・ガイドの第5章、「コミット確認の実装」を参照してください。

ゲートウェイには、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アセンブラで作成されています。

  • サンプル・コミット確認トランザクション・ログ・データベースとサブルーチンの使用

    z/OSのトランザクション・サーバーでは、pgadb2c.cobファイルにサンプルのDB2更新トランザクションDB2Cが提供されています。 これは、DB2サンプルEMP表を更新するCOBOLの例です。 IMS/TMの場合、サンプルのDLI更新トランザクションPGAIMSUpgaimsu.cobファイルに用意されています。 これは、DLIサンプルPARTSデータベースを更新するCOBOLの例です。

9.10 インストール後手順の実行

次に示すのは、必要に応じて実行できるオプションのステップです。 ゲートウェイの動作と、OLTPとのインタフェースを理解するために、使用するOLTP用のサンプル・アプリケーションをインストールすることをお薦めします。

9.10.1 サンプル・アプリケーションのインストール

Oracle Database Gateway for APPCパッケージには、ゲートウェイの機能を例示する、次のサンプルPL/SQLプロシージャとOLTPトランザクション・プログラムが含まれます。

APPC/MVS

  • z/OSデータセット情報

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

  • 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