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

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

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

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

  • Oracleデータベース

  • Windowsシステム

  • ネットワーク

  • OLTP

始める前に

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

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

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

ゲートウェイのインストール、アップグレードまたは移行の際に、ゲートウェイと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. pgaims.sqlファイルをゲートウェイOracleホーム%ORACLE_HOME%\dg4appc\demo\IMSディレクトリから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. ご使用のシステムで使用可能なファイル転送メカニズムを使用して、.sql、.pkh、および.pkbファイルをすべて、ゲートウェイOracleホーム%ORACLE_HOME%\dg4appc\adminディレクトリからOracleデータベースOracleホーム%ORACLE_HOME%\dg4appc\adminディレクトリにコピーします。
  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を実行する場合は、 ivtno.ctl、ivtnod.sql、ivtnv.ctl、およびivtnvd.sqlファイルをOracleデータベースのOracleホームの%ORACLE_HOME%\dg4appc\demo\IMSディレクトリにもコピーする必要があります。 必要なTIPが生成されたことを確認し、それらも転送します。

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

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

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

    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仕様はすべて、RAWデータとの間の数値変換ルーチンを実行するためにUTL_PGを使用します。

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

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

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

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

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

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

      SQL> DESCRIBE HS_FDS_CLASS

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

      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. PGAADMINにDBMS_PIPE上での実行権限を付与します。

      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設定およびサイド・プロファイル設定を使用してPGAUがTIPを再コンパイルする必要があります。 DEFINE TRANSACTIONコマンドで、適切なASCIIキャラクタ・セットを指定します。

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

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

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

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

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

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

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

注意:

パッケージ・スクリプトを再インストールする前に、 %ORACLE_HOME%\dg4appc\adminディレクトリにいることを確認してください

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

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

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

    2. SQL*Plusから、Oracleデータベースの%ORACLE_HOME%\rdbms\admin ディレクトリにあるutlraw.sqlおよびutlpg.sqlスクリプトを次の順序で実行して、それぞれのパッケージ仕様をアップグレードします: 

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

  • ステップ2: UTL_RAWとUTL_PGパッケージ本体のインストールを繰り返します。

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

注意:

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

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

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

次の構成ステップはオプションです。 次のステップは、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スクリプトを実行します。 このスクリプトは、2つのロール、PGDDDEFとPGDDGENを作成します。 PGDDDEFロールは、一部のPG DD表に対してはSELECT、INSERT、UPDATEおよびDELETEの各権限を、その他の表に対しては一部の権限を提供して、PGAUのDEFINE、GENERATE、REDEFINE、REPORTおよびUNDEFINEの各文の実行を許可します。 PGDDGENロールはPG DD表に対する一部の権限を提供し、PGAUのGENERATEおよびREPORT文の実行のみを許可します。 

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

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

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

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

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

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

    TIP開発者には、これらのパッケージを実行する明示的な許可が必要です。

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

    C:\> sqlplus SYS\pw@database_specification_string 
SQL> GRANT EXECUTE ON UTL_RAW TO tip_developer; 
SQL> GRANT EXECUTE ON UTL_PG TO tip_developer; 
SQL> GRANT EXECUTE ON DBMS_PIPE TO tip_developer; 
SQL> CONNECT PGAADMIN\pw@database_specification_string 
SQL> GRANT EXECUTE ON PGAADMIN.PURGE_TRACE TO tip_developer; 
SQL> GRANT EXECUTE ON PGAADMIN.READ_TRACE TO tip_developer; 
SQL> GRANT EXECUTE ON PGAADMIN.GPGLOCAL TO tip_developer; 
SQL> exit

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

    C:\> sqlplus SYS\pw@database_specification_string 
SQL> GRANT EXECUTE ON UTL_RAW TO PUBLIC;
SQL> GRANT EXECUTE ON UTL_PG TO PUBLIC;
SQL> GRANT EXECUTE ON DBMS_PIPE to PUBLIC;
SQL> CONNECT PGAADMIN\pw@database_specification_string 
SQL> GRANT EXECUTE ON PGAADMIN.PURGE_TRACE TO PUBLIC;
SQL> GRANT EXECUTE ON PGAADMIN.READ_TRACE TO PUBLIC;
SQL> GRANT EXECUTE ON PGAADMIN.GPGLOCAL TO PUBLIC;
SQL> EXIT

    プライベートの許可も、パブリックな許可も使用できます。 どちらでもPGAを使用できます。 パブリックな許可の方が容易で、すぐに実行できます。 プライベートの許可を使用する場合は、新しいTIP開発者ユーザーIDが作成されるたびに、毎回許可を発行する必要があります。

    これらの許可を実行するSQLスクリプトは、%ORACLE_HOME%\dg4appc\adminディレクトリにあります。 pgddapub.sql スクリプトは、パッケージへのパブリック・アクセスを許可します。 pgddadev.sql スクリプトは、単一のTIP開発者によるパッケージへのプライベート・アクセスの許可を実行します。 プライベートの許可を使用する場合、1つのTIP開発者ユーザーIDにつき1回ずつpgddadev.sqlスクリプトを実行する必要があります。

    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文を使用して既存のTIP仕様を再生成します。

    注意:

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

    SQL> GRANT INSERT ON PGA_DATA_VALUES TO PGDDGEN

    1. PGAU制御ファイルが生成され、TIPが格納されているディレクトリ・パスでPGAUを呼び出します。

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

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

    PG DDエントリを再定義する必要はないことに注意してください。

  5. 新たに生成されたTIP仕様が格納されている同一のディレクトリ・パスでSQL*Plusを呼び出します。

    C:\> sqlplus tip_owner\pw@database_specification_string 
SQL> @tipname.pkh 
SQL> @tipname.pkb
SQL> exit

    PGAU GENERATEを実行すると、TIPが仕様部と本体の2つの出力ファイルとして生成されます。 仕様部、本体の順で両方コンパイルする必要があります。

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

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

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

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

通信パッケージの構成が完了したら、次のセクション「ゲートウェイの構成」に戻ります。

ゲートウェイの構成

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

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

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

    注意:

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

    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ゲートウェイ初期化パラメータを使用します。 initsid.oraファイルの末尾に、PGAパラメータ用のSETコマンドをすべてまとめておくことをお薦めします。

      注意:

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

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 TIPフォーマットを使用して、適切な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ツールの出力"」を参照してください。

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

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

注意:

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

  • pgavsn.sql

  • pgaecho.sql

  • pgaims.sql

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

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

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

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

    Oracle Database Gateway for APPC (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. <==

OLTP構成の検証

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

注意:

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

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システムにログオンし、次のトランザクションを入力します(FLIPを、ゲートウェイのIMS/TMシステムを構成するときにFLIPに対して選択したトランザクションIDで置き換えます):
    FLIP THIS MESSAGE

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

    EGASSEM SIHT PILF

    注意:

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

  2. Windowsプラットフォームから、%ORACLE_HOME%\dg4appc\demo\IMS\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のインストール検証は完了です。

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

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

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

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ファイルを参照してください。

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

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

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

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

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