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

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

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

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

  • Oracleデータベース

  • UNIXシステム

  • ネットワーク

  • OLTP

始める前に

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

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

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

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

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

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

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

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

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

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ディレクトリにコピーします。

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

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
$ mkdir dg4appc/demo
$ mkdir dg4appc/demo/IMS
  3. ご使用のシステムで使用可能なファイル転送メカニズムを使用して、.sql、.pkh、および.pkbファイルのすべてを、ゲートウェイのOracleホーム$ORACLE_HOME/dg4appc/adminディレクトリからOracleデータベースの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データベース構成: 初回インストールに進みます。 これらのステップに続いて、「複数のユーザーを許可するためのオプションの構成ステップ」を実行することができます。

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.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仕様はすべて、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データベースに作成されており、ステップ2に進むことができます。

      DESCRIBE文が成功を示していない場合は、異機種間サービス・カタログを作成し、ステップ4.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. pg4tcpmapパッケージがOracleデータベース上にインストールされたことを確認します。 ステップaからcに従って、pg4tcpmapが正しくインストールかどうかテストします。

    pg4tcpmapツールの出力のサンプルについては、「pg4tcpmapツールの出力」の「pg4tcpmapツールの出力」を参照し、ツールの実行に必要なコマンドの詳細については、「Oracle Database Gateway for APPCユーザーズ・ガイド」の第6章を参照してください。

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

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

      SQL> select owner, table_name
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
from dba_indexes
where index_name = 'PGA_TCP_IMSC_IND';

      SELECT文1つにつき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文が画面に前の出力を生成する場合は、ステップ8にスキップできます。 SELECT文で出力が出力されないか、複数の行が生成された場合、結果は上記の出力と同じではなく、ステップ1を実行する必要があります。

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

      SQL> @$ORACLE_HOME/dg4appc/admin/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とパスワードの入力が要求されます。 

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

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

    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

      注意:

      通信プロトコルを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 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パッケージ本体をアップグレードします。 

      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のアップグレードまたは移行"」でステップbとcを繰り返します。 次に、「"以前のゲートウェイ・リリースからの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をアップグレードします。

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

次の構成ステップはオプションです。 次のステップは、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/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ロールは、他の人に対して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人ごとにこのステップを繰り返します。

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

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

      または

      SQL> @$ORACLE_HOME/dg4appc/admin/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を起動します。

      $ 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コマンドのセクションを参照してください。

ゲートウェイ用の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ディレクトリにあるinit sid. oraというゲートウェイ・パラメータ・ファイルで提供されます。 このサブ・ディレクトリには、サンプル・ゲートウェイ・パラメータファイル、initPGA.oraが用意されています。

    注意:

    init sid. oraファイルで、このファイル名の"sid"の代わりにgatewaySID名を使用します。

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

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

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

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

      注意:

      次のステップを実行する前に、ゲートウェイの初期化とPGAパラメータの調整については、「"TCP/IPを使用したゲートウェイ初期化パラメータ・ファイル"」を参照してください。 PGA_CAPABILITYパラメータの使用方法に関する説明に特に注意してください。

    • PGAパラメータ

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

      注意:

      間違ったパラメータは無視されます。 ただし、 $ORACLE_HOME/dg4appc/admin/init sid。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を指定し、init sid. oraを変更する必要があります。 pg4tcpmapコマンドの詳細については、このガイドの「TCP/IP通信プロトコルのゲートウェイ初期化パラメータ」と「Oracle Database Gateway for APPCユーザーズ・ガイド」の第6章を参照してください。

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

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

$ $ORACLE_HOME/bin/pg4tcpmap

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

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

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

注意:

databaseリンク名が"PGA"でない場合は、「Oracle Databaseの構成: 初回インストール」のステップ5で作成した特定のデータベース・リンク名をデモ用.sqlファイルに変更してください。 次の.sqlファイルを変更する必要があります。

  • pgavsn.sql

  • pgaecho.sql

  • pgaims.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 (extension TCP/IP for IMS connect).
Version
12.2.0.1.0 Wed Aug 24 14:52:36 2016
 
Copyright (c) Oracle Corporation 1979,
2016.  All rights reserved.

PL/SQL procedure successfully completed.
  3. $ORACLE_HOME/dg4appc/demo/pgaecho.sqlを実行します。
    SQL> @$ORACLE_HOME/dg4appc/demo/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. UNIXベースのシステムにログオンします。

    注意:

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

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

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

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

    • Logmodeエントリ名

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

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

次に示すのは、必要に応じて実行できるオプションのステップです。 ゲートウェイの動作と、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照会

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

このリリースでは、サンプル・アプリケーションのインストールと使用方法に関する資料をすべて次から入手できます。

$ORACLE_HOME/dg4appc/demo/IMS/sample_IMS_applications.txt