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

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

次のトピックでは、Microsoft WindowsプラットフォームでTCP/IP for IMS Connectを使用してゲートウェイ用にOracleデータベースを構成するステップの概要を示します。 また、ゲートウェイとOLTPコンポーネントのインストールと構成を検証するステップを説明します。

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

  • Oracleデータベース

  • Windowsシステム

  • ネットワーク

  • OLTP

9.1 始める前に

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

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

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

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

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

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

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

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

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

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

  2. 次に、ゲートウェイのデモ・ファイルおよびサブディレクトリをゲートウェイの%ORACLE_HOME%\dg4appc\demoディレクトリに配置します。 pgavsn.sql およびpgaecho.sqlファイルを、Oracleデータベース内の同じ名前のディレクトリにコピーします。

  3. ゲートウェイのOracleホームの%ORACLE_HOME%\dg4appc\demo\IMSディレクトリから、pgaims.sqlファイルをOracleデータベースのOracleホームの%ORACLE_HOME%\dg4appc\demo\IMS ディレクトリにコピーします。

  4. オプションのステップ: IVTNVおよびIVTNOを実行する場合は、ivtno.ctl, ivtnod.sql, ivtnv.ctlおよびivtnvd.sqlファイルをOracleデータベースのOracleホームの%ORACLE_HOME%\dg4appc\demo\IMSディレクトリにもコピーする必要があります。 必要なTIPが生成されたことを確認し、それらも転送します。

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
C:\> mkdir dg4appc\demo
C:\> mkdir dg4appc\demo\IMS
  3. システムで使用可能な任意のファイル転送メカニズムを使用して、ゲートウェイのOracleホームの%ORACLE_HOME%\dg4appc\adminディレクトリからOracleデータベースのOracleホームの%ORACLE_HOME%\dg4appc\adminディレクトリに、すべての.sql、.pkhおよび.pkbファイルをコピーします。
  4. ゲートウェイ・ディレクトリからOracleデータベース・ディレクトリにdemoファイルを転送してもかまいません。 pgavsn.sqlおよびpgaecho.sqlファイルのandディレクトリを、ゲートウェイのOracleホームの%ORACLE_HOME%\dg4appc\demoディレクトリからOracleデータベースの%ORACLE_HOME%\dg4appc\demoディレクトリに再帰的にコピーします。
  5. pgaims.sqlファイルをゲートウェイのOracleホームの%ORACLE_HOME%\dg4appc\demo\IMSディレクトリからOracleデータベースのOracleホームの%ORACLE_HOME%\dg4appc\demo\IMS ディレクトリにコピーすることもできます。

    オプションのステップ: IVTNVおよびIVTNOを実行する場合は、the ivtno.ctl, ivtnod.sql, ivtnv.ctlおよびivtnvd.sqlファイルをOracleデータベースのOracleホームの%ORACLE_HOME%\dg4appc\demo\IMSディレクトリにもコピーする必要があります。 必要なTIPが生成されたことを確認し、それらも転送します。

「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スクリプトを次の順序で実行します: 

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

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

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

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

      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文が成功を示していない場合は、異機種間サービス・カタログを作成し、次のステップ4.cを実行する必要があります:

    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. pg4tcpmapパッケージがOracleデータベースにインストールされていることを確認します。 ステップaからcに従って、pg4tcpmapの適切なインストールをテストします。

    pg4tcpmapツールからの出力のサンプルは、「TCP/IP通信プロトコルのゲートウェイ初期化パラメータ」の「pg4tcpmapツールの出力」を参照し、ツールの実行に必要なコマンドの詳細は、「Oracle Database Gateway for APPCユーザー・ガイド」の第6章 を参照してください。

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

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

      SQL> select table_name, owner
from dba_tables
where table_name = 'PGA_TCP_IMSC', 
and owner = 'PGAADMIN';
SQL> column owner format a 10
SQL> column index_name format a 18
SQL> column table_name format a 14
SQL> select owner, index_name, table_name, uniqueness
from dba_indexes
where index_name = 'PGA_TCP_IMSC_IND';

      どちらのSELECT文も、それぞれ1行ずつ生成する必要があります。 次に、最初のSELECT文の結果を示します。 

      TABLE_NAME                        OWNER
------------------------------  ------------------------------
PGA_TCP_IMSC                      PGAADMIN

      次に、2番目のSELECT文の結果を示します。

      OWNER          INDEX_NAME           TABLE_NAME      UNIQUENESS
----------     ------------------   --------------  ---------
PGAADMIN       PGA_TCP_IMSC_IND     PGA_TCP_IMSC    UNIQUE

      select文によって画面に前の出力が生成される場合は、ステップCをスキップできます。 select文で出力が生成されない場合、または複数の行が生成される場合、結果は前述の出力と同じではなく、ステップ7.cを実行する必要があります。

    3. SQL*Plusから、Oracleデータベースの%ORACLE_HOME%\dg4appc\adminディレクトリでpgaimsc.sqlスクリプトを実行します: 

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

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

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

    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

      ノート:

      通信プロトコルをSNAからTCP/IPに変更した場合は、TIPを再コンパイルする必要があります。

      以前にSNAプロトコルを使用してゲートウェイで生成された既存のTIPがあり、新しいTCP/IP機能を使用する場合は、必須のNLS_LANGUAGEおよびサイド・プロファイル設定を使用してTIPをPGAUで再生成する必要があります。 DEFINE TRANSACTIONコマンドで適切なASCII文字セットを指定します。

      これは、ゲートウェイではIMS Connect内で適切なユーザー・イグジットが使用されており、それによってASCII文字セットとEBCDIC文字セットの間で適切な変換が行われると想定されているためです。

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

以前のバージョンのOracle Database Gateway for APPCがシステムにインストールされており、ゲートウェイの12cリリース21 (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スクリプトが正常に完了します。 仕様が存在しないか無効になっていたために失敗した場合は、「パッケージ仕様部を再インストールする必要がある場合」の指示に従ってパッケージ仕様部を再インストールすることを検討してください。

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

ノート:

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

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

新しい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

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

次の構成ステップはオプションです。 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> @pgddcr8.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. 通信プロトコルがSNAのときにゲートウェイの以前のリリースからTCP/IPを使用して現在のゲートウェイにアップグレードする場合、および既存の TIPを新しい関数およびメンテナンスでアップグレードする場合は、 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を呼び出します。

      C:\> pgau
PGAU> CONNECT PGAADMIN\pgaadmin@database_specification_string 
PGAU> GENERATE tranname 
PGAU> EXIT

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

    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生成」コマンドの項を参照してください。

9.6 ゲートウェイ用のTCP/IP構成

次に、TCP/IP for IMS Connect通信パッケージ・プロファイルをTCP/IP接続用に構成する必要があります。

プロファイルを構成してOLTPとのTCP/IP対話を定義します。

コミュニケーション・パッケージの構成が終了したら、次のセクション(「ゲートウェイの構成」)に戻ります。

9.7 ゲートウェイの構成

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

  1. ゲートウェイ・パラメータをカスタマイズします。

    IMS ConnectにTCP/IPを使用している場合、Oracle Database Gateway for APPCには、固有のパラメータが多数あります。 これらは、 %ORACLE_HOME%\dg4appc\adminディレクトリにあるゲートウェイ・パラメータ・ファイルinitsid.oraで提供されます。 このサブディレクトリには、サンプル・ゲートウェイ・パラメータ ファイル initPGA.oraが用意されています。

    ノート:

    initsid.oraファイルで、このファイル名でゲートウェイの SID名を" sid "に置き換えます。

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

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

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

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

      ノート:

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

    • PGAパラメータ

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

      ノート:

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

9.8 PGA_TCP_IMSC表のロード

TCP/IPプロトコルを使用するゲートウェイ・ユーザーは、 pg4tcpmapツールを使用してこれを行います。

pg4tcpmapツールはゲートウェイに存在します。 サイド・プロファイル名をTCP/IPとIMS Connectの属性にマップする機能を持ちます。 このツールは、PL/SQLゲートウェイ文(%ORACLE_HOME%\dg4appc\demo\IMS\pgaims.sqlなど)を実行する前に実行する必要があります。

たとえば、PGAINIT TIPでサイド・プロファイル名を指定する必要があります。 SNAプロトコルはパラメータを認識して使用します。 このリリースのゲートウェイでは、pg4tcpmapツールは元の「PGAINITヒント」形式を使用して、関連するSNAパラメータをTCP/IPにマップします。 pg4tcpmapツールは、これらのパラメータの値を PGA_TCP_IMSCという表に挿入します。

pg4tcpmapを実行する前に、ORACLE_HOME、Oracle SIDを指定し、initsid.oraを変更する必要があります。 pg4tcpmapコマンドの詳細は、このガイドの「TCP/IP通信プロトコルのゲートウェイ初期化パラメータ」および「Oracle Database Gateway for APPCユーザー・ガイド」の第6章 を参照してください。

「Oracle Database Gateway for APPCユーザー・ガイド」の第6章 には、 pg4tcpmapコマンドのリストと、それらを使用するための手順、および表の例が含まれています。 実行されたpg4tcpmapツールのトレース・ファイルの詳細は、「Oracle Database Gateway for APPCユーザー・ガイド」のトラブルシューティングを参照してください。

このツールを操作するには、次のコマンドを実行します。

C:\> cd %ORACLE_HOME%\bin
C:\> pg4tcpmap

pg4tcpmap出力のサンプルは、「pg4tcpmapツールの出力」を参照してください。

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

ゲートウェイのインストールとOLTP構成を検証するには、ゲートウェイをインストールした後で、次の手順を実行します。

ノート:

データベース・リンク名が「PGA」でない場合は、デモンストレーションの.sqlファイルを変更して、「Oracle Databaseの構成 : 初回インストール」のステップconfigure-appc-gateway-using-tcp-ip.html#GUID-C1D6A15C-21DD-480A-A45D-EE4D3554B54C__i1008586で作成した特定のデータベース・リンク名を指定します。 次の.sqlファイルを変更する必要があります。

  • pgavsn.sql

  • pgaecho.sql

  • pgaims.sql

9.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 (extension TCP/IP for IMS connect).
Version
11.2.0.0.2 Thu Jun 11 14:52:36 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. <==

9.9.2 OLTP構成の検証

OLTP構成を検証するには次のプロシージャを使用します。

ノート:

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

9.9.2.1 IMS/TMの検証

IMS/TM構成を検証するには、次のステップを実行します。 この手順を実行する前に、インストールおよび構成したIMS Connectが稼働中であることを確認します。 インストールおよび構成タスクの実行方法の詳細は、IBM 「IMS Connectガイドおよびリファレンス」を参照してください。

ノート:

通信プロトコルをTCP/IPに変更する場合は、TIPを再コンパイルする必要があります。

TCP/IPのみ: SNAプロトコルを使用してゲートウェイで以前に生成された既存のTIPがあり、新しいTCP/IP機能を使用する場合は、必須のNLS_LANGUAGEおよびサイド・プロファイル設定を使用してPGAUによってTIPを再生成する必要があります。 DEFINE TRANSACTION コマンドで適切なASCII文字セットを指定します。

これは、ゲートウェイではIMS Connect内で適切なユーザー・イグジットが使用されており、それによってASCII文字セットとEBCDIC文字セットの間で適切な変換が行われると想定されているためです。

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

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

    EGASSEM SIHT PILF

    ノート:

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

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

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

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

    • Logmodeエントリ名

  3. システムでTCP/IP通信プロトコルが開始されたことを確認します。
  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のインストール検証は完了です。

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

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

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

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

ノート:

TCP/IPを通信プロトコルとして使用するゲートウェイを呼び出す場合で、制御ファイルで言語としてEBCDICを使用する場合は、言語をEBCDICからASCIIに変更する必要があります。 EBCDIC言語での制御ファイルの例には、ivtno.ctlおよび ivtnv.ctlがあります。

詳細は、%ORACLE_HOME%\dg4appc\demo\IMS\ivtno.ctlを参照してください

%ORACLE_HOME%\dg4appc\demo\IMS\ivtnv.ctl files.

サンプルはIMS/TM用に提供されています。

  • IVTNOおよびIVTNVサンプル・トランザクションを使用したIMS照会

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

このリリースでは、サンプル・アプリケーションのインストールおよび使用に関する完全なドキュメントが、次のディレクトリのREADME.doc ファイルにあります:

%ORACLE_HOME%\pg4appc\demo\IMS\sample_IMS_applications.txt