機械翻訳について
  1. ユーザーズ・ガイド
  2. PG4TCPMAPコマンド(TCP/IPのみ)

6 PG4TCPMAPコマンド(TCP/IPのみ)

次の項では、pg4tcpmapツールの操作に必要なコマンドと手順について説明します。 このツールを使用すると、IMS ConnectのTCP/IPサポートを使用して、関連するパラメータをゲートウェイにマップできます。 このツールは、PGA_TCP_IMSC表への移入に使用されます。

トピック:

6.1 PGA_TCP_IMSC表への移入の準備

ゲートウェイでIMS Connectの TCP/IPサポートを使用している場合は、 pg4tcpmapツールを使用して、必要なTCP/IPパラメータを入力として指定するように PGAINITにプロンプトを表示する必要があります。

pg4tcpmapツールは、対応するTIPを使用する PGA_TCP_IMSC表に移入するために、PL/SQLゲートウェイ文を実行する前に実行する必要があります。

同じIMS接続属性を共有する場合、追加のIMSトランザクションに対してpg4tcpmapツールを再実行する必要はありません。

PGA_TCP_IMSC表は、ゲートウェイの構成中に、UNIXベースのシステムでMicrosoft Windowsまたは$ORACLE_HOME/dg4appc/admin/pgaimsc.sqlスクリプトに対して%ORACLE_HOME%\dg4appc\admin\pgaimsc.sqlスクリプトを実行したときに作成されました。 PGA_TCP_IMSC表の作成の詳細情報が必要な場合は、プラットフォームに応じて、「Oracle Database Gateway for APPCインストレーションおよび構成ガイドfor IBM AIX on POWER Systems (64-Bit)、Linux x86-64、Oracle Solaris on SPARC (64-Bit)およびHP-UX Itanium」の第13章 または「Oracle Database Gateway for APPCインストレーションおよび構成ガイドfor Microsoft Windows」の第10章を参照してください。

6.2 概要

PGAINITプロシージャ・コールでは、ユーザーはサイド・プロファイル名とTP名を指定する必要があります。 これらのパラメータの値は、 PGA_TCP_IMSCという名前の表に挿入されます。

ゲートウェイ・マッピング・ツールを実行する前に、ユーザーIDとパスワードを構成

pg4tcpmapツールを実行する前に、PGA_TCP_IMSC表が存在するOracleデータベースの有効なユーザーIDとパスワードおよびTNSNAMES別名を構成する必要があります。 ユーザーID、パスワードおよびデータベースは、 PGA_TCP_USER、 PGA_TCP_PASSおよびPGA_TCP_DBパラメータにそれぞれ指定する必要があります。これらのパラメータは、Microsoft Windowsの場合はゲートウェイ初期化ファイル%ORACLE_HOME%\dg4appc\admin\initsid.ora、UNIXベースの場合は$ORACLE_HOME/dg4appc/admin/initsid.oraにあります。

6.3 PGA_TCP_IMSC表への移入

「表6-1」は、PGA_TCP_IMSC表にある列名、型およびコンテンツ列に含まれるパラメータ情報を示します。

表6-1 PGA_TCP_IMSC表の列

列名 タイプ コンテンツ

SideProfileName

varchar2(8)

「このパラメータにはSNAの影響がありません」. これは、単に、PGAUユーティリティの.ctlファイルに定義されている名前です。 これは、時間遅延、ソケット・タイプ、IMSサブシステムIDなど、IMS Connect属性が類似したIMSトランザクションのグループを表します。

一意の索引。

HostName

varchar2(169) NOT NULL

OLTPのTCP/IPアドレスまたはホスト名。

PortNumber

varchar2(17) NOT NULL

OLTPポート番号。

ANDRS

char(1) NOT NULL

ANDRS は、クライアントが送信するかどうかを指定します:

A = ACK: 肯定的な認識;

N = NAK: 否定的な認識;

D = DEALLOCATE: 接続の割り当て解除

R = RESUME: TPIPEを再開

S = SENDONLY: 確認または割当解除のみを送信します。

空白: 確認または割当解除のリクエストがありません。

デフォルトは「blank」です。

TIMER

char(1) NOT NULL

ACKまたはRESUME TPIPE後のデータストアへの受信の遅延時間:

D =デフォルト値のX'00' .25秒

S =短い待機X'01'からX'19': 01から.25秒

N =待機なし

I =無制限に待機を受信します。

デフォルトは「D」です。

SOCK

char(1) NOT NULL

ソケット接続タイプ

T =トランザクション・ソケット:

P =永続ソケット

N =非永続ソケット

デフォルトは「T」です。

CLIENTID

char(8) NOT NULL

IMS Connectで使用されるクライアントIDの名前を指定します。 デフォルトは'null'です。

COMMITMODE

char(1) NOT NULL

コミット・モードを指定します:

0 =コミット・モードは0です

1 =コミット・モードは1です

デフォルトは「1」です。

IMSDESTID

char(8) NOT NULL

データストア名(IMSサブシステムID)を8バイト指定します。

このパラメータを指定する必要があります。

LTERM

char(8) NOT NULL

IMSのLTERMオーバーライドを指定します。 デフォルトは「blank」です。

RACFGRPNAM

char(8) NOT NULL

RACFグループ名を指定します。

デフォルトは「blank」です。

PGA_SECURITY_TYPEをPROGRAMに設定した場合は、RACFグループ名を指定する必要があります。

表B-1 「Oracle Database Gateway for APPCインストレーションおよび構成ガイドfor IBM AIX on POWER Systems (64-Bit)、Linux x86-64、Oracle Solaris on SPARC (64-Bit)およびHP-UX Itanium」または「Oracle Database Gateway for APPCインストレーションおよび構成ガイドfor Microsoft Windows」のTCP/IP for IMS Connectを使用したゲートウェイのPGAパラメータに関する項のPGA_SECURITY_TYPEを参照してください。

RACFユーザーIDおよびRACFパスワードの設定方法の詳細については、「Oracle Database Gateway for APPCインストレーションおよび構成ガイドfor IBM AIX on POWER Systems (64-Bit)、Linux x86-64、Oracle Solaris on SPARC (64-Bit)およびHP-UX Itanium」の第14章 または「Oracle Database Gateway for APPCインストレーションおよび構成ガイドfor Microsoft Windows」の第11章の「TCP/IPセキュリティ・オプションSECURITY=PROGRAM」を参照してください。

IRM_ID

char(8) NOT NULL

IMS Connectユーザー・イグジットIRM IDを指定します。 このパラメータを指定しない場合、IBM HWSIMSO0サンプル・ユーザー・イグジットに対応するIRMREQにデフォルト設定されます。

LLLL

char(1) NOT NULL

IMS Connectユーザー・イグジット戻りデータにLLLL (合計長)プレフィクス・フィールドを含めるかどうかを指定します。 サポートされている値は次のとおりです。

Y - 終了戻りデータには、LLLLプレフィクス・フィールドが含まれます

N - 終了戻りデータにLLLLプレフィクス・フィールドが含まれていない

デフォルトはNです。

6.4 pg4tcpmapツールを実行する前に

ゲートウェイを実行する前に、次のステップに従って、pg4tcpmapツールの実行を準備します。

  1. OracleデータベースのORACLE_HOMEおよびORACLE_SIDを設定します。
  2. ユーザーPGAADMINがOracleデータベースに作成され、データベースと通信できることを確認します。 問題:

    Microsoft Windows上の%ORACLE_HOME%\dg4appc\admin\pgacr8au.sql

    または

    $ORACLE_HOME/dg4appc/admin/pgacr8au.sql (UNIXベース・システム)

  3. initsid.oraファイルには、適切なパラメータが含まれている必要があります。 次のパラメータを設定します。

    • PGA_TCP_USER

    • PGA_TCP_PASS

    • PGA_TCP_DB

    • トレースを有効にする場合は、次のパラメータも設定する必要があります:

      • TRACE_LEVEL=255

      • LOG_DESTINATION=<valid directory>

      トレースの詳細は、「トラブルシューティング」を参照してください。

  4. PGA_TCP_IMSC表が作成されていることを確認します。 問題:

    Microsoft Windows上の%ORACLE_HOME%\dg4appc\admin\pgaimsc.sql

    または

    $ORACLE_HOME/dg4appc/admin/pgaimsc.sql (UNIXベース・システム)

「図6-1」は、サイド・プロファイル名をTCP/IPにマップする際のゲートウェイ、データベースおよびpg4tcpmapツールと、PGA_TCP_IMSC表のIMS Connect属性の関係を示しています。

図6-1 pg4tcpmapツールを使用したTCP/IPへのSNAパラメータのマッピング

図6-1の説明が続きます
図6-1 pg4tcpmapツールを使用したTCP/IPへのSNAパラメータのマッピング」の説明

pg4tcpmapツールの画面出力ファイルのコピーは、「Oracle Database Gateway for APPCインストレーションおよび構成ガイドfor IBM AIX on POWER Systems (64-Bit)、Linux x86-64、Oracle Solaris on SPARC (64-Bit)およびHP-UX Itanium」または「Oracle Database Gateway for APPCインストレーションおよび構成ガイドfor Microsoft Windows」の付録B 「TCP/IP通信プロトコルのゲートウェイ初期化パラメータ」にあります。

サンプルpg4tcpmap実行のトレース・ファイルの例は、「トラブルシューティング」にあります。

6.5 pg4tcpmapツール・コマンド

pg4tcpmapツールには、次の2つのコマンドがあります:

  • 1つのコマンドは、PGA_TCP_IMSC表に行を挿入

  • もう1つのコマンドは表から行を削除し、ユーザーは述語を「サイド・プロファイル名」として指定する必要があります。

6.5.1 PGA_TCP_IMSC表への行の挿入

Microsoft Windowsの場合は、ゲートウェイのOracleホームの%ORACLE_HOME%\binディレクトリから次のコマンドを発行します: 

C:\> pg4tcpmap

UNIXベースのシステムの場合、ゲートウェイのOracleホームの$ORACLE_HOME/binディレクトリから次のコマンドを発行します: 

$ pg4tcpmap

ゲートウェイのリリース番号、著作権情報、および次のテキストが表示されます:

This tool takes the IMS Connect TCP/IP information, such as host name and port number, and maps them to your TIPs.

You may use this tool to insert or delete IMS Connect TCP/IP information. 
If you want to insert a row, Type "I"
If you want to delete a row, type "D"

<i>と入力し、入力する必要があるのは必須パラメータのみです。

6.5.2 PGA_TCP_IMSC表からの行の削除

Microsoft Windowsの場合は、ゲートウェイのOracleホームの%ORACLE_HOME%\binディレクトリから次のコマンドを発行します: 

C:\> pg4tcpmap

UNIXベースのシステムの場合、ゲートウェイのOracleホームの$ORACLE_HOME/binディレクトリから次のコマンドを発行します: 

$ pg4tcpmap

ゲートウェイのリリース番号、著作権情報、および次のテキストが表示されます:

This tool takes the IMS Connect TCP/IP information, such as host name and port number, and maps them to your TIPs.

You may use this tool to insert or delete IMS Connect TCP/IP information. 
If you want to insert a row, Type "I"
If you want to delete a row, type "D"

<d>と入力すると、pg4tcpmapツールによって、削除するサイド・プロファイル名が表示されます。

行が存在しない場合は、ORA-1403エラー・メッセージが表示されます。

ノート:

SQL*Plusを使用してPGA_TCP_IMSC表を更新しないでください。 表に問題があるか、データが正しくない場合は、Microsoft Windowsの場合は%ORACLE_HOME%\dg4appc\admin\pgaimsc.sql、UNIXベースのシステムでは$ORACLE_HOME/dg4appc/admin/pgaimsc.sqlを使用して表とその索引を再作成します。

6.5.3 PGA_TCP_IMSC表の問合せ

通常のSQL*Plus select文を使用して、表を問い合せます。

Microsoft Windowsでの例:

C:\> sqlplus userid/password@databasename 
SQL> column hostname format A22
SQL> column portnumber format A6
SQL> select sideprofilename, hostname,portnumber,imsdestid,commitmode from
     pga_tcp_imsc;

SIDEPROF           HOSTNAME                PORTNU    IMSDESTI    C
---------------    ----------------------  ------    --------    -
IMSPGA             MVS08.US.EXAMPLE.COM     9900      IMSE        1

UNIXベース・システムの例:

$ sqlplus userid/password@databasename 
SQL> column hostname format A22
SQL> column portnumber format A6
SQL> select sideprofilename, hostname,portnumber,imsdestid,commitmode from
     pga_tcp_imsc;

SIDEPROF           HOSTNAME                PORTNU    IMSDESTI    C
---------------    ----------------------  ------    --------    -
IMSPGA             MVS08.US.EXAMPLE.COM     9900      IMSE        1