機械翻訳について

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ディレクトリにあり、 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 Oracle Database Gateway for APPCのPGAパラメータIMS Connect用のTCP/IPの使用

パラメータ 説明

LOG_DESTINATION=logpath

logpathは、STDERRを再オープンする宛先を指定します。 LOG_DESTINATIONはディレクトリのみを指定し、STDERRlogpath\ 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表のロード」 「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.

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

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