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

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

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

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

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

注意:

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

PGAパラメータ

PGAパラメータはゲートウェイのTCP/IPインタフェース部を制御します。 PGAパラメータは、SETゲートウェイ初期化パラメータを使用して指定されます。次に例を示します。

SET pga_parm=value

説明:

pga_parm は、後続のリスト内のPGAパラメータ名の1つです
valueは、内容がpga_parmに依存する文字列です。

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

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

パラメータ	説明
`LOG_DESTINATION=logpath`	`logpath`は、`STDERR`を再オープンする宛先を指定します。 `LOG_DESTINATION`はディレクトリのみを指定し、`STDERR`は`logpath/sid_pid.log`に再オープンされます。説明: `sid`はsid名です `pid`は、ゲートウェイに割り当てられたプロセスIDです。注意: Trace Levelを`255`に設定した場合、このパラメータは `pg4tcpmap`ツール用に使用されます。このツールのログファイルは、ゲートウェイ・ログファイルと同じ場所に`pg4tcpmap_` `sid` `.log`にあります。
`PGA_CAPABILITY`	PGAトランザクション機能。次に示す値が有効です。 `READ_ONLY`または`RO`: 読取り専用機能。 `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`で、トレーシングを示しません。注意: このパラメータは、ゲートウェイと同様、`pg4tcpmap`ツールでも使用されます。

pg4tcpmapツールの出力

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

このサンプルでは、入力内容を山カッコ(<>)に入れて示します。

$ pg4tcpmap

PG4TCPMAP: Release 12.2.0.1.0 - Production on Wed Aug 24 15:09:00 2016

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.

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

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 = /oracle/pga/12.2)
      (PROGRAM = pg4t4ic)
    )
  )

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

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)
  )