ユーザーズ・ガイド

DMCONFIGファイルの理解

Oracle Tuxedo Mainframe Adapter for OSI TPを構成、およびゲートウェイ構成を設定するには、DMCONFIGファイルを理解しておくことをお薦めします。

この項では、以下の内容について説明します。

DMCONFIGファイルの変更によるTMA OSI TPの構成方法の詳細は、「 Oracle Tuxedo Mainframe Adapter for OSI TPの構成」を参照してください。

DMCONFIGファイルの概要

DMCONFIGファイルで指定した構成により、TMA OSI TPゲートウェイの操作の大部分が制御されます。このファイルのサンプルは、TMA OSI TP製品ソフトウェアのインストール・ディレクトリに格納されています。

DMCONFIGはTuxedo System/Domainのドメイン構成ファイルのASCIIバージョンです。DMCONFIGファイルが解析され、dmloadcfユーティリティによってバイナリ・バージョンにロードされます。バイナリ構成ファイルBDMCONFIGには、ドメイン・ゲートウェイで、他のドメインとの通信に必要なコンテキスト初期化のための情報が含まれています。モニタリング活動では、dmadminでバイナリ・ファイル(またはそのコピー)が使用されます。/Domain機能を使用するTuxedo System/Domainアプリケーションには、それぞれBDMCONFIGファイルが1つあります。バイナリ構成ファイルの詳細は、「 dmloadcfユーティリティによる構成ファイルの処理」を参照してください。

DMCONFIGファイルおよびそのバイナリ・バージョンBDMCONFIGは、非/ドメインSystem/TアプリケーションのUBBCONFIGおよびTUXCONFIGファイルに類似しています。DMCONFIGファイルは、ドメインとなるよう非/ドメインSystem/Tアプリケーションの定義を拡張したものです。

DMCONFIGファイルで使用するOSI TPアプリケーション・アドレス

OSI TPアプリケーションのアドレス情報は、DMCONFIGファイルの複数のパラメータに使用されます。OSI TPを使用するTuxedoアプリケーションのアドレスは、表3-1に示す各コンポーネントの名前で構成されています。これらの名前はリモート・ドメインOSI TPの実装と連係する必要があります。

eLink OSI TP 4.0から、OSI TP実装が最適化され、プロトコル・スタックの複数のレイヤーが削除されました。そのため、P_SEL、S_SELおよびT_SELがルーティング接続に使用されなくなりました。接続はNWADDRパラメータにのみ基づいてルートされます。したがって、TMA OSI TPではNWADDRパラメータを一意にする必要があります。

* 非多重化通信にのみ有効なアプリケーション・コンポーネント

アプリケーション・エンティティ・タイトルの作成

アプリケーション・エンティティ・タイトルはAPT(アプリケーション・プロセス・タイトル)とAEQ(アプリケーション・エンティティ修飾子)を組み合せたものです。ネットワーク内のそれぞれのOSI TPノードには、一意のAETが必要です。サイトがグローバルOSIネットワークの一部である場合、OSI登録局に連絡し、有効なOSIオブジェクトIDを取得する必要があります。取得しない場合、一意のAETを次のとおり作成します。

サイトがクローズド・ネットワークの場合、3つ以上の「アーク」によってオブジェクトIDを作成します。それぞれのアークはドット区切り整数であり、オブジェクトIDの識別子を表します。有効なOSI TPのオブジェクトIDは、最初のアークが0または1、次のアークが0、1、2または3になります。

変換の提案の1つとして、APTを1.3、次に該当するNWADDRパラメータで指定したIPアドレスを指定し、AEQをNWADDRパラメータで指定したポート番号に設定します。この例は次のとおりです。

domain1
  AET="{1.3.123.55.222.51},{12344}"
  NWADDR="123.55.222.51:12344"

DMCONFIGファイル形式

ドメイン構成ファイルの形式は次のとおりです。

DMCONFIGファイル・セクション

DMCONFIGファイルは、新規ゲートウェイ構成を定義する次のセクションとパラメータで構成されています。

DMCONFIGファイル・セクションのサンプル構成ファイルと詳細な説明、および各セクションに適用可能なパラメータを次に示します。

サンプル構成ファイル

次のサンプルDMCONFIGファイルは非多重化通信を示しています。

*DM_LOCAL_DOMAINS

dalnt8 
GWGRP       = OSIGRP
TYPE        = OSITPX
DOMAINID    = "dalnt8"
BLOCKTIME   = 30
DMTLOGDEV   = "D:\tuxedo\log\DMLOG"
SECURITY    = DM_PW  # turns link layer security on 
DMTLOGNAME	  = DMLOG


*DM_REMOTE_DOMAINS

dal2200 TYPE=OSITPX DOMAINID="dal2200"
openti  TYPE=OSITPX DOMAINID="openti"
icl2    TYPE=OSITPX DOMAINID="icl2"
aseries1 TYPE=OSITPX DOMAINID="aseries1"

*DM_OSITPX

dalnt8
   AET="{1.3.132.61.146},{3}"
   TAILOR_PATH="d:\tuxedo\configs\tailor.txt"
   NWADDR="//dalnt8:102"
   DNS_RESOLUTION=STARTUP # this is the default
                
dal2200
   AET="{1.3.132.61.46},{3}"
   XATMI_ENCODING="OLTP_TM2200"
        NWADDR="132.61.46.3;132.61.147.1" #redundant IP addresses              
   T_SEL="OSITP" 

openti
   AET="{1.3.122.62.103},{209}"
   NWADDR="122.62.103.209:2001" 
   OPTIONS=SECURITY_SUPPORTED

icl2           
   AET="{1.3.142.60.203},{4}"
   NWADDR="142.60.203.4" 
   T_SEL="ICLTP" 
   S_SEL="SSEL"
   P_SEL="PSEL"

aseries1
   AET="{1.3.123.55.222},{51}"
   NWADDR="123.55.222.51" 
   XATMI_ENCODING="PRELIMINARY"
   T_SEL="0x5453"
   S_SEL="0x3F5C3F"
   
*DM_ACCESS_CONTROL
mylist  ACLIST = dalnt8, dal2200

*DM_LOCAL_SERVICES
TOUPPERF
  INRECTYPE="VIEW:view10"
  OUTBUFTYPE="FML:"
  COUPLING=LOOSE   #this is the default

TOUPPERF32
  INRECTYPE="VIEW:view10a"
  OUTBUFTYPE="FML32:"
  COUPLING=TIGHT


TOUPPERV
  INBUFTYPE="X_C_TYPE:v10"
  INRECTYPE="VIEW:upper"
  COUPLING=LOOSE

TOUPPERC OUTRECTYPE="X_OCTET" OUTBUFTYPE="CARRAY"
        INRECTYPE="X_OCTET"
        COUPLING=TIGHT

TOUPPERS  OUTRECTYPE="X_OCTET" OUTBUFTYPE="STRING"
        INRECTYPE="X_OCTET" 

TOUPPERX  OUTRECTYPE="STRING" OUTBUFTYPE="STRING"
         INRECTYPE="X_OCTET" 

*DM_REMOTE_SERVICES
DEFAULT: TRANTIME=300

ECHOXOCT RNAME="ECHOSRVR" OUTBUFTYPE="X_COMMON:ECHOVIEW" RDOM=aseries1 LDOM=dalnt8
ECHOXCOM RNAME="ECHOSRVR" RDOM=openti LDOM=dalnt8 AUTOPREPARE=Y

ECHOXCTYPE RNAME="ECHOSRVR"
         INBUFTYPE="X_C_TYPE:ECHOVIEW" 
         INRECTYPE="X_COMMON:ECHOVIEW"
         OUTBUFTYPE="X_C_TYPE:ECHOVIEW" 
         OUTRECTYPE="X_COMMON:ECHOVIEW"  			
         RDOM=aseries1
         LDOM=dalnt8
         CONV=Y
ECHOVIEW RNAME="ECHOSRVR"
         INBUFTYPE="VIEW:ECHOVIEW" 
         INRECTYPE="X_COMMON:ECHOVIEW"
         OUTBUFTYPE="VIEW:ECHOVIEW" 
         OUTRECTYPE="X_COMMON:ECHOVIEW"
         RDOM=openti
         LDOM=dalnt8
	  TPSUT_TYPE = "PRINTABLESTRING"
         REM_TPSUT="tpmvs"

*DM_ROUTING
ACCOUNT FIELD = branchid BUFTYPE = "View:account"
        RANGE = "MIN - 1000:aseries1, 1001-3000:openti"

次のサンプルDMCONFIGファイルは多重化通信を示しています。

*DM_LOCAL_DOMAINS

dalnt8 
GWGRP       = OSIGRP
TYPE        = OSITPX
DOMAINID    = "dalnt8"
BLOCKTIME   = 30
DMTLOGDEV   = "D:\tuxedo\log\DMLOG"
SECURITY    = DM_PW  # turns link layer security on 
DMTLOGNAME	  = DMLOG


*DM_REMOTE_DOMAINS

openti  TYPE=OSITPX DOMAINID="openti"
aseries1 TYPE=OSITPX DOMAINID="aseries1"

*DM_OSITPX

dalnt8
   EXTENSIONS="MULTIPLEX_POLICY=DEMAND"
   AET="{1.3.132.61.146},{3}"
   TAILOR_PATH="d:\tuxedo\configs\tailor.txt"
   NWADDR="//dalnt8:2020"
   DNS_RESOLUTION=STARTUP # this is the default
                
openti
   EXTENSIONS="MULTIPLEX=Y"
   AET="{1.3.122.62.103},{209}"
   NWADDR="122.62.103.209:2001" 
   OPTIONS=SECURITY_SUPPORTED

aseries1
   EXTENSIONS="MULTIPLEX=Y"
   AET="{1.3.123.55.222},{51}"
   NWADDR="123.55.222.51:12344" 
   XATMI_ENCODING="NATIVE_A_SERIES"
   
*DM_ACCESS_CONTROL
mylist  ACLIST = dalnt8, openti

*DM_LOCAL_SERVICES
TOUPPERF
  INRECTYPE="VIEW:view10"
  OUTBUFTYPE="FML:"
  COUPLING=LOOSE   #this is the default

TOUPPERF32
  INRECTYPE="VIEW:view10a"
  OUTBUFTYPE="FML32:"
  COUPLING=TIGHT


TOUPPERV
  INBUFTYPE="X_C_TYPE:v10"
  INRECTYPE="VIEW:upper"
  COUPLING=LOOSE

TOUPPERC OUTRECTYPE="X_OCTET" OUTBUFTYPE="CARRAY"
        INRECTYPE="X_OCTET"
        COUPLING=TIGHT

TOUPPERS  OUTRECTYPE="X_OCTET" OUTBUFTYPE="STRING"
        INRECTYPE="X_OCTET" 

TOUPPERX  OUTRECTYPE="STRING" OUTBUFTYPE="STRING"
         INRECTYPE="X_OCTET" 

*DM_REMOTE_SERVICES
DEFAULT: TRANTIME=300

ECHOXOCT RNAME="ECHOSRVR" OUTBUFTYPE="X_COMMON:ECHOVIEW" RDOM=dal2200 LDOM=dalnt8
ECHOXCOM RNAME="ECHOSRVR" RDOM=openti LDOM=dalnt8 AUTOPREPARE=Y

ECHOXCTYPE RNAME="ECHOSRVR"
         INBUFTYPE="X_C_TYPE:ECHOVIEW" 
         INRECTYPE="X_COMMON:ECHOVIEW"
         OUTBUFTYPE="X_C_TYPE:ECHOVIEW" 
         OUTRECTYPE="X_COMMON:ECHOVIEW"  			
         RDOM=aseries1
         LDOM=dalnt8
         CONV=Y
ECHOVIEW RNAME="ECHOSRVR"
         INBUFTYPE="VIEW:ECHOVIEW" 
         INRECTYPE="X_COMMON:ECHOVIEW"
         OUTBUFTYPE="VIEW:ECHOVIEW" 
         OUTRECTYPE="X_COMMON:ECHOVIEW"
         RDOM=icl2
         LDOM=dalnt8
	  TPSUT_TYPE = "PRINTABLESTRING"
         REM_TPSUT="tpmvs"

*DM_ROUTING
ACCOUNT FIELD = branchid BUFTYPE = "View:account"
        RANGE = "MIN - 1000:aseries1, 1001-3000:openti, *:dal2200"

DM_LOCAL_DOMAINSセクション

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

書式

DM_LOCAL_DOMAINSエントリの形式は次のとおりです。

LDOMの必須パラメータ[optional parameters]

説明:

LDOMは各ローカル・ドメインの指定に使用するidentifier値です。

LDOMは特定の構成で一意である必要があります。DM_LOCAL_SERVICESセクションに示すとおり、LDOMはローカル・サービスを特定のゲートウェイ・グループと接続するための識別子です。

有効パラメータ

DM_LOCAL_DOMAINSセクションに有効なパラメータを次にリストします。

パラメータ定義

それぞれのDM_LOCAL_DOMAINSセクション・パラメータに関する詳細は次のとおりです。

AUDITLOG = “string”

BLOCKTIME = numeric

DMTLOGDEV= “string”

DMTLOGNAME = “string”

DMTLOGSIZE = numeric

DOMAINID = “string”

GWGRP = identifier

MAXRDTRAN = numeric

MAXTRAN = numeric

SECURITY = {NONE | DM_PW}

TYPE = identifier

関連項目

dmadminユーティリティによるこれらのパラメータの設定については、 表A-1 DM_LOCAL_DOMAINS SECTIONを参照してください。

DM_REMOTE_DOMAINSセクション

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

書式

DM_REMOTE_DOMAINSエントリの形式は次のとおりです。

RDOM必須パラメータ [optional parameters]

説明:

RDOMはこの構成で既知の各リモート・ドメインを識別するためのidentifierの値です。

RDOMはその構成で一意である必要があります。

有効パラメータ

DM_REMOTE_DOMAINSセクションの有効なパラメータを次にリストします。

パラメータ定義

それぞれのDM_REMOTE_DOMAINSセクション・パラメータの詳細は、次のとおりです。

DOMAINID = “string”

TYPE = identifier

CODEPAGE = CPNAME

関連項目

dmadminユーティリティによるこれらのパラメータの設定については、 表A-2 DM_REMOTE_DOMAINS SECTIONを参照してください。

DM_OSITPXセクション

このセクションでは、OSITPXタイプのドメインで必要なアドレス指定情報が定義されます。このセクションは、ゲートウェイ・グループ(ローカル・ドメイン)ごとに1つ以上のエントリが、OSITPXタイプのリモート・ドメインごとに1つ以上のエントリが必要です。ブリッジ構成には、1つのローカル・ドメインに複数のゲートウェイを設定できます。

書式

DM_OSITPXエントリの形式は次のとおりです。

DOM必須パラメータ [optional parameters]

説明:

DOMは、DM_LOCAL_DOMAINSセクションのローカル・ドメイン(LDOM)またはDM_REMOTE_DOMAINSセクションのリモート・ドメイン(RDOM)を識別するidentifierの値です。

DOM識別子は、事前に定義されているDM_LOCAL_DOMAINSセクションのLDOM、またはDM_REMOTE_DOMAINSセクションのRDOMと一致する必要があります。

有効パラメータ

DM_OSITPXセクションで有効なパラメータのリストは、次のとおりです。

パラメータ定義

それぞれのDM_OSITPXセクション・パラメータの詳細は、次のとおりです。

AET = “string”

DNS_RESOLUTION = {STARTUP | RUNTIME}

EXTENSIONS = "string"

NWADDR = “string”

OPTIONS = SECURITY_SUPPORTED

P_SEL = “string”または“hex digits"

S_SEL = “string”または“hex digits"

T_SEL = “string”または“hex digits"

TAILOR_PATH = “string”

XATMI_ENCODING = {CAE | PRELIMINARY | OLTP_TM2200 | NATIVE_A_SERIES}

関連項目

dmadminユーティリティによるこれらのパラメータ設定については、表A-3 DM_OSITPX SECTIONを参照してください。

DM_ACCESS_CONTROLセクション

このセクションでは、ローカル・ドメインで使用するアクセス制御リストを指定します。

書式

DM_ACCESS_CONTROLエントリの形式は次のとおりです。

ACL_NAME必須パラメータ

説明:

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

有効パラメータ

DM_ACCESS_CONTROLセクションの有効なパラメータのリストは、次のとおりです。

パラメータ定義

DM_ACCESS_CONTROLセクション・パラメータの詳細は、次のとおりです。

ACLIST = identifier [,identifier]

関連項目

dmadminユーティリティによるこれらのパラメータの設定については、 表A-7 DM_ACCESS_CONTROL SECTIONを参照してください。

DM_LOCAL_SERVICESセクション

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

書式

DM_LOCAL_SERVICESエントリの形式は次のとおりです。

service [optional parameters]

説明:

serviceはエクスポートされたサービスの(識別子の)ローカル名であり、15文字以内にする必要があります。

この名前はローカルのTuxedo System/Domainアプリケーションで実行されているサーバーに公開された名前と一致します。エクスポートされたサービスは、 TUXCONFIGファイルのSERVICESセクションのエントリで、デフォルトまたはサービスに定義した特別なプロパティを継承します。これらのパラメータには、LOAD、PRIO、AUTOTRAN、ROUTING、BUFTYPEおよびTRANTIMEがあります。

有効パラメータ

DM_LOCAL_SEVICESセクションの有効なパラメータのリストは、次のとおりです。

パラメータ定義

DM_LOCAL_SEVICESセクション・パラメータの詳細は、次のとおりです。

ACL = identifier

COUPLING = {TIGHT | LOOSE}

INBUFTYPE = type[:subtype]

INRECTYPE = type[:subtype]

LDOM = identifier

OUTBUFTYPE = type[:subtype]

OUTRECTYPE = type[:subtype]

RNAME = “string”

関連項目

dmadminユーティリティによるこれらのパラメータの設定については、表A-4 DM_LOCAL_SERVICES SECTIONを参照してください。

DM_REMOTE_SERVICESセクション

このセクションでは、インポートされ、リモート・ドメインで利用可能なサービスに関する情報を示します。

書式

DM_REMOTE_SERVICESエントリの形式は次のとおりです。

service [optional parameters]

説明:

serviceはローカルTuxedo System/Domainアプリケーションで特定のリモート・サービスに使用される(identifier)名です。

リモート・サービスは特定のリモート・ドメインに関連付けられています。

有効パラメータ

DM_REMOTE_SERVICESセクションの有効なパラメータのリストは、次のとおりです。

パラメータ定義

DM_REMOTE_SERVICESセクション・パラメータの詳細は、次のとおりです。

AUTOPREPARE = {N | Y}

CONV = { Y | N }

INBUFTYPE = type[:subtype]

INRECTYPE = type[:subtype]

LDOM = identifier

OUTBUFTYPE = type[:subtype]

OUTRECTYPE = type[:subtype]

RDOM = identifier

REM_TPSUT = "string"

RNAME = identifier

ROUTING = identifier

TPSUT_TYPE = {INTEGER | PRINTABLESTRING}

TRANTIME = integer

関連項目

dmadminユーティリティによるこれらのパラメータの設定については、 表 A-5 DM_REMOTE_SERVICES SECTIONを参照してください。

DM_ROUTINGセクション

このセクションでは、FML、VIEW、X_C_TYPEおよびX_COMMON型付きバッファを使用したサービス・リクエストのデータ依存型ルーティングについて説明します。

書式

DM_ROUTINGエントリの形式は次のとおりです。

CRITERION_NAME必須パラメータ

説明:

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

有効パラメータ

DM_ROUTINGセクションの有効なパラメータのリストは、次のとおりです。

パラメータ定義

DM_ROUTINGセクション・パラメータの詳細は、次のとおりです。

BUFTYPE = "type1[:subtype1{,subtype2 . . . ]][;type2{:subtype3[, . . . ]]] . .."

FIELD = identifier

RANGES = “string”

関連項目

dmadminユーティリティによるこれらのパラメータ設定については、表A-6 DM_ROUTING SECTIONを参照してください。

構成の変更方法

Oracle Tuxedoシステムでは、TMA OSI TP構成を変更する3つの方法があります。

構成変更の詳細は、ATMI管理に関するOracle Tuxedo 9.1または10.0のドキュメントで、アプリケーションの動的な変更に関する項を参照してください。