機械翻訳について

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

以下のセクションでは、pg4tcpmapツールを操作するために必要なコマンドと命令について説明します。 このツールを使用すると、関連するパラメータをIMS ConnectのTCP/IPサポートを使用してゲートウェイにマップできます。 このツールは、PGA_TCP_IMSC表を設定するために使用されます。

トピック:

PGA_TCP_IMSC表の移入準備

ゲートウェイがIMS Connect用のTCP/IPサポートを使用している場合は、 pg4tcpmapツールを使用して PGAINITを入力して、必要なTCP/IPパラメータを入力として提供する必要があります。

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

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

PGA_TCP_IMSC表は、ゲートウェイ構成中に、Microsoft Windowsの場合%ORACLE_HOME%\dg4appc\admin\pgaimsc.sqlスクリプト、UNIXベース・システムの場合$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), and HP-UX Itaniumの第13章、または、Oracle Database Gateway for APPCインストールおよび構成ガイドfor Microsoft Windowsの第10章を参照してください。

概要

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

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

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

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: AcknowledgmentまたはDeallocateのみを送信します。

blank: AcknowledgementまたはDeallocateのリクエストはありません。

デフォルトは"blank"です。

TIMER

char(1) NOT NULL

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

D =デフォルト値X'00' .25 second;

S =短い待ちX'01'からX'19'まで: 01から.25 secondへ

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_TYPEPROGRAMに設定した場合は、RACFグループ名を指定する必要があります。

「Oracle Database Gateway for APPCインストールと構成ガイドfor IBM AIX on POWER Systems (64-Bit), Linux x86-64, Oracle Solaris on SPARC (64-Bit), and HP-UX Itanium」または「Oracle Database Gateway for APPCインストールと構成ガイドfor Microsoft Windows」の表B-1、"IMS Connect用のTCP/IPを使用するゲートウェイの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), and HP-UX Itaniumの第14章 の"TCP/IPセキュリティ・オプションSECURITY=PROGRAM"またはOracle Database Gateway for APPCインストールと構成ガイドfor Microsoft Windowsの第11章を参照してください。

IRM_ID

char(8) NOT NULL

IMS ConnectユーザーがIRM IDを終了するよう指定します。 このパラメータを指定しない場合、デフォルトのIRMREQになります。これは、IBM HWSIMSO0サンプル・ユーザー出口に対応します。

LLLL

char(1) NOT NULL

IMS Connectユーザー出口リターン・データにLLLL (全長)接頭部フィールドが含まれるかどうかを指定します。 サポートされている値は次のとおりです。

Y - 出口戻りデータには、LLLLプレフィクス・フィールド

N - 出口戻りデータにはLLLLプレフィクス・フィールドは含まれません

デフォルトはNです。

pg4tcpmapツールを実行する前に

ゲートウェイを実行する前に、pg4tcpmapツールを実行するための準備をするには、次のステップに従ってください。

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

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

    または

    UNIXベースのシステムでの$ORACLE_HOME/dg4appc/admin/pgacr8au.sql

  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

    または

    UNIXベースのシステムでの$ORACLE_HOME/dg4appc/admin/pgaimsc.sql

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

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

図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), and HP-UX Itanium」またはOracle Database Gateway for APPCインストールと構成ガイドfor Microsoft Windowsの付録B、"TCP/IP通信プロトコルのゲートウェイ初期化パラメータ"にあります。

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

pg4tcpmapツール・コマンド

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

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

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

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>と入力すると、必要なパラメータを入力するだけで済みます。

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エラー・メッセージが表示されます。

注意:

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

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