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

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

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

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

  • Oracleデータベース

  • Microsoft Windowsシステム

  • ネットワーク

  • OLTP

8.1 始める前に

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

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

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

ゲートウェイのインストール、アップグレードまたは移行の際に、ゲートウェイと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に関係がある他のサブディレクトリとファイルをリモート・ホストにコピーします。 たとえば、CICSが唯一のOLTPである場合は、ゲートウェイの%ORACLE_HOME%\dg4appc\demo\CICS ファイルをOracleデータベース内の同じ名前のディレクトリにコピーします。

    ノート:

    %ORACLE_HOME%\dg4appc\demoディレクトリからファイルを転送する前に、必要なヒントが生成されたことを確認してください。 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. システムで使用可能な任意のファイル転送メカニズムを使用して、ゲートウェイの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ディレクトリに再帰的にコピーします。

    たとえば:

    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も転送する必要があります。

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

初めてインストールする場合は、「サーバー構成の統合: ゲートウェイの初回インストール」に進みます。

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

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

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

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標準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仕様では、UTL_PGが使用され、RAWデータとの間の数値変換を実行するためのルーチンが提供されます。

    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. Heterogeneous Services (HS)カタログをインストールします。

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

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

      SQL> DESCRIBE HS_FDS_CLASS

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

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

      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

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

以前のバージョンのOracle Database Gateway for APPCがシステムにインストールされており、ゲートウェイの12cリリース2 (12.2)用に構成する必要がある場合は、次の手順「のみ」に従います。

  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スクリプトが正常に完了します。 仕様が存在しないか無効になっていたために失敗した場合は、「パッケージ仕様部を再インストールする必要がある場合」の指示に従ってパッケージ仕様部を再インストールすることを検討してください。

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

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のアップグレードまたは移行」でステップ1 b.およびc.を繰り返します。 次に、「以前のゲートウェイ・リリースからのPGAUのアップグレード」というセクションに進みます。

ノート:

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

8.4.2 ゲートウェイの旧リリースからの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

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

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

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

次の構成ステップはオプションです。 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スクリプトを実行します。 このスクリプトは、PGDDDEFおよびPGDDGENという2つのロールを作成します。 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)は、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を起動します。

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

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

8.7 ゲートウェイの構成

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

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

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

    ノート:

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

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

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

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

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

      ノート:

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

    • PGAパラメータ

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

      ノート:

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

      commit-confirmの構成を計画していない場合は、「ゲートウェイのインストールおよびOLTP構成の確認」に進みます。

8.8 コミット確認の構成

ノート:

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

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

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

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

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

  • OLTPの構成

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

8.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データベースから切断します。

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

ゲートウェイ初期化パラメータについては、「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でサポートされているゲートウェイ初期化パラメータの詳細は、「SNAプロトコルのゲートウェイ初期化パラメータ」を参照してください。

8.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構成の確認」に進み、ゲートウェイのインストールを確認します。

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

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

ノート:

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

  • pgavsn.sql

  • pgaecho.sql

  • pgacics.sql

  • pgaidms.sql

  • pgaims.sql

  • pgamvs.sql

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

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

8.9.2 OLTP構成の検証

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

ノート:

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

8.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を構成したときに、FLIPをFLIPに選択したトランザクションIDに置き換えます:
    FLIP THIS MESSAGE

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

    EGASSEM SIHT PILF
  2. Windowsプラットフォームから、%ORACLE_HOME%\dg4appc\demo\CICS\pgacics.sqlにあるpgacics.sqlファイルを変更します。

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

    • CICSトランザクションID

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

    • Logmodeエントリ名

  3. システム上でSNAサーバーが起動したことを確認します。
  4. CICS Transaction Server for z/OSにログオンし、このトランザクションを入力します。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のインストール検証はこれで完了です。

8.9.2.2 IMS/TMの検証

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

  1. FLIPトランザクションが正しくインストールされていることを確認するには、IMS/TMシステムにログオンして次のトランザクションを入力します。ゲートウェイ用にIMS/TMシステムを構成したときに、FLIPを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のインストール検証は完了です。

8.9.2.3 APPC/MVSの検証

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

  1. APPC/MVSサブシステムがアクティブであることを確認します。
  2. Windowsプラットフォームから、%ORACLE_HOME%\dg4appc\demo\MVS\pgamvs.sqlにある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のインストール検証は完了です。

                        

                        
                     

                  

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

                  

                     

                        
「コミット確認の構成」で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. 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のトランザクション・サーバーでは、 pgadb2c.cob fileにサンプルのDB2更新トランザクションDB2Cが提供されています。 これは、DB2サンプルEMP表を更新するCOBOLの例です。 IMS/TMの場合、サンプルのDLI更新トランザクションPGAIMSUがpgaimsu.cobファイルに用意されています。 これは、DLIサンプルPARTSデータベースを更新するCOBOLの例です。 
                              
    
                           
    • 
                        

                     

                     
                  

               

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

               

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

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

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

                        
このリリースでは、サンプル・アプリケーションのインストールおよび使用に関する完全なドキュメントが、次のディレクトリの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
    
                           
    •