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データベースとゲートウェイが別のシステム上にインストールされている場合、次のタスクを実行する必要があります。
-
ゲートウェイの
$ORACLE_HOME/dg4appc/admin
ディレクトリでゲートウェイ管理ファイルを見つけます。 サフィクス.sql
、.pkh
、および.pkb
を持つこのディレクトリ内のすべてのファイルを、OracleデータベースのOracleホーム・ディレクトリ内の同じ名前のディレクトリにコピーする必要があります。 -
ここで、ゲートウェイのデモ・ファイルおよびサブディレクトリをゲートウェイの
$ORACLE_HOME/dg4appc/demo
ディレクトリに配置します。pgavsn.sql
およびpgaecho.sql
ファイルを、Oracleデータベース上の同じ名前のディレクトリにコピーします。 -
ゲートウェイの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ホーム・ディレクトリに変更する必要があります。
「Oracleデータベース構成: 初回インストール」に進みます。 これらのステップに従って、「複数のユーザーを許可するオプションの構成ステップ」を実行できます。
11.3 Oracleデータベース構成: 初回インストール
Oracle Database Gateway for APPCをインストールした後で、次のステップに従ってOracleデータベースを構成します。
-
UTL_RAW
PL/SQLパッケージがOracleデータベースにインストールされていることを確認します。 プロシージャ・ゲートウェイ管理ユーティリティ(PGAU)によって生成されるすべてのTIP仕様では、RAWデータを操作するためのルーチンを提供するUTL_RAW
が使用されます。-
SQL*Plusから、次のコマンドを入力します。
SQL> DESCRIBE UTL_RAW
DESCRIBE
文は、画面に出力を生成します。 出力を最後までブラウズすると、比較ファンクションなどいくつかのファンクションがあります。 この出力が表示されない場合は、次のステップ1.dを実行して、UTL_RAW
のインストールを続行します。DESCRIBE
文が成功を示している場合、OracleデータベースにはUTL_RAW
がインストールされており、ステップ2に進むことができます。 -
SQL*Plusを使用して、
SYS
としてOracleデータベースに接続します。 -
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
-
Oracleデータベースで、
DBMS_OUTPUT
標準PL/SQL パッケージが有効になっていることを確認します。 配布メディア上のサンプル・プログラムとインストール検証プログラムは、この標準パッケージを使用します。-
必要に応じて、SQL*Plusを使用して、
SYS
ユーザーとしてOracleデータベースに接続します。 -
次のコマンドを入力します。
SQL> DESCRIBE DBMS_OUTPUT
DESCRIBE
文は、画面に出力を生成します。 その出力を参照すると、put_line
関数などの一部の関数が表示されます。この出力が表示されない場合は、
DBMS_OUTPUT
パッケージを作成する必要があります。DBMS_OUTPUT
パッケージの詳細は、「Oracle Database PL/SQLパッケージおよびタイプ・リファレンス」を参照してください。DBMS_OUTPUT
パッケージを正常にインストールした後、DESCRIBE
文を実行します。DESCRIBE
文が成功を示している場合は、OracleデータベースにDBMS_OUTPUT
が作成され、ステップ3に進むことができます。
-
-
UTL_PG
PL/SQLパッケージをインストールします。 すべての PGAUで生成されたTIP仕様では、RAWデータとの間の数値変換を実行するためのルーチンを提供するUTL_PG
を使用します。-
必要に応じて、SQL*Plusを使用して、
SYS
ユーザーとしてOracleデータベースに接続します。 -
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
-
-
-
必要に応じて、SQL*Plusを使用して、
SYS
ユーザーとしてOracleデータベースに接続します。 -
次のコマンドを入力します。
SQL> DESCRIBE HS_FDS_CLASS
DESCRIBE
文は、画面に出力を生成します。DESCRIBE
文が成功を示している場合は、異機種間サービス・カタログがOracleデータベースに作成され、ステップ2に進むことができます。DESCRIBE文が成功を示していない場合は、異機種間サービス・カタログを作成し、ステップ4.cに従う必要があります:
-
異機種間サービス・カタログを作成する必要がある場合、次のコマンドを入力します。
SQL> @$ORACLE_HOME/rdbms/admin/caths.sql
-
-
次のようにして、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'
-
ゲートウェイ管理者ユーザー(
PGAADMIN
)を作成し、 PG DDをインストールします。-
SQL*Plusを使用して、
SYSTEM
ユーザーとしてOracleデータベースに接続します。 -
SQL*Plusから、
$ORACLE_HOME/dg4appc/admin
ディレクトリでpgacr8au.sql
スクリプトを実行します。 このスクリプトは、PGAADMIN
ユーザーIDを作成します。PGAADMIN
に定義されている初期パスワードは、PGAADMIN
です。 パスワードを変更するには、ALTER USER
コマンドを使用します。 パスワードの問題の詳細は、「Oracle Database SQL言語リファレンス」を参照してください。SQL> @$ORACLE_HOME/dg4appc/admin/pgacr8au.sql
-
SQL*Plusを使用して、
PGAADMIN
としてOracleデータベースに接続します。 -
SQL*Plusから、
$ORACLE_HOME/dg4appc/admin
ディレクトリでpgddcr8.sql
スクリプトを実行します。 このスクリプトは、PG DDをインストールします。SQL> @$ORACLE_HOME/dg4appc/admin/pgddcr8.sql
-
SQL*Plusから、
SYS
ユーザーとしてOracleデータベースに接続します。 -
DBMS_PIPE
の実行権限をPGAADMIN
に付与します:SQL> GRANT EXECUTE ON DBMS_PIPE TO PGAADMIN
-
-
pg4tcpmap
パッケージがOracleデータベースにインストールされていることを確認します。 ステップaからcに従って、pg4tcpmap
の適切なインストールをテストします。pg4tcpmap
ツールからの出力のサンプルは、「TCP/IP通信プロトコルのゲートウェイ初期化パラメータ」の「pg4tcpmapツールの出力」を参照し、ツールの実行に必要なコマンドの詳細は、「Oracle Database Gateway for APPCユーザー・ガイド」の第6章 を参照してください。-
次のコマンドを入力します。
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を実行する必要があります。 -
SQL*Plusから、Oracleデータベースの
$ORACLE_HOME/dg4appc/admin
ディレクトリでpgaimsc.sql
スクリプトを実行します:SQL> @$ORACLE_HOME/dg4appc/admin/pgaimsc.sql
-
TIPトレース・アクセスPL/SQLルーチンをインストールします。 これらのルーチンでは、
DBMS_PIPE
標準PL/SQLパッケージがインストールされていること、およびPGAADMIN
に実行権限が付与されている必要があります。DBMS_PIPE
の詳細については、「Oracle Database PL/SQLパッケージおよびタイプ・リファレンス」を参照してください。 -
GPGLOCAL
パッケージをインストールします。 このパッケージは、PGAUにより生成されたすべてのTIP仕様のコンパイルと実行のために必要です。 TIP開発者は、GPGLOCAL
に対する実行権限を付与する必要があります(「複数のユーザーを許可するオプションの構成ステップ」を参照)。-
SQL*Plusから、
$ORACLE_HOME/dg4appc/admin
ディレクトリでgpglocal.pkh
スクリプトを実行します。 このスクリプトは、GPGLOCAL
パッケージ仕様部をコンパイルします。SQL> @$ORACLE_HOME/dg4appc/admin/gpglocal.pkh
-
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)用に構成する必要がある場合にのみ、次の手順に従います。
-
次のようにして、Oracle Database Gateway for APPCを最新のバージョン・レベルにアップグレードします。
-
SQL*Plusを使用して、
SYS
ユーザーとしてOracleデータベースに接続します。 -
UTL_RAW
パッケージ本文をインストールします。 SQL*Plusから、$ORACLE_HOME/rdbms/admin
ディレクトリからprvtrawb.plb
スクリプトを実行します。 このスクリプトは、UTL_RAW
パッケージ本文をアップグレードします。SQL> @$ORACLE_HOME/rdbms/admin/prvtrawb.plb
-
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
スクリプトを実行します: - ステップ2 UTL_RAWとUTL_PGパッケージ本体のインストールを繰り返します。
-
スクリプトの実行後、「以前のゲートウェイからのOracle Databaseのアップグレードまたは移行」でステップbとcを繰り返します。 次に、「以前のゲートウェイ・リリースからのPGAUのアップグレード」というセクションに進みます。
ノート:
TIPと従属クライアント・アプリケーションは、パッケージの仕様部を再インストールしてから再コンパイルされる必要があります。 TIPのコンパイルの詳細は、「Oracle Database Gateway for APPCユーザー・ガイド」の第3章 の「ヒントのコンパイル」の項を参照してください。
11.5 複数ユーザー許容時の構成ステップ(オプション)
次の構成ステップはオプションです。 PGAADMIN
以外のユーザーがPGAUを使用して PG DD操作を実行できるようにする場合は、次のステップを実行します。
-
他のユーザーが表にアクセスできるようにするには、PG DDのパブリック・シノニムを作成します。
-
SQL*Plusを使用して、
SYSTEM
ユーザーとしてOracleデータベースに接続します。 -
SQL*Plusから、
$ORACLE_HOME/dg4appc/admin
ディレクトリでpgddcr8s.sql
スクリプトを実行します。 このスクリプトは、PG DDのパブリック・シノニムを作成します。SQL> @$ORACLE_HOME/dg4appc/admin/pgddcr8.sql
-
-
PG DDへのアクセス、トランザクションの定義およびTIP仕様の生成のためにロールを作成します。
PGAADMIN
ユーザーは、必要に応じてこれらのロールを他のユーザーに付与できます。-
SQL*Plusを使用して、ユーザー
PGAADMIN
としてOracleデータベースに接続します。 -
SQL*Plusから、
$ORACLE_HOME/dg4appc/admin
ディレクトリでpgddcr8r.sql
スクリプトを実行します。 このスクリプトは、PGDDDEF
およびPGDDGEN
という2つのロールを作成します。PGDDDEF
ロールは、一部の「PG DD」表に対するSELECT
,INSERT
,UPDATE
権限とDELETE
権限、および他の表に対するSELECT
権限を提供し、PGAUDEFINE
,GENERATE
,REDEFINE
,REPORT
文とUNDEFINE
文の実行を許可します。PGDDGEN
ロールは、「PG DD」表に対する選択権限を提供し、PGAUGENERATE
文およびREPORT
文の実行のみを許可します。SQL> @$ORACLE_HOME/dg4appc/admin/pgddcr8r.sql
-
-
TIP開発者には、Oracleデータベースに同梱の次のPL/SQLパッケージへのアクセス権が必要です。
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回実行する必要があります:-
SQL*Plusを使用して、
PGAADMIN
としてOracleデータベースに接続します。 -
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
-
通信プロトコルが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
-
PGAU制御ファイルが生成され、TIPが格納されているディレクトリ・パスからPGAUを起動します。
$ pgau PGAU> CONNECT PGAADMIN/pgaadmin@database_specification_string PGAU> GENERATE tranname PGAU> EXIT
GENERATE
コマンドの詳細は、「Oracle Database Gateway for APPCユーザー・ガイド」の第2章 のPGAUGENERATE
コマンドの項を参照してください。PG DDエントリを再定義する必要はないことに注意してください。
-
-
新たに生成された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章 のPGAUGENERATE
コマンドの項を参照してください。
11.6 ゲートウェイ用のTCP/IP構成
次に、TCP/IP for IMS Connect通信パッケージ・プロファイルをTCP/IP接続用に構成する必要があります。
プロファイルを構成してOLTPとのTCP/IP対話を定義します。
コミュニケーション・パッケージの構成が終了したら、次のセクション「ゲートウェイの構成」に戻ります。
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.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文字セットの間で適切な変換が行われると想定されているためです。
==> 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