Gatewayユーザー・ガイド

Oracle TMA TCP Gatewayの構成

Oracle Tuxedo Mainframe Adapter for TCP Gateway(以後TMA TCP Gatewayと呼ぶ)を実行する前に、次の構成ファイルを構成する必要があります。

このドキュメントでは、TMA TCP Gatewayを構成する次の手順について説明します。

Oracle TuxedoのUBBCONFIGファイルの更新

他のTuxedoサーバーと同様に、ローカル・リージョン用のUBBCONFIGファイルにTMA TCP Gatewayのエントリを追加して、TMA TCP Gatewayのサーバー・グループを作成する必要があります。具体的には、次のレコードを追加する必要があります。

UBBCONFIGファイルの詳細は、Oracle Tuxedo管理者ガイドを参照してください。ゲートウェイ固有のUBBCONFIGファイルの詳細は、「GROUPSセクションの更新によるサーバー・グループの作成」および「SERVERSセクションの更新」の項を参照してください。

GROUPSセクションの更新によるサーバー・グループの作成

TMA TCP Gatewayのサーバー・グループを作成するには、Oracle TuxedoのUBBCONFIGファイルのGROUPSセクションに次の項目を追加する必要があります。

構文

構成ファイルのエントリの構文は次のとおりです。

groupname LMID=logical_machine_identifier
          GROUPNO=group_number

変数の定義は次のとおりです。

例

サーバー・グループを作成するUBBCONFIGエントリの例を次に示します。

NODE2GATE   LMID=NODE2
            GROUPNO=1

SERVERSセクションの更新

この項では、Oracle Tuxedoの構成にTMA TCP Gatewayサーバーを指定する方法について説明します。

TMA TCP Gateway製品では、Oracle TuxedoのUBBCONFIG構成ファイルのSERVERSセクションに、リストする必要があるゲートウェイを指定できます。

TMA TCP Gatewayのサーバー・グループごとに1つずつゲートウェイを指定できます。また、ドメイン管理サーバーのエントリ(DMADM)とゲートウェイ管理サーバーのエントリ(GWADM)も必要です。

構文

構成ファイルの各エントリの構文は次のとおりです。

DMADM      SVRGRP=groupname SRVID=integer
GWADM      SVRGRP=groupname SRVID=integer
GWIDOMAIN  SVRGRP=groupname SRVID=integer
            CLOPT="-A -- -r"

次の表に各部分の構文を説明します。

Oracle Tuxedoサーバーとそれに関連する構成パラメータの詳細は、Oracle Tuxedo管理者ガイドを参照してください。

リクエスト記録オプションの使用方法

-rコマンド・ライン・オプションの出力をtxrptコマンドが処理できなくてはなりません。txrptコマンドは、Oracle Tuxedoサーバーの標準エラー出力を解析し、サーバーのサービス処理時間を要約します。レポートには、各サービスがディスパッチされた回数と、所定の時間内に各サービスがリクエストを処理した時間の平均が出力されます。txrptの入力元は、標準入力か、または入力としてリダイレクトされた標準エラー・ファイルです。

その他のサーバー構成オプション

他のTuxedoサーバーと同様に、Oracle Tuxedoシステム・サーバーの一部の起動オプションをTMA TCP Gatewayサーバーにも使用できます。起動オプションはCLOPTパラメータ(CLOPTの二本線ダッシュ区切り文字の前)で指定する必要があります。

これらの起動オプションとその他の起動オプションの詳細は、Oracle Tuxedo管理者ガイドのservopts(5)を参照してください。

GWICONFIGファイルのパラメータの指定

GWICONFIGファイルは、システム管理者がTMA TCP Gatewayの構成に使用するメカニズムです。ゲートウェイがどのファイルを使用するかは、環境変数GWICONFIGによって決定されます。構成ファイルは、構造面でも構成面でもTuxedoトランザクション・マネージャのUBBCONFIGファイルに似ています。したがって、管理者にOracle Tuxedoの経験があれば、各種のトレーニングを受けなくても、TMA TCP Gatewayを構成できます。

GWICONFIGファイルは次の必須セクションに分かれています。

*GLOBAL
		NWDEVICE="/dev/tcp"
		CONNECT_TIME=20
		OUTREQ_TIME=20
		LATENCY=-2
		SECURE=N
		MULTIPLEX=2
		DFLTWRAP="TPS"
		DFLTTYPE="MVS"
*NATIVE
LOCAL		IPADDR="//beasun2"
		TCP_PORT=9002
		IDLE_TIME=20

*FOREIGN
RIGHTY		WRAP="TPS"
		TYPE="MVS"
		IPADDR="//beasun2"
		TCP_PORT=9004
		MULTIPLEX=2
		IDLE_TIME=30
		RMTACCT="zeke"
		PASSWORD="maple"

MIKE		WRAP="TPS"
		TYPE="MVS"
		IPADDR="//dalvs3"
		TCP_PORT=9001
		MULTIPLEX=6

*LOCAL_SERVICES
TUXTOUPPER 

ECHO		

*REMOTE_SERVICES
TUXTOLOWER 
		OUTREQ_TIME=20

BEASVR07		
		OUTRECTYPE="VIEW:weird"

TST1V 

GWICONFIGファイルのGLOBALセクションの定義

次からの項で、GWICONFIGファイルのGLOBALセクションに関連するパラメータについて説明します。これらのパラメータは、ゲートウェイの全般的な特性を示します。

GWICONFIGファイルのGLOBALセクションのフォーマットを次のコード・リストに示します。

[ # A comment (from "#" to end of line)]

*GLOBAL
[ NWDEVICE=TCP_device ]
[ CONNECT_TIME=n]
[ IDLE_TIME=n]
[ OUTREQ_TIME=n]
[ LATENCY=n|1 ]
[ SECURE=Y|N ]
[ MULTIPLEX=n|1 ]
[ DFLTWRAP=wrapper name ]
[ DFLTTYPE=translation type ]

次の表に、GLOBALセクションに設定するパラメータを示します。

GWICONFIGファイルのNATIVEセクションの定義

次の項から、GWICONFIGファイルのNATIVEセクションに関連するパラメータについて説明します。これらのパラメータはローカル・システム固有のパラメータです。同じ構成ファイルに複数のネイティブ・システムを指定できるため、複数のゲートウェイ・プロセスが同じ構成ファイルにアクセスできます。これにより、接続サービスが一元化されます。ゲートウェイ・プロセスとネイティブ・システムのエントリとの関連付けは、GWINAME環境変数を使用して行います。

GWICONFIGファイルのNATIVEセクションのフォーマットは、次のコード・リストに示すとおりです。

[ # A comment (from "#" to end of line)]
*NATIVE
  <GATEWAY_NAME> 
[ IPADDR=ip_address ]
[ TCP_PORT=port number ]
[ IDLE_TIME=n]
[ MULTIPLEX=n]
[ POLL_TIME=n]
[ MAXCONNECT=n]

次の表に、NATIVEセクションに指定する各ローカル・システムを示します。

GWICONFIGファイルのFOREIGNセクションの定義

GWICONFIGファイルのFOREIGNセクションで、外部システムに関するパラメータを集中的に記述します。

GWICONFIGファイルのFOREIGNセクションのフォーマットは、次のコード・リストに示すとおりです。

[ # A comment (from "#" to end of line)]
*FOREIGN
  <SYSTEM_NAME>
  IPADDR=ip_address
  [TYPE=system_type]
  [WRAP=wrapper name]
  [TCP_PORT=port number]
  [MULTIPLEX=n sessions]
  [IDLE_TIME=n seconds]
  [RMTACCT=”userid”]
  [PASSWORD=”password”]
  [CICS=Y | N]
  [CICSHAND=<name>]
  [MAXCONNECT=n]
  [CONNSYNC=Y|N]
  [CONNECT_TIME=n]
  [CICSDATA="string"]

次の表に、FOREIGNセクションで指定する外部システムごとに設定するパラメータを示します。

次の表に、FOREIGNセクションに指定するパラメータを示します。

GWICONFIGファイルのLOCAL_SERVICESセクションの定義

GWICONFIGファイルのLOCAL_SERVICESセクションには、DMCONFIGファイルに指定されている各ローカル・サービスのパラメータを指定します。各サービスのエントリ名は、DM_LOCAL_SERVICESセクションのサービスのリモート名と一致していなければなりません。

GWICONFIGファイルのLOCAL_SERVICESセクションのフォーマットは、次のコード・リストに示すとおりです。

[ # A comment (from "#" to end of line)]
*LOCAL_SERVICES
  <SERVICE_NAME>
[INRECTYPE=”foreign_incoming_buffer_type”]
  [OUTRECTYPE=”foreign_outgoing_buffer_type”]
  [SECURE=Y | N]
  [CONV=Y | N]

次の項では、LOCAL_SERVICESセクションに指定するサービスごとのパラメータ設定について説明します。

GWICONFIGファイルのREMOTE_SERVICESセクションの定義

GWICONFIGファイルのREMOTE_SERVICESセクションには、DMCONFIGファイルに指定されている各リモート・サービスのパラメータを指定します。各サービスのエントリ名は、DM_REMOTE_SERVICESセクションのサービスのリモート名と一致していなければなりません。

GWICONFIGファイルのREMOTE_SERVICEセクションのフォーマットは、次のコード・リストに示すとおりです。

[ # A comment (from "#" to end of line)]
*REMOTE_SERVICES
  <SERVICE_NAME>
[INRECTYPE=”foreign_outgoing_buffer_type”]
  [OUTRECTYPE=”foreign_incoming_buffer_type”]
  [OUTREQ_TIME=n]
  [SECURE=Y | N]
  [CONV=Y | N]

次の表に、REMOTE_SERVICESセクションに指定するサービスごとのパラメータ設定について説明します。

DMCONFIGファイルでのドメイン構成の定義

ドメイン構成ファイルは(DMCONFIG)は仕様セクションで構成されます。アスタリスク(*)で始まる行は、仕様セクションの開始を表します。このような行では必ず、*の直後にセクションの名前が続きます。セクション名を指定するときにアスタリスクが必要です。指定可能なセクション名は、DM_LOCAL_DOMAINS、DM_REMOTE_DOMAINS、DM_LOCAL_SERVICES、DM_REMOTE_SERVICES、DM_ROUTINGおよびDM_ACCESS_CONTROLです。

これより、新しいゲートウェイ構成を定義するDMCONFIGファイルの具体的なセクションごとに重要なパラメータについて説明します。

DM_LOCAL_DOMAINSセクション

このセクションは、ローカル・ドメインと、それに関連付けるゲートウェイ・グループを指定します。セクションにはゲートウェイ・グループ(ローカル・ドメイン)ごとのエントリが必要です。各エントリには、そのグループで実行するドメインのゲートウェイ・プロセスに必要なパラメータを指定します。

DMCONFIGファイルのDM_LOCAL_DOMAINSセクションのフォーマットは、次のコード・リストに示すとおりです。

LDOM   required parameters  [optional parameters] 

LDOMは各ローカル・ドメインの名前付けに使用するidentifierの値であり、同じ構成の中で一意でなくてはなりません。DM_LOCAL_SERVICESセクションに記述する場合、LDOMはローカル・サービスが特定のゲートウェイ・グループに接続する際の識別子になります。

次の表に、DM_LOCAL_SERVICESセクションに設定するパラメータを示します。

DM_REMOTE_DOMAINSセクション

このセクションは認識されるリモート・ドメインとその特性のセットを指定します。

DMCONFIGファイルのDM_REMOTE_DOMAINSセクションのフォーマットは、次のコード・リストに示すとおりです。

RDOM   required parameters [optional parameters]

RDOMは、この構成の中で認識されているリモート・ドメインをそれぞれ識別するために使用するidentifier値であり、構成の中で一意でなくてはなりません。

次の表に、DM_REMOTE_DOMAINSセクションに設定するパラメータを示します。

DM_ACCESS_CONTROLセクション

このセクションは、DMCONFIGファイルのオプションのセクションであり、ローカル・ドメインによって使用されるアクセス制御リストを示します。

DMCONFIGファイルのDM_ACCESS_CONTROLセクションのフォーマットは、次のコード・リストに示すとおりです。

ACL_NAME   required parameters

ACL_NAMEは固有のアクセス制御リストの識別に使用する名前(identifier)です。名前の長さは15文字以下にする必要があります。

DM_LOCAL_SERVICESセクション

このセクションには、各ローカル・ドメインから外部に公開するサービスに関する情報を指定します。このセクションはオプションであり、指定しない場合は、DM_LOCAL_DOMAINSセクションに定義されているすべてローカル・ドメインが、TuxedoシステムまたはTuxedoドメインのアプリケーションが実行しているすべてのサービスに対するリクエストを受け付けます。このセクションを定義する場合は、リモート・ドメインからリクエスト可能なローカル・サービスのグループの限定に使用するようにしてください。

DMCONFIGファイルのDM_LOCAL_SERVICESセクションのフォーマットは、次のコード・リストに示すとおりです。

service    [optional parameters] 

serviceは、外部に公開するサービスのローカル名(identifier)で、名前の長さが15文字以内に制限されています。

この名前は、ローカルのTuxedoシステムまたはTuxedoドメインのアプリケーションと連携して動作する1つ以上のサーバーで決められている名前に相当します。外部に公開するサービスは、TUXCONFIGファイルのSERVICESセクションのエントリに指定されているサービスのデフォルトのプロパティや固有のプロパティを引き継ぎます。これらのパラメータとしては、LOAD、PRIO、AUTOTRAN、ROUTING、BUFTYPE、TRANTIMEなどがあります。

DM_REMOTE_SERVICESセクション

このセクションには、リモート・ドメイン上のアクセス可能なサービスに関する情報を指定します。

DMCONFIGファイルのDM_REMOTE_SERVICESセクションのフォーマットは、次のコード・リストに示すとおりです。

service    [optional parameters]

serviceは、ローカルのTuxedoシステムまたはTuxedoドメインのアプリケーションが特定のリモート・サービスにアクセスする際に使用する名前(identifier)です。リモート・サービスは特定のリモート・ドメインに関連付けられます。

DM_ROUTINGセクション

このセクションはDMCONFIGファイルにおけるオプションのセクションであり、型付きバッファであるFML、VIEW、X_C_TYPEおよびX_COMMONを使用したサービス・リクエストのデータ依存型ルーティングに関する情報を提供します。

DMCONFIGファイルのDM_ROUTINGセクションのフォーマットは、次のコード・リストに示すとおりです。

CRITERION_NAME    required parameters 

CRITERION_NAMEは、サービス・エントリに指定したルーティング・エントリの名前(identifier)です。CRITERION_NAMEは15文字以内にする必要があります。

DMCONFIGファイルの例

リスト5-16は、DMCONFIGファイルのサンプルであり、TMA TCP Gateway製品を実行する前にこのファイルを設定する必要があります。代替のデータ・マッピング用ツールを使用するDMCONFIGファイルのサンプルについては、「Oracle TMA TCP Gatewayのデータ・マッピングに関する構成」の項を参照してください。

#
#	Copyright (c) 2008 Oracle Systems, Inc
#	All Rights Reserved
#
#	THIS IS UNPUBLISHED PROPRIETARY SOURCE CODE OF
#	Oracle Systems, Inc.
#	The copyright notice above does not evidence any
#	actual or intended publication of such source code.
#
#
*DM_LOCAL_DOMAINS
LOCAL 		GWGRP=GROUP
		TYPE=IDOMAIN
		DOMAINID="LOCAL"

#
*DM_REMOTE_DOMAINS
REMOTE 		TYPE=IDOMAIN
		DOMAINID="REMOTE"

#
*DM_LOCAL_SERVICES
ECHOX		RNAME="ZECHOSV4"
TOLOWER		RNAME="TUXTOLOWER"
		INBUFTYPE=string
		OUTBUFTYPE=string

#
*DM_REMOTE_SERVICES
TOUPPER		RDOM=REMOTE
		LDOM=LOCAL
		RNAME="TUXTOUPPER"


ECHOFAR		RDOM=REMOTE
		LDOM=LOCAL
		RNAME="BEASVR07"
		INBUFTYPE="VIEW:myview"
		OUTBUFTYPE="FML"

NORMAL		RDOM=REMOTE
		LDOM=LOCAL
		RNAME="TST1V"