機械翻訳について

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

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

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

  • Oracleデータベース

  • UNIXシステム

  • ネットワーク

  • OLTP

11.1 始める前に

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

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

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

ゲートウェイのインストール、アップグレードまたは移行の際に、ゲートウェイと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. ゲートウェイのOracleホームの$ORACLE_HOME/dg4appc/demo/IMSディレクトリから、pgaims.sqlファイルをOracleデータベースのOracleホームの$ORACLE_HOME/dg4appc/demo/IMSディレクトリにコピーします。

    オプションのステップ: IVTNVおよびIVTNOを実行する場合は、ivtno.ctl, ivtnod.sql, ivtnv.ctlおよびivtnvd.sqlファイルを$ORACLE_HOME/dg4appc/demo/IMSディレクトリにあるOracleデータベースのOracleホームにもコピーする必要があります。 必要な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. システムで使用可能な任意のファイル転送メカニズムを使用して、ゲートウェイの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を実行する場合は、ivtno.ctl, ivtnod.sql, ivtnv.ctlおよびivtnvd.sqlファイルをOracleデータベースのOracleホームの$ORACLE_HOME/dg4appc/demo/IMSディレクトリにもコピーする必要があります。 必要なTIPが生成されたことを確認し、それらも転送します。

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

      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. 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 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行を生成する必要があります。 次の出力は、最初の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文字セットの間で正しい変換が行われると想定されているためです。

11.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パッケージ本文をアップグレードします。

      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スクリプトが正常に完了します。 仕様部がないか無効であることが原因で失敗した場合、次の項の説明に従って、パッケージの仕様部を再インストールすることを検討します。

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

ノート:

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

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

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

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

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

次の構成ステップはオプションです。 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スクリプトを実行します。 このスクリプトは、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、パスワードおよびデータベース指定文字列の入力を求められます。 プライベートの許可を使用する場合、パッケージへのアクセスを必要としている開発者1人ごとにこのステップを繰り返します。

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

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

      または

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

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

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

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

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

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

11.7 ゲートウェイの構成

ゲートウェイを構成するには、次の手順を実行します。

  1. ゲートウェイ・パラメータを調整します。

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

    ノート:

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

    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ゲートウェイ初期化パラメータを使用します。 Oracleでは、init sid. oraファイルの最後に、PGAパラメータのすべてのSETコマンド をグループ化することをお薦めします。

      ノート:

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

11.8 PGA_TCP_IMSC表のロード

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

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

たとえば、 PGAINITヒントでは、ユーザーはサイド・プロファイル名を指定する必要があります。 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ツールの出力」を参照してください。

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

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

ノート:

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

  • pgavsn.sql

  • pgaecho.sql

  • pgaims.sql

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

11.9.2 OLTP構成の検証

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

ノート:

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

11.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システムを構成したときに、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. システムで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のインストール検証は完了です。

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

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

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

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

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

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

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

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