TCP/IP通信プロトコルでのゲートウェイ初期化パラメータ

B TCP/IP通信プロトコルでのゲートウェイ初期化パラメータ

次のトピックでは、IMS Connect通信プロトコル用の TCP/IPを搭載するゲートウェイに特に必要なパラメータをリストし、説明します。また、pg4tcpmapツールのサンプル出力も提供します。さらに、次のトピックには、TCP/IPを使用するゲートウェイのサンプルlistener.oraおよびtnsnames.oraファイルが含まれています。

B.1 TCP/IPを使用するゲートウェイ初期化パラメータ

IMS Connect用のTCP/IPを使用するOracle Database Gateway for APPCのパラメータ・ファイルは、%ORACLE_HOME%\dg4appc\adminディレクトリにあり、 initsid.ora.と呼ばれます

ノート:

initsid.oraファイルには、SNAパラメータとTCP/IPパラメータの両方が含まれています。これらのファイルを変更してパラメータを適切にする必要があります。

プロシージャ・ゲートウェイ管理(PGA)パラメータはゲートウェイのTCP/IPインタフェース部を制御します。

PGAパラメータは、SET ゲートウェイ初期化パラメータを使用して指定します。たとえば:

SET pga_parm=value

説明:

pga_parm は、次のリストにあるPGAパラメータ名の1つです
value は、pga_parmに依存する内容を含む文字列です

次の表に、PGAパラメータのリストと説明を示します。

表B-1 TCP/IP for IMS Connectを使用したOracle Database Gateway for APPCのPGAパラメータ

パラメータ	説明
`LOG_DESTINATION`=`logpath`	`logpath`は、`STDERR`が再オープンされる宛先を指定します。 `LOG_DESTINATION`はディレクトリのみを指定し、`STDERR`は`logpath\` `sid_pid` `.log`に再オープンされます説明: `sid`はsid名です `pid`は、ゲートウェイに割り当てられたプロセスIDです NOTE: このパラメータは、トレース・レベルを`255`に設定すると、 `pg4tcpmap`ツールに使用されます。このツールのログ・ファイルは、ゲートウェイ・ログ・ファイルと同じ場所(`pg4tcpmap_` `sid` `.log.`)にあります
`PGA_CAPABILITY`	PGAトランザクション機能。次に示す値が有効です。 `READ_ONLY`またはRO: read-only capabilities. `SINGLE_SITE`またはSS: 単一サイト更新のみ。これは、分散環境で、ゲートウェイのみが更新を行うことができることを示します。 Oracleトランザクション内部では他にいかなるデータベース更新も発生しません。デフォルトは`SINGLE_SITE`です。
`PGA_SECURITY_TYPE`	TCP/IP対話セキュリティ・オプション。これは、どのセキュリティ・パラメータがOLTPに送信されるかを制御します。次に示す値が有効です。 `NONE`。セキュリティ・パラメータを送信しません `PROGRAM`。ユーザーIDとパスワードを送信デフォルトは、`NONE`です。これらのオプションの詳細は、「セキュリティ要件」を参照してください。重要: PGAセキュリティ・オプションを`SECURITY=PROGRAM`に設定した場合は、 `pg4tcpmap`ツールを使用して RACFグループ名を指定する必要があります。この問題の詳細は、「Oracle Database Gateway for APPCユーザー・ガイド」を参照してください。表`PGA_TCP_IMSC`をすでにロードしており、最初にRACFグループ名を指定していない場合は、その行を削除して、RACFグループ名の値で再挿入します。
`PGA_TCP_DB`	ホスト名とポート番号など、ゲートウェイがTCP/IP for IMS Connect情報を受信するOracleデータベースのOracle Netサービス名。このパラメータの長さは、 `1`から`255`文字です。このパラメータは必須です。デフォルト値はありません。
`PGA_TCP_PASS`	`PGA_TCP_DB`パラメータで指定されたOracleデータベースへの接続時にゲートウェイによって使用されるOracle パスワード。パスワードは、`1`から`30`文字の長さです。このパラメータは必須です。パスワードは暗号化できます。パスワード暗号化の詳細は、「ゲートウェイ初期化ファイルのパスワード」を参照してください。デフォルト値はありません。
`PGA_TCP_USER`	`PGA_TCP_DB`パラメータで指定されたOracleデータベースへの接続時にゲートウェイによって使用されるOracleユーザーID。ユーザーIDは、`1`から`30`文字の長さです。このパラメータは必須です。デフォルト値はありません。
`TRACE_LEVEL`	PGAトレース・レベル。これは、`STDERR` (`LOG_DESTINATION`パラメータのターゲット)に書き込まれるトレース出力を制御値は、`0`から`255`までの整数である必要があります。デフォルトは0で、トレーシングを示しません。 NOTE: このパラメータは、 `pg4tcpmap`ツールおよびゲートウェイで使用されます。

B.2 pg4tcpmapツールの出力

次の出力は、ゲートウェイでIMS Connect用にTCP/IPを実行したときにpg4tcpmapツールを実行した結果を示しています。 pg4tcpmapツールの関数およびパラメータの詳細は、このガイドの「PGA_TCP_IMSC表のロード」「PGA_TCP_IMSC表のロード」および「Oracle Database Gateway for APPCユーザー・ガイド」の第6章を参照してください。

このサンプルの入力は、カッコの山カッコ(<>)内に表示されます。

C:\oracle\bin\<pg4tcpmap>
PG4TCPMAP: Release 11.2.0.1.0 - Production on Thu Jun 11 15:09:00 2009
 
Copyright (c) 1982, 2009, Oracle and/or its affiliates.  All rights reserved.
 
 
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
Enter the Unique Side Profile.
IMSPGA
Enter either the remote hostname or its TCP/IP address.
mvs09
Enter the IMS CONNECT port number.
9900
Do you want to select a CONVERSATIONAL PROTOCOL?(Y|N)
The default is NO, 'no request for acknowledgment or deallocation'
n
Enter one of the following letters for Timer.
For .25 second, enter 'D'.
For .01 to .25 second, enter 'S'.
For 'does not set the timer, no wait occurs', enter 'N'.
For Receive waits indefinitely, enter 'I'.
The default is 'D'.
D
Enter one of the following letters for 'socket connection type'.
For transaction socket, enter 'T'.
For persistent socket, enter 'P'.
For non-persistent socket, enter 'N'.
The default is 'T'.
T
Do you want to enter the CLIENT ID name? (Y|N)
If NO, IMS CONNECT (USER EXIT) will generate it.
n
Enter one of the following letters for 'COMMIT MODE'.
For Commit Mode set to 0, enter '0'.
For Commit Mode set to 1, enter '1'.
The default is '1'.
1
Enter the DATASTORE name (IMS DESTINATION ID).
The maximum string length is 8 and the Datastore name must be specified.
IMSE
Do you want to enter the LTERM? (Y|N)
If NO, the default is blank.
n
Do you want to enter the RACF GROUP name? (Y|N)
If NO, the default is blank.
n
Do you want to enter the IRM_ID? (Y|N)
If NO, the default is *IRMREQ*.
n
Does your exit return the LLLL prefix field? (Y|N)
The default is 'N'.
n
Requested to INSERT a row.
'Side Profile name' is 'IMSPGA'
'remote host name' is 'MVS09'
'IMS Connect port number' is '9900'
'conversational protocol' is ' '
'Timer' is 'D'
'socket connection type' is 'T'
'client ID' is '        '
'commit mode' is '1'
'Datastore name (IMS destination ID)' is 'IMSE    '
'IMS LTERM override' is '        '
'RACF group name' is '        '
'IRM ID' is '*IRMREQ*'
'LLLL prefix present' is 'N'
PG4TCPMAP is complete.

B.2.1 TCP/IPを使用するゲートウェイのサンプルlistener.oraファイル

LISTENER =
  (ADDRESS_LIST =
        (ADDRESS=
          (COMMUNITY= TCP.world)
          (Host = bay)
          (PROTOCOL= TCP)
          (Port= 2621)
        )
        (ADDRESS=
          (COMMUNITY= TCP.world)
          (Host = bay)
          (PROTOCOL= TCP)
          (Port= 2623)
        )
  )
 
SID_LIST_LISTENER =
  (SID_LIST =
    (SID_DESC =
      (SID_NAME = PGA)
      (ORACLE_HOME = C:\oracle\pga\12.2)
      (PROGRAM = pg4t4ic)
    )
  )

B.2.2 TCP/IPを使用するゲートウェイのサンプルtnsnames.oraファイル

ORA920 =
  (DESCRIPTION =
    (ADDRESS_LIST =
      (ADDRESS = (PROTOCOL = TCP)(HOST = bay.us.example.com)(PORT = 1521))
    )
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SERVICE_NAME = ORA920.bay)
    )
  )
 
PGA =
  (DESCRIPTION =
    (ADDRESS_LIST =
      (ADDRESS = (PROTOCOL = TCP)(HOST = bay)(PORT = 2623))
    )
    (CONNECT_DATA =
      (SID = PGA)
    )
    (HS = OK)
  )