ヘッダーをスキップ
Oracle Database Gateway for APPCインストレーションおよび構成ガイド
11gリリース1(11.1) for Microsoft Windows
E05712-01
  目次
目次
索引
索引

戻る
戻る
 
次へ
次へ
 

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

この付録では、TCP/IP for IMS Connect通信プロトコルを使用できるゲートウェイで特に必要なパラメータを列挙して説明します。また、pg4tcpmapツールのサンプル出力も示します。また、この付録には、TCP/IPを使用するゲートウェイ用のサンプルのlistener.oraおよびtnsnames.oraファイルも含まれています。含まれる項は、次のとおりです。

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

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


注意:

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

B.1.1 PGAパラメータ

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

PGAパラメータは、SETゲートウェイ初期化パラメータを使用して指定されます。次に例を示します。

SET pga_parm=value

ここで

  • pga_parmは、続くリストでのPGAパラメータ名の1つです。

  • valuepga_parmに依存する内容を持つ文字列です。

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

表B-1 TCP/IP for IMS Connectを使用するゲートウェイのPGAパラメータ

パラメータ 説明

LOG_DESTINATION=logpath

logpathSTDERRが再オープンされる宛先を指定します。LOG_DESTINATIONはディレクトリのみを指定し、STDERRlogpath\sid_pid.logに再オープンされます。

ここで

  • sidはsid名です。

  • pidはゲートウェイに割り当てられたプロセスIDです。

注意: Trace Levelを255に設定した場合、このパラメータはpg4tcpmapツール用に使用されます。このツールのログ・ファイルはpg4tcpmap_sid.logで、ゲートウェイlogファイルと同じ場所にあります。

PGA_CAPABILITY

PGAトランザクション機能。有効な値を次に示します。

READ_ONLYまたはRO: 読取り専用機能。

SINGLE_SITEまたはSS: 単一サイト更新のみ。これは、分散環境で、ゲートウェイのみが更新を行うことができることを示します。Oracleトランザクション内部では他にいかなるデータベース更新も発生しません。

デフォルトはSINGLE_SITEです。

PGA_SECURITY_TYPE

TCP/IP対話セキュリティ・オプション。これは、どのセキュリティ・パラメータがOLTPに送信されるかを制御します。有効な値を次に示します。

NONE: セキュリティ・パラメータを送信しません。

PROGRAM: ユーザーIDとパスワードを送信します。

デフォルトはNONEです。

これらのオプションの詳細情報は、第11章「セキュリティ要件」を参照してください。

重要: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サービス名。このパラメータの長さは1255文字です。このパラメータは必須です。

デフォルト値はありません。

PGA_TCP_PASS

PGA_TCP_DBパラメータによって指定されたOracleデータベースに接続するときにゲートウェイが使用するOracleパスワード。パスワードの長さは130文字です。このパラメータは必須です。パスワードは暗号化できます。パスワード暗号化の詳細は、11.6項「ゲートウェイ初期化ファイルのパスワード」を参照してください。

デフォルト値はありません。

PGA_TCP_USER

PGA_TCP_DBパラメータによって指定されたOracleデータベースに接続するときにゲートウェイが使用するOracleユーザーID。ユーザーIDの長さは130文字です。このパラメータは必須です。

デフォルト値はありません。

TRACE_LEVEL

PGAトレース・レベル。これは、STDERRLOG_DESTINATIONパラメータのターゲット)に対して作成されるトレーシング出力を制御します。値は0255の整数である必要があります。

デフォルトは0で、トレーシングを示しません。

注意: このパラメータは、ゲートウェイと同様、pg4tcpmapツールでも使用されます。


B.2 pg4tcpmapツールの出力

次の出力は、ゲートウェイ上でTCP/IP for IMS Connectを実行している場合のpg4tcpmapツールの実行結果を示します。pg4tcpmapツールの関数と使用方法の詳細は、このガイドの10.8項「PGA_TCP_IMSC表のロード」と、『Oracle Database Gateway for APPCユーザーズ・ガイド』の第6章を参照してください。

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

C:\oracle\bin\<pg4tcpmap>

PG4TCPMAP: Release 11.1.0.6 - Production on Fri Jun 3 14:57:41 2007

Copyright(c) 1982,2007 Oracle Corporation.  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.
pgaimst
Enter either the remote hostname or its TCP/IP address.
<mvs08>
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 goup name? (Y|N)
If NO, the default is blank.
<n>
Requested to INSERT a row.
'Side Profile name' is 'PGAIMST'
'remote host name' is 'MVS08'
'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 '        '
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\11.1)
      (PROGRAM = pg4t4ic)
    )
  )

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

ORA920 =
  (DESCRIPTION =
    (ADDRESS_LIST =
      (ADDRESS = (PROTOCOL = TCP)(HOST = bay.us.oracle.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)
  )