ファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス

セクション5 - ファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス

表とファイルの紹介

説明

この項では、様々な表およびファイルについて説明します。

compilation(5)という名前のページには、アプリケーション・ソース・コードのコンパイル時に必要なヘッダー・ファイル、レイアウトおよび環境変数に関する情報がまとめられています。

この項には、Oracle Tuxedoシステム提供のサーバーの説明が含まれます。Oracle Tuxedoシステム提供のサーバーを使用するアプリケーションは、アプリケーションの構成ファイルにこれらを指定する必要があります。

servoptsページには、アプリケーション・サーバーのCLOPTパラメータとして構成ファイルに指定できるオプションが説明されています。

Oracle Tuxedo管理情報ベースは、MIB(5)リファレンス・ページおよび次のコンポーネントMIBページで説明されています。

ACL_MIB(5)

名前

ACL_MIB - ACLの管理情報ベース

形式

#include <fml32.h>
#include <tpadm.h>

説明

Oracle TuxedoシステムのMIBは、アクセス制御リスト(ACL)を管理するためのクラスのセットを定義します。これらのクラスをアクセスおよび更新するには、SECURITYがUSER_AUTH、ACLまたはMANDATORY_ACLに設定されたOracle Tuxedo構成を作成する必要があります。管理リクエストのフォーマットと管理応答の解釈を行うには、ACL_MIB(5)を共通MIBリファレンス・ページMIB(5)と一緒に使用します。このリファレンス・ページで説明するクラスや属性を使用し、MIB(5)の説明に従ってフォーマットしたリクエストを使用すると、アクティブなアプリケーションの既存のATMIインタフェースの1つを通じて管理サービスをリクエストできます。ACL_MIB(5)のすべてのクラス定義の追加情報については、「ACL_MIB(5)に関する追加情報」を参照してください。

ACL_MIB(5)は、次のクラスで構成されています。

各クラスの説明セクションには、次の4つのサブセクションがあります。

概要

属性表

属性のセマンティクス

制限

属性表の形式

前述のように、このMIBに含まれる各クラスは、4つの部分に分けて以下に定義されています。その1つが属性表です。属性表はクラス内の属性のリファレンス・ガイドであり、管理者、オペレータ、一般ユーザーがそれらの属性を使用してアプリケーションと対話するための方法を説明しています。属性表の各属性の説明には、5つの構成要素(名前、型、許可、値、デフォルト)があります。各要素については、MIB(5)を参照してください。

TA_FLAGS値

MIB(5)は、共通TA_FLAGS属性を定義します。この属性はlong型で、共通MIBフラグ値とコンポーネントMIB固有フラグ値の両方を持ちます。現時点では、ACL_MIB(5)固有のフラグ値は定義されていません。

FML32フィールド表

このリファレンス・ページで説明する属性のフィールド表は、システムにインストールしたOracle Tuxedoシステム・ソフトウェアのルート・ディレクトリからの相対パスで指定されるudataobj/tpadmファイルにあります。${TUXDIR}/udataobjディレクトリは、FLDTBLDIR環境変数で指定されるコロン区切りのリストにアプリケーションによって追加される必要があり、フィールド表名tpadm()は、FIELDTBLS環境変数で指定されるカンマ区切りのリストに追加される必要があります。

制限

このMIBのヘッダー・ファイルとフィールド表には、Oracle Tuxedoリリース6.0以降で実行されているサイト(ネイティブとワークステーションの両方)からのみアクセスできます。

T_ACLGROUPクラスの定義

概要

T_ACLGROUPクラスは、Oracle Tuxedoアプリケーションのユーザーおよびドメインのグループを表します。

属性表

属性のセマンティクス

TA_GROUPNAME: string[1..30]

TA_GROUPID: 0 <= num < 16,384

TA_STATE:

制限

1つのACLグループには1人のユーザーを関連付けることができます。複数のロールを引き受けたり複数のグループに関連付けられるユーザーの場合、複数のユーザー・エントリを定義する必要があります。

T_ACLPERMクラスの定義

概要

T_ACLPERMクラスは、Oracle Tuxedoシステムのエンティティに対するアクセスが許可されるグループを示します。これらのエンティティは文字列を介して名前が付けられます。現在、これらの名前は、サービス名、イベント名およびアプリケーション・キュー名を表します。

属性表

属性のセマンティクス

TA_ACLNAME: string

TA_ACLTYPE: ENQ | DEQ | SERVICE | POSTEVENT

TA_ACLGROUPIDS: string

TA_STATE:

制限

許可は、個々のユーザー識別子ではなくグループ・レベルで定義されます。

T_ACLPRINCIPALクラスの定義

概要

T_ACLPRINCIPALクラスは、関連付けられているOracle Tuxedoアプリケーションおよびグループにアクセスできるユーザーまたはドメインを表します。特定のユーザーとしてアプリケーションに参加するには、ユーザー固有のパスワードを提示する必要があります。

属性表

属性のセマンティクス

TA_PRINNAME: string

TA_PRINCLTNAME: string

TA_PRINID: 1 <= num < 131,072

TA_PRINGRP: 0 <= num < 16,384

TA_PRINPASSWD: string

TA_STATE:

制限

1つのACLグループには1人のユーザーまたは1つのドメインを関連付けることができます。複数のロールを引き受けたり複数のグループに関連付けられるユーザーの場合、複数のプリンシパル・エントリを定義する必要があります。

ACL_MIB(5)に関する追加情報

診断

ACL_MIB(5)への接続時には、2つの一般的なタイプのエラーがユーザーに戻される場合があります。1つは、管理リクエストに対するレスポンスを検索する3つのATMI関数(tpcall()、tpgetrply()、およびtpdequeue())が戻すエラーです。これらのエラーは、該当するリファレンス・ページの記述に従って解釈されます。

ただし、リクエストがその内容に対応できるシステム・サービスに正常にルーティングされても、システム・サービス側でそのリクエストを処理できないと判断されると、アプリケーション・レベルのサービス障害としてエラーが返されます。このような場合、tpcall()とtpgetrply()は、tperrnoをTPESVCFAILに設定してエラーを戻し、以下のようにエラーの詳細を示すTA_ERROR、TA_STATUS、およびTA_BADFLDフィールドと一緒に、元のリクエストを含む応答メッセージを戻します。TMQFORWARD(5)サーバー経由でシステムに転送されたリクエストに対してサービス障害が発生すると、元のリクエストで識別される異常終了キューに障害応答メッセージが追加されます(TMQFORWARDに対して-dオプションが指定されたとみなされる)。

管理リクエストの処理中にサービス・エラーが発生すると、TA_STATUSというFML32フィールドにエラーの内容を説明したテキストが設定され、TA_ERRORというFML32フィールドにはエラーの原因(下記参照)を示す値が設定されます。次のエラー・コードは、いずれも負であることが保証されています。

以下の診断コードはTA_ERRORで戻されるもので、管理リクエストが正常に完了したことを示します。これらのコードは負数でないことが保証されています。

[other]

相互運用性

このリファレンス・ページで定義されているヘッダー・ファイルおよびフィールド表は、Oracle Tuxedoリリース6.0以降で利用できます。これらのヘッダーや表で定義するフィールドはリリースが変わっても変更されません。ただし、以前のリリースで定義されていない新しいフィールドが追加される場合があります。AdminAPIには、リクエストを作成するために必要なヘッダー・ファイルとフィールド表があれば、どのサイトからでもアクセスできます。T_ACLPRINCIPAL、T_ACLGROUPおよびT_ACLPERMクラスは、Oracle Tuxedoリリース6.0の新クラスです。

移植性

Oracle TuxedoシステムのMIBを使用した管理作業をサポートするために必要な既存のFML32およびATMI関数、さらにこのリファレンス・ページに定義するヘッダー・ファイルとフィールド表は、すべてのサポート対象ネイティブ・プラットフォームとワークステーション・プラットフォームで使用可能です。

例

次のコードの抜粋は、グループにユーザーを追加し、このグループの許可をサービス名に追加するものです。

フィールド表

属性フィールド識別子にアクセスするには、フィールド表tpadmが必要です。そのためには、次のようにシェルで入力します。

$ FIELDTBLS=tpadm 
$ FLDTBLDIR=${TUXDIR}/udataobj
$ export FIELDTBLS FLDTBLDIR

ヘッダー・ファイル

次のヘッダー・ファイルがインクルードされます。

#include <atmi.h> 
#include <fml32.h>
#include <tpadm.h>

ユーザーの追加

次のコードの抜粋部分は、デフォルト・グループ"other"にユーザーを追加出するものです。

/* Allocate input and output buffers */ 

ibuf = tpalloc("FML32", NULL, 1000);

 obuf = tpalloc("FML32", NULL, 1000);
 
 /* Set MIB(5) attributes defining request type * 
 Fchg32(ibuf, TA_OPERATION, 0, "SET", 0);
 Fchg32(ibuf, TA_CLASS, 0, "T_ACLPRINCIPAL", 0);
 
 /* Set ACL_MIB(5) attributes */
 Fchg32(ibuf, TA_PRINNAME, 0, ta_prinname, 0);
 Fchg32(ibuf, TA_PRINID, 0, (char *)ta_prinid, 0);
 Fchg32(ibuf, TA_STATE, 0, (char *)"NEW", 0);
 
 Fchg32(ibuf, TA_PRINPASSWD, 0, (char *)passwd, 0);
 
 
 /* Make the request */
 if (tpcall(".TMIB", (char *)ibuf, 0, (char **)obuf, olen, 0) 0)  {
 fprintf(stderr, "tpcall failed: %s\en", tpstrerror(tperrno));
 if (tperrno == TPESVCFAIL) {
 Fget32(obuf, TA_ERROR, 0,(char *)ta_error, NULL);
 ta_status = Ffind32(obuf, TA_STATUS, 0, NULL);
 fprintf(stderr, "Failure: %ld, %s\en",
 ta_error, ta_status);
 }
 /* Additional error case processing */
 }

ファイル

${TUXDIR}/include/tpadm.h、 ${TUXDIR}/udataobj/tpadm、

関連項目

tpacall(3c)、tpalloc(3c)、tpcall(3c)、tpdequeue(3c)、tpenqueue(3c)、tpgetrply(3c)、tprealloc(3c)、「FML関数の紹介」、Fadd, Fadd32(3fml)、Fchg、Fchg32(3fml)、Ffind、Ffind32(3fml)、MIB(5)、TM_MIB(5)

『Oracle Tuxedoアプリケーションの設定』

『C言語を使用したOracle Tuxedo ATMIアプリケーションのプログラミング』

『FMLを使用したTuxedoアプリケーションのプログラミング』

APPQ_MIB(5)

名前

APPQ_MIB - /Qの管理情報ベース

形式

#include <fml32.h>
#include <tpadm.h>

説明

/Q MIBは、アプリケーション・キューを管理できるクラスを定義します。

リクエストリクエストのフォーマットと管理応答の解釈を行うには、APPQ_MIB(5)を共通MIBリファレンス・ページMIB(5)と一緒に使用します。このリファレンス・ページで説明するクラスや属性を使用し、MIB(5)の説明に従ってフォーマットしたリクエストを使用すると、アクティブなアプリケーションの既存のATMIインタフェースの1つを通じて管理サービスをリクエストできます。非アクティブなアプリケーション内のアプリケーション・キューは、tpadmcall()関数インタフェースを使用して管理することもできます。APPQ_MIB(5)のすべてのクラス定義の追加情報については、「APPQ_MIB(5)に関する追加情報」を参照してください。

APPQ_MIB(5)は、次のクラスで構成されています。

このMIBが参照するのは、アプリケーション定義の永続的(信頼性の高いディスク・ベース)キューおよび一時的メッセージ(メモリー内)キュー(つまり、/Qキュー)であり、サーバー・キュー(TM_MIB(5)コンポーネントのT_QUEUEクラス)ではありません。

各クラスの説明セクションには、次の4つのサブセクションがあります。

概要

属性表

属性のセマンティクス

制限

属性表の形式

このMIBに含まれる各クラスは、4つの部分で記述されています。その1つが属性表です。属性表はクラス内の属性のリファレンス・ガイドであり、管理者、オペレータ、一般ユーザーがそれらの属性を使用してアプリケーションと対話するための方法を説明しています。

属性表の各属性の説明には、5つの構成要素(名前、型、許可、値、デフォルト値)があります。各要素については、MIB(5)を参照してください。

TA_FLAGS値

MIB(5)は、共通TA_FLAGS属性を定義します。この属性はlong型で、共通MIBフラグ値とコンポーネントMIB固有フラグ値の両方を持ちます。次のフラグの値はAPPQ_MIB(5)コンポーネントで定義されます。これらのフラグ値は、共通MIBフラグと一緒に使用する必要があります。

QMIB_FORCECLOSE

QMIB_FORCEDELETE

QMIB_FORCEPURGE

FML32フィールド表

このリファレンス・ページで説明する属性のフィールド表は、システムにインストールしたOracle Tuxedoソフトウェアのルート・ディレクトリからの相対パスで指定されるudataobj/tpadmファイルにあります。${TUXDIR}/udataobjディレクトリは、FLDTBLDIR環境変数で指定されるパス・リスト(Windowsの場合はセミコロン区切りのリスト、それ以外の場合はコロン区切りのリスト)にアプリケーションによって追加される必要があり、フィールド表名tpadmは、FIELDTBLS環境変数で指定されるカンマ区切りのリストに追加される必要があります。

制限

このMIBは、Oracle Tuxedo 6.0システム以降が実行されているサイト(ネイティブおよびWorkstationの両方)からのみアクセスできます。

Oracle Tuxedo 6.0より前のリリースが実行されているサイトがアプリケーション内でアクティブ化された場合、このMIBによる管理アクセスは次のとおり制限されます。

T_APPQクラスの定義

概要

T_APPQクラスは、アプリケーション・キューを表します。単一のアプリケーション・キュー・スペースに1つ以上のアプリケーション・キューが存在する可能性があります。

制限

すべてのキー・フィールドを未設定にすると、このクラスのインスタンスをすべて検索できません。反対に、1つのアプリケーション・キュー・スペースを明示的に指定するには、適切なキー・フィールドを用意する必要があります。これらの必須キー・フィールドはTA_APPQSPACENAME、TA_QMCONFIGおよびTA_LMIDです。ただし、アプリケーションが構成されていない場合(つまり、TUXCONFIG環境変数が設定されていない場合)は、TA_LMIDを省略する必要があります。たとえば、TA_APPQSPACENAME、TA_QMCONFIGおよびTA_LMID属性が、tpcall()を使用するリクエストに設定されると、指定されたキュー・スペース内のすべてのT_APPQオブジェクトが取得されます。

属性表

^a T_APPQクラスのすべての属性はローカル属性です。

^b アプリケーションが構成されていない(TUXCONFIG環境変数が設定されていない)場合を除き、TA_LMIDはキー・フィールドとして指定する必要があります。

^c T_APPQオブジェクトのすべての操作(GETとSETの両方)は、関連付けられているキュー・スペースを自動的に開きます。つまり、キュー・スペースの状態がOPEnまたはACTiveになっていない場合、暗黙的にOPEnに設定します。キュー・スペースが大きいと、この操作は時間がかかります。

^d アプリケーション・キューの作成後は、TA_APPQORDERを変更できません。

^e Oracle Tuxedo 8.0以前のリリースの場合、この属性の文字列の長さは最大78バイトです。

^f 1つのアプリケーション・キュー・スペースを明示的に指定するには、GET操作で適切なキー・フィールドを指定する必要があります。

属性のセマンティクス

TA_APPQNAME: string[1..127]

TA_APPQSPACENAME: string[1..15]

TA_QMCONFIG: string[1..78]

TA_LMID: string[1..30] (no comma)

TA_STATE:

TA_APPQORDER:

TA_CMD: shell-command-string[0..127]

TA_CMDHW: 0 <= num[bBm%]

TA_CMDLW: 0 <= num[bBm%]

TA_CMDNONPERSIST: shell-command-string[0..127]

TA_CMDNONPERSISTHW: 0 <= num[bB%]

TA_CMDNONPERSISTLW: 0 <= num[bB%]

TA_CURBLOCKS: 0 <= num

TA_CURMSG: 0 <= num

TA_DEFAULTEXPIRATIONTIME:

TA_DEFDELIVERYPOLICY:

TA_MAXRETRIES: 0 <= num

TA_OUTOFORDER: {NONE | TOP | MSGID}

TA_RETRYDELAY: 0 <= num

TA_CURNONPERSISTBYTES: 0 <= num

TA_CURNONPERSISTMSG: 0 <= num

T_APPQMSGクラスの定義

概要

T_APPQMSGクラスは、アプリケーション・キューに格納されているメッセージを表します。メッセージは管理者によって作成されるのではなく、tpenqueue()の呼出しの結果として生成されます。メッセージの破棄は、tpdequeue()の呼出しによって行うか、管理者によって行われます。また、管理者はメッセージの特定の属性を変更できます。たとえば、管理者は、同じキュー・スペース内のキュー間でメッセージを移動したり、メッセージの優先度を変更できます。

制限

すべてのキー・フィールドを未設定にすると、このクラスのインスタンスをすべて検索できません。反対に、1つのアプリケーション・キュー・スペースを明示的に指定するには、適切なキー・フィールドを用意する必要があります。これらの必須キー・フィールドはTA_APPQSPACENAME、TA_QMCONFIGおよびTA_LMIDです。ただし、アプリケーションが構成されていない場合(つまり、TUXCONFIG環境変数が設定されていない場合)は、TA_LMIDを省略する必要があります。たとえば、TA_APPQSPACENAME、TA_QMCONFIGおよびTA_LMID属性が、tpcall()を使用するリクエストに設定されると、指定されたキュー・スペース内のすべてのキューのすべてのT_APPQMSGオブジェクトが取得されます。

属性表

^aT_APPQMSGクラスのすべての属性はローカル属性です。

^bアプリケーションが構成されていない(TUXCONFIG環境変数が設定されていない)場合を除き、TA_LMIDはキー・フィールドとして指定する必要があります。

^c T_APPQMSGオブジェクトのすべての操作(GETとSETの両方)は、関連付けられているキュー・スペースを自動的に開きます。つまり、キュー・スペースの状態がOPEnまたはACTiveになっていない場合、暗黙的にOPEnに設定します。キュー・スペースが大きいと、この操作は時間がかかります。

^d1つのアプリケーション・キュー・スペースを明示的に指定するには、GET操作で適切なキー・フィールドを指定する必要があります。

属性のセマンティクス

TA_APPQMSGID: string[1..32]

TA_APPQNAME: string[1..127]

TA_APPQSPACENAME: string[1..15]

TA_QMCONFIG: string[1..78]

TA_LMID: string[1..30] (no comma)

TA_STATE:

TA_CURRETRIES: 0 <= num

TA_CORRID: string[0..32]

TA_EXPIRETIME:

TA_LOWPRIORITY: 1 <= num <= 100
TA_HIGHPRIORITY: 1 <= num <= 100

TA_MSGEXPIRESTARTTIME:
TA_MSGEXPIREENDTIME:

TA_MSGSIZE: 0 <= num

TA_MSGSTARTTIME:
TA_MSGENDTIME:

TA_NEWAPPQNAME: string[1..127]

TA_PERSISTENCE:

TA_PRIORITY: 1 <= num <= 100

TA_REPLYPERSISTENCE:

TA_TIME:

T_APPQSPACEクラスの定義

概要

T_APPQSPACEクラスはアプリケーション・キュー・スペースを表します。アプリケーション・キュー・スペースは、Oracle Tuxedoシステム・デバイス内の領域です。デバイスや属性の詳細は、TM_MIB(5)のT_DEVICEクラスを参照してください。各キュー・スペースには、通常は1つ以上のアプリケーション・キューが含まれます。各キューはメッセージを格納できます。

キュー・スペースは、複数の属性によって一意に識別されます。これには、名前(TA_APPQSPACENAME属性)、キュー・スペースが含まれるデバイス(TA_QMCONFIG属性)、およびデバイスが格納されている論理マシン(TA_LMID属性)があります。

通常、キュー・スペースは厳密に、構成済アプリケーション内の1つのサーバー・グループに関連付けられます。キュー・スペース名およびデバイス名は、T_GROUPオブジェクトのTA_OPENINFO属性のコンポーネントです。

制限

すべてのキー・フィールドを未設定にすると、このクラスのインスタンスをすべて検索できません。かわりに、3つのキー・フィールドすべてを指定して単一のアプリケーション・キュー・スペースを明示的に指定する必要があります。唯一の例外は、アプリケーションが構成されていない状況(TUXCONFIG環境変数が設定されていない状況)でtpadmcall()を介してローカル・キュー・スペースにアクセスする場合です。この場合、TA_LMIDキー・フィールドを省略する必要があります。

キュー・スペースのアクセス可能性に関する前述の制限は、T_APPQ、T_APPQMSGおよびT_APPQTRANSオブジェクトにも当てはまります。これは、/Q MIB内のすべてのオブジェクトに対する操作にキュー・スペースが暗黙的に関わるためです。

属性表

表9 APPQ_MIB(5): T_APPQSPACEクラス定義の属性表

属性a	型	パーミッション	値	デフォルト値
TA_APPQSPACENAME(k)(r)(*) TA_QMCONFIG(k)(r)(*) TA_LMID(k)(r)(*)b	string string string	ru-r--r-- ru-r--r-- ru-r--r--	string[1..15] string[1..78] string[1..30]	該当なし 該当なし 該当なし
TA_STATE(k)c	string	rwxrwxr--	GET: "{INA | INI | OPE | ACT}" SET: "{NEW | OPE | CLE | INV}"	N/A N/A
TA_BLOCKING TA_ERRORQNAME TA_FORCEINIT TA_IPCKEY(r) TA_MAXMSG(r) TA_MAXPAGES(r) TA_MAXPROC(r) TA_MAXQUEUES(r)d TA_MAXTRANS(r) TA_MAXACTIONS TA_MAXHANDLES TA_MAXOWNERS TA_MAXTMPQUEUES TA_MAXCURSORS TA_MEMNONPERSIST TA_MEMFILTERS TA_MEMOVERFLOW	long string string long long long long long long long long long long long string long long	rw-r--r-- rw-r--r-- rw-r--r-- rw-r--r-- rw-r--r-- rw-r--r-- rw-r--r-- rw-r--r-- rw-r--r-- rw-r--r-- rw-r--r-- rw-r--r-- rw-r--r-- rw-r--r-- rw-r--r-- rw-r--r-- rw-r--r--	0 <= num string[0..127] {Y | N} 32769 <= num <= 262143 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num[bB] 0 <= num 0 <= num	16 “” N 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 0 0 0 0 0 0 0 0
TA_MEMSYSTEMRESERVED TA_MEMTOTALALLOCATED	long long	r--r--r-- r--r--r--	0 <= num 0 <= num	該当なし 該当なし
TA_CUREXTENT TA_CURMSG TA_CURPROC TA_CURQUEUES TA_CURTRANS TA_CURACTIONS TA_CURHANDLES TA_CUROWNERS TA_CURTMPQUEUES TA_CURCURSORS TA_CURMEMNONPERSIST TA_CURMEMFILTERS TA_CURMEMOVERFLOW TA_HWMSG TA_HWPROC TA_HWQUEUES TA_HWTRANS TA_HWACTIONS TA_HWHANDLES TA_HWOWNERS TA_HWTMPQUEUES TA_HWCURSORS TA_HWMEMNONPERSIST TA_HWMEMFILTERS TA_HWMEMOVERFLOW TA_PERCENTINIT	long long long long long long long long long long long long long long long long long long long long long long long long long long	r--r--r-- r--r--r-- r--r--r-- r--r--r-- R--R--R-- r--r--r-- r--r--r-- r--r--r-- r--r--r-- r--r--r-- r--r--r-- r--r--r-- r--r--r-- R--R--R-- R--R--R-- R--R--R-- R--R--R-- R--R--R-- R--R--R-- R--R--R-- R--R--R-- R--R--R-- R--R--R-- R--R--R-- R--R--R-- r--r--r--	0 < num <= 36 { 0 <= num | -1 } 0 <= num { 0 <= num | -1 } 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num <= 100 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num 0 <= num	該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし 該当なし
( k ) — GETキー・フィールド ( r ) — オブジェクトの作成に必要なキー・フィールド ( * ) — 必要なSETキー・フィールド

a. T_APPQSPACEクラスの属性はすべてローカルです。

b.アプリケーションが構成されていない(TUXCONFIG環境変数が設定されていない)場合を除き、TA_LMIDはキー・フィールドとして指定する必要があります。

c. T_APPQ、T_APPQMSG、およびT_APPQTRANSオブジェクトのすべての操作(GETとSET)は、関連付けられているキュー・スペースを自動的に開きます。つまり、キュー・スペースの状態がOPEnまたはACTiveになっていない場合、暗黙的にOPEnに設定します。キュー・スペースが大きいと、この操作は時間がかかります。

d.キュー・スペースの作成後は、TA_MAXQUEUESを変更できません。

属性のセマンティクス

TA_APPQSPACENAME: string[1..15]

TA_QMCONFIG: string[1..78]

TA_LMID: string[1..30] (no comma)

TA_STATE:

TA_BLOCKING: 0 <= num

TA_CURACTIONS: 0 <= num

TA_CURCURSORS: 0 <= num

TA_CUREXTENT: 0 < num <= 36

TA_CURHANDLES: 0 <= num

TA_CURMEMFILTERS: 0 <= num

TA_CURMEMNONPERSIST: 0 <= num

TA_CURMEMOVERFLOW: 0 <= num

TA_CURMSG: 0 <= num

TA_CUROWNERS: 0 <= num

TA_CURPROC: 0 <= num

TA_CURQUEUES: 0 <= num

TA_CURTMPQUEUES: 0 <= num

TA_CURTRANS: 0 <= num

TA_ERRORQNAME: string[0..127]

TA_FORCEINIT: {Y | N}

TA_HWACTIONS: 0 <= num

TA_HWCURSORS: 0 <= num

TA_HWHANDLES: 0 <= num

TA_HWMEMFILTERS: 0 <= num

TA_HWMEMNONPERSIST: 0 <= num

TA_HWMEMOVERFLOW: 0 <= num

TA_HWMSG: 0 <= num

TA_HWOWNERS: 0 <= num

TA_HWPROC: 0 <= num

TA_HWQUEUES: 0 <= num

TA_HWTMPQUEUES: 0 <= num

TA_HWTRANS: 0 <= num

TA_IPCKEY: 32769 <= num <= 262143

TA_MAXACTIONS: 0 <= num

TA_MAXCURSORS: 0 <= num

TA_MAXHANDLES: 0 <= num

TA_MAXMSG: 0 <= num

TA_MAXOWNERS: 0 <= num

TA_MAXPAGES: 0 <= num

TA_MAXPROC: 0 <= num

TA_MAXQUEUES: 0 <= num

TA_MAXTMPQUEUES: 0 <= num

TA_MAXTRANS: 0 <= num

TA_MEMFILTERS: 0 <= num

TA_MEMNONPERSIST: 0 <= num [bB]

TA_MEMOVERFLOW: 0 <= num

TA_MEMSYSTEMRESERVED: 0 <= num

TA_MEMTOTALALLOCATED: 0 <= num

TA_PERCENTINIT: 0 <= num <= 100

T_APPQTRANSクラスの定義

概要

T_APPQTRANSクラスは、アプリケーション・キューに関連付けられるトランザクションの実行時属性を表します。

制限

すべてのキー・フィールドを未設定にすると、このクラスのインスタンスをすべて検索できません。反対に、1つのアプリケーション・キュー・スペースを明示的に指定するには、適切なキー・フィールドを指定する必要があります。たとえば、tpcall()を使用して、TA_XIDを除くすべてのキー・フィールドをリクエストで設定した場合、指定されたキュー・スペースに対応するT_APPQTRANSオブジェクトがすべて検索されます。

このクラスのオブジェクトで表現されるトランザクションは必ずしも検索対象のアプリケーションに関連付けられないので注意してください。トランザクションは実際には別のアプリケーションに属していたり、別のアプリケーションに影響を与えたりする場合があるため、トランザクションをヒューリスティックにコミットまたは中断するときには注意が必要です。TA_XID属性の値は、アプリケーション間でユニークであるとはかぎりません。

属性表

a. T_APPQTRANSクラスのすべての属性はローカル属性です。

b. T_APPQTRANSオブジェクトのすべての操作(GETとSETの両方)は、関連付けられているキュー・スペースを自動的に開きます。つまり、キュー・スペースの状態がOPEnまたはACTiveになっていない場合、暗黙的にOPEnに設定します。キュー・スペースが大きいと、この操作は時間がかかります。

c. 1つのアプリケーション・キュー・スペースを明示的に指定するには、GET操作で適切なキー・フィールドを指定する必要があります。

属性のセマンティクス

TA_XID: string[1..78]

TA_APPQSPACENAME: string[1..15]

TA_QMCONFIG: string[1..78]

TA_LMID: string[1..30] (no comma)

TA_STATE:

APPQ_MIB(5)に関する追加情報

移植性

Oracle TuxedoシステムのMIBを使用した管理作業をサポートするために必要な既存のFML32およびATMI関数、さらにこのリファレンス・ページに定義するヘッダー・ファイルとフィールド表は、すべてのサポート対象ネイティブ・プラットフォームとワークステーション・プラットフォームで使用可能です。

相互運用性

このMIBは、Oracle Tuxedo 6.0以降が実行されているサイト(ネイティブおよびWorkstationの両方)からのみアクセスできます。

Oracle Tuxedo 6.0より前のリリースが実行されているサイトがアプリケーション内でアクティブ化された場合、このMIBによる管理アクセスは次のとおり制限されます。

リリースが異なるサイト(共にリリース6.0以降)を相互運用する場合、当該リリースのMIBリファレンス・ページに定義されるように、旧サイト上の情報はアクセスおよび更新可能で、以降のリリースで利用可能な情報のサブセットとなります。

サンプル

以下に、アプリケーション・キュー・スペース、キュー、メッセージ、およびトランザクションに対する各種操作の実行方法を示すコードを示します。

各コードの前には、次のように、FML32型付きバッファを割り当てるコードを追加してください。

rqbuf = tpalloc("FML32", NULL, 0);

バッファにデータを入力したら、各コードの後には、次のような、リクエストを送信し、応答を受信するコードを追加します。

flags = TPNOTRAN | TPNOCHANGE | TPSIGRSTRT;
rval = tpcall(".TMIB", rqbuf, 0, rpbuf, rplen, flags);

詳細は、MIB(5)を参照してください。

フィールド表

属性フィールド識別子にアクセスするには、フィールド表tpadmが必要です。そのためには、次のようにシェルで入力します。

$ FIELDTBLS=tpadm 
$ FLDTBLDIR=${TUXDIR}/udataobj
$ export FIELDTBLS FLDTBLDIR

ヘッダー・ファイル

次のヘッダー・ファイルが必要です。

#include <atmi.h> 
#include <fml32.h>
#include <tpadm.h>

ライブラリ

${TUXDIR}/lib/libtmib.a, ${TUXDIR}/lib/libqm.a, ${TUXDIR}/lib/libtmib.so.<rel>, ${TUXDIR}/lib/libqm.so.<rel>, ${TUXDIR}/lib/libqm.lib

buildclientを使用するときには、ライブラリを手動でリンクする必要があります。この場合は、-L${TUXDIR}/lib -ltmib -lqmを指定する必要があります。

アプリケーション・キュー・スペースの作成

通常、アプリケーション・キュー・スペースを作成するには2つの操作が必要です。最初の操作ではキュー・スペースを割り当てるOracle Tuxedoシステム・デバイスを作成し、次の操作ではキュー・スペース自体を作成します。

/* Allocate the buffer; see above */ 
 
/* Build the request to create a new device on SITE1 */
Fchg32(rqbuf, TA_OPERATION, 0, "SET", 0);
Fchg32(rqbuf, TA_CLASS, 0, "T_DEVICE", 0);
Fchg32(rqbuf, TA_STATE, 0, "NEW", 0);
Fchg32(rqbuf, TA_CFGDEVICE, 0, "/dev/q/dsk001", 0);
Fchg32(rqbuf, TA_LMID, 0, "SITE1", 0);
size = 500;
Fchg32(rqbuf, TA_DEVSIZE, 0, (char *)size, 0);
 
/* Make the request; see above */
 
/* Reinitialize the same buffer for reuse */
Finit32(rqbuf, (FLDLEN) Fsizeof32(rqbuf));
 
/* Build the request to create the queue space */
Fchg32(rqbuf, TA_OPERATION, 0, "SET", 0);
Fchg32(rqbuf, TA_CLASS, 0, "T_APPQSPACE", 0);
Fchg32(rqbuf, TA_STATE, 0, "NEW", 0);
Fchg32(rqbuf, TA_APPQSPACENAME, 0, "QSPACE1", 0);
Fchg32(rqbuf, TA_QMCONFIG, 0, "/dev/q/dsk001", 0);
Fchg32(rqbuf, TA_LMID, 0, "SITE1", 0);
Fchg32(rqbuf, TA_ERRORQNAME, 0, "errque", 0);
ipckey = 123456;
Fchg32(rqbuf, TA_IPCKEY, 0, (char *)ipckey, 0);
maxmsg = 100;
Fchg32(rqbuf, TA_MAXMSG, 0, (char *)maxmsg, 0);
maxpages = 200;
Fchg32(rqbuf, TA_MAXPAGES, 0, (char *)maxpages, 0);
maxproc = 50;
Fchg32(rqbuf, TA_MAXPROC, 0, (char *)maxproc, 0);
maxqueues = 10;
Fchg32(rqbuf, TA_MAXQUEUES, 0, (char *)maxqueues, 0);
maxtrans = 100;
Fchg32(rqbuf, TA_MAXTRANS, 0, (char *)maxtrans, 0);
 
/* Make the request; see above */

アプリケーション・キュー・スペースへのキューの追加

以下のコードでは、上の例で作成したキュー・スペースに新しいキューを作成します。

/* Build the request */ 
Fchg32(rqbuf, TA_OPERATION, 0, "SET", 0);
Fchg32(rqbuf, TA_CLASS, 0, "T_APPQ", 0);
Fchg32(rqbuf, TA_STATE, 0, "NEW", 0);
Fchg32(rqbuf, TA_APPQNAME, 0, "errque", 0);
Fchg32(rqbuf, TA_APPQSPACENAME, 0, "QSPACE1", 0);
Fchg32(rqbuf, TA_QMCONFIG, 0, "/dev/q/dsk001", 0);
Fchg32(rqbuf, TA_LMID, 0, "SITE1", 0);
Fchg32(rqbuf, TA_APPQORDER, 0, "PRIO", 0);
 
/* Make the request; see above */

アプリケーションが認識しているアプリケーション・キュー・スペースの表示

アプリケーションが認識しているアプリケーション・キュー・スペースを表示するには、2段階の検索を行います。まず、/Qトランザクション・マネージャTMS_QMを使用するグループがアプリケーション環境設定から検索され、次に各グループが参照しているキュー・スペースが検索されます。以下のコードは、キュー・スペースを使用する各GROUPエントリに1つの論理マシンが関連付けられていると仮定します(つまり、サーバー移行は未使用)。

/* Build the request to retrieve all TMS_QM groups */
Fchg32(rqbuf, TA_OPERATION, 0, "GET", 0);
Fchg32(rqbuf, TA_CLASS, 0, "T_GROUP", 0);
Fchg32(rqbuf, TA_TMSNAME, 0, "TMS_QM", 0);
fldid1 = TA_OPENINFO;
fldid2 = TA_LMID;
Fchg32(rqbuf, TA_FILTER, 0, (char *)fldid1, 0);
Fchg32(rqbuf, TA_FILTER, 0, (char *)fldid2, 1);
 
/* Make the request, assuming we are joined to the application */
rval = tpcall(".TMIB", rqbuf, 0, rpbuf, rplen, flags);
 
/* For each TMS_QM group, build the request to retrieve its queue space */
rval = Fget32(*rpbuf, TA_OCCURS, 0, (char *)occurs, NULL);
for (i = 0; i occurs; i++) {
 
 
  /* Reinitialize the buffer and set all common attributes */
  Finit32(rqbuf, (FLDLEN) Fsizeof32(rqbuf));
  Fchg32(rqbuf, TA_OPERATION, 0, "GET", 0);
  Fchg32(rqbuf, TA_CLASS, 0, "T_APPQSPACE", 0);
 
  /* Get the OPENINFO to determine device and queue space name */
  /* OPENINFO has the format <resource-mgr>:<qmconfig>:<appqspacename> */
  /* or on Windows <resource-mgr>:<qmconfig>;<appqspacename> */
  rval = Fget32(rpbuf, TA_OPENINFO, i, openinfo, NULL);
 
  /* The device is the 2nd field in OPENINFO */
  qmconfig = strchr(openinfo, ':') + 1;
  /* The queue space name is the 3rd field in OPENINFO */
 
#if defined(_TMDOWN) || defined(_TM_NETWARE)
#define pathsep ";" /* separator for PATH */
#else
#define pathsep ":" /* separator for PATH */
#endif
  appqspacename = strchr(qmconfig, pathsep);
  appqspacename[0] = '\e0'; /* NULL-terminate qmconfig */
  appqspacename++; /* bump past the NULL */
 
  /* Set the APPQSPACENAME and QMCONFIG keys */
  Fchg32(rqbuf, TA_APPQSPACENAME, 0, appqspacename, 0);
  Fchg32(rqbuf, TA_QMCONFIG, 0, qmconfig, 0);
 
  /* Get the LMID (assume no migration for this group) */
  rval = Fget32(rpbuf, TA_LMID, i, lmid, NULL);
  Fchg32(rqbuf, TA_LMID, 0, lmid, 0);
 
  /* Make the request */
  rval = tpcall(".TMIB", rqbuf, 0, rpbuf2, rplen2, flags);
}

上記のコードでは、キュー・スペースが作成されていても、アプリケーションの構成に対応するGROUPエントリがないと、キュー・スペースは検索されません。このようなキュー・スペースは、キュー・スペースのキー・フィールド(TA_APPQSPACENAME、TA_QMCONFIG、およびTA_LMID)の優先順位が分かっていなければ検索できません。

アプリケーション・キュー内のメッセージの表示

次のコードは、論理マシンSITE1上のデバイス/dev/q/dsk001のキュー・スペースQSPACE1のキューSTRINGのすべてのメッセージを取得します。

/* Build the request */ Fchg32(rqbuf, TA_OPERATION, 0, "GET", 0);
Fchg32(rqbuf, TA_CLASS, 0, "T_APPQMSG", 0);
Fchg32(rqbuf, TA_APPQNAME, 0, "STRING", 0);
Fchg32(rqbuf, TA_APPQSPACENAME, 0, "QSPACE1", 0);
Fchg32(rqbuf, TA_QMCONFIG, 0, "/dev/q/dsk001", 0);
Fchg32(rqbuf, TA_LMID, 0, "SITE1", 0);
/* Make the request; see above */

キュー・スペースを使用するトランザクションの表示

以下のコードでは、キュー・スペースQSPACE1の中の任意のキューを使用するトランザクションをすべて検索します。

/* Build the request */ Fchg32(rqbuf, TA_OPERATION, 0, "GET", 0);
Fchg32(rqbuf, TA_CLASS, 0, "T_APPQTRANS", 0);
Fchg32(rqbuf, TA_APPQSPACENAME, 0, "QSPACE1", 0);
Fchg32(rqbuf, TA_QMCONFIG, 0, "/dev/q/dsk001", 0);
Fchg32(rqbuf, TA_LMID, 0, "SITE1", 0);
/* Make the request; see above */

ファイル

${TUXDIR}/include/tpadm.h
${TUXDIR}/udataobj/tpadm

関連項目

tpacall(3c)、tpadmcall(3c)、tpalloc(3c)、tpcall(3c)、tpdequeue(3c)、tpenqueue(3c)、tpgetrply(3c)、tprealloc(3c)、「FML関数の紹介」、Fadd、Fadd32(3fml)、Fchg、Fchg32(3fml)、Ffind、Ffind32(3fml)、MIB(5)、TM_MIB(5)

『Oracle Tuxedoアプリケーションの設定』

『Oracle Tuxedoアプリケーション実行時の管理』

『C言語を使用したOracle Tuxedo ATMIアプリケーションのプログラミング』

『FMLを使用したTuxedoアプリケーションのプログラミング』

AUTHSVR(5)

名前

AUTHSVR - ユーザーごとに認証を行うサーバー

形式

AUTHSVR SRVGRP="identifier" SRVID=number other_parms CLOPT="-A"

説明

AUTHSVRは、Oracle Tuxedoに用意されている、認証サービスを備えたサーバーです。このサーバーを保護されたアプリケーションで使用することにより、クライアントがアプリケーションに参加するときにユーザー単位の認証を行うことができます。このサーバーは、アプリケーションへのアクセスをリクエストしているクライアント・プロセスのためのTPINIT型付きバッファを含むサービス・リクエストを受け付けます。TPINIT型付きバッファのデータ・フィールドをユーザーのパスワードとして使用し、そのパスワードを設定済パスワードと比較することにより、リクエストの妥当性をチェックします。リクエストが妥当であると認められると、クライアントが使用するためのチケットとしてアプリケーション・キーが返されます。

アプリケーション・キーの設定には、tpreturn(3c)のrcodeパラメータが使用されます。このパラメータは、検証に合格するか、パーミッションが拒否されたときに、tpinit(3c)を呼び出したコードに(tpurcodeで)返されます。

AUTHSVRの詳細は、「AUTHSVRに関する追加情報」を参照してください。

SECURITY USER_AUTH

SECURITYがUSER_AUTHに設定されている場合は、強制的にユーザー単位での認証が実行されます。UBBCONFIGファイルのRESOURCESセクションのAUTHSVCパラメータを使用して、アプリケーションに対する認証サービスの名前を設定することができます。たとえば、次のAUTHSVCパラメータ設定では、SECURITYがUSER_AUTHに設定されている場合にAUTHSVRによって公開されるサービス(AUTHSVC)が指定されます。

*RESOURCES
SECURITY   USER_AUTH
AUTHSVC    AUTHSVC

AUTHSVCパラメータを設定しない場合、認証サービスはデフォルトによってAUTHSVCとなります。

デフォルトでは、アプリケーションのAPPDIR変数で定義される最初のパス名で参照されるディレクトリのファイルtpusrはパスワード情報の検索に使用されますが、このファイルが存在しない場合は/etc/passwdが使用されます。ただし、このファイルはシャドウ・パスワード・ファイルを使用しているシステムでは正しく使用できません。ファイルは、サーバーのコマンドライン・オプションの"-f filename"オプションでファイル名を指定することによってオーバーライドすることができます(例、CLOPT="-A -- -f /usr/tuxedo/users")。マスター・マシンから構成で指定された他のマシンへのユーザー・ファイルの自動伝播は、$APPDIR/tpusrを使用した場合にのみ実行されます。

ユーザー・ファイルでは、(与えられた名前と)一致するユーザー名とクライアント名が検索されます。ユーザー・ファイルには、4つのタイプのエントリがあります。これらをユーザーの妥当性検査を行う際の一致の優先度の順に並べると、次のようになります。

認証リクエストは、最初に一致するパスワード・ファイルのエントリに対してのみ認証されます。これらのセマンティクスを使用すれば、同じユーザーが(通常異なるクライアント名の)複数のエントリ名を持つことができ、ユーザー名にワイルドカードを使用できます。これらのセマンティクスを使用できるのは、tpaddusr()、tpdelusr()、およびtpmodusr()を利用してユーザー・ファイルを管理する場合です。ただし、これらのセマンティクスを使用した場合、ACLとMANDATORY_ACLのセマンティクスとの互換性はなく、これらのセキュリティ・レベルへの移行は困難になります。ACLセキュリティとの互換性のため制限的なセマンティクスを得るには、tpusradd()、tpusrdel()、およびtpusrmod()の各プログラムを利用してユーザー・ファイルを管理する必要があります。

認証リクエストを処理する際には、特殊なクライアント名の値、つまりtpsysadm (システム管理者)とtpsysop (システム・オペレータ)はAUTHSVR(5)によって特別に扱われます。これらの値は、ユーザー・ファイルのワイルドカードを利用したクライアント名と一致させることはできません。

AUTHSVRによって返されるアプリケーション・キーは、ユーザーIDです。このアプリケーション・キーは、TPSVCINFOというデータ構造のappkey要素に含まれるすべてのサービスに渡されます。

標準仕様のAUTHSVRは、システムの一部として${TUXDIR}/bin/AUTHSVRに格納された状態で出荷され、上記で説明したセマンティクスを持っています。ソース・コードのサンプルは、${TUXDIR}/lib/AUTHSVR.cに収められています。AUTHSVRのかわりに、(Kerberosなどを利用して)それぞれのアプリケーションに適した方法でユーザーやユーザー・データ(パスワードは不可)の妥当性を検査するアプリケーション認証サーバーを使用することができます。AUTHSVRのかわりに他のアプリケーション認証サーバーを使用する場合、このリファレンス・ページで後述する警告に特に留意してください。また、使用する認証サービスが(それぞれのサービスに渡す)アプリケーション・キーとして返す値も、それぞれのアプリケーションによって異なります。

tpsysadmとtpsysopに対応するアプリケーション・キーは、それぞれ0x80000000と0xC0000000です。

SECURITY ACLまたはMANDATORY_ACL

SECURITYがACLまたはMANDATORY_ACLに設定されている場合、ユーザー単位の認証が強制的に実行され、サービスや、アプリケーションのキュー、イベントにアクセスするためのアクセス制御リストがサポートされます。UBBCONFIGファイルのRESOURCESセクションのAUTHSVCパラメータを使用して、アプリケーションに対する認証サービスの名前を設定することができます。たとえば、次のAUTHSVCパラメータ設定では、SECURITYがACLまたはMANDATORY_ACLに設定されている場合にAUTHSVRによって公開されるサービス(..AUTHSVC)が指定されます。

*RESOURCES
SECURITY   ACL
AUTHSVC    ..AUTHSVC

AUTHSVCパラメータを設定しない場合、認証サービスはデフォルトによって..AUTHSVCとなります。

ユーザー・ファイルは、$APPDIR/tpusrでなければなりません。このファイルは、マスター・マシンから構成で指定された他のアクティブ・マシンに自動的に伝播されます。マスター・マシンでは、AUTHSVRの1つのインスタンスが実行されている必要があります。構成で指定された別のアクティブ・マシンでは、追加のコピーを実行できます。

ユーザー・ファイルでは、(与えられた名前と)一致するユーザー名とクライアント名が検索されます。ユーザー名は、ユーザー・ファイルのエントリと正確に一致している必要があります。クライアント名は正確に一致している必要がありますが、代替手段としてユーザー・ファイルのクライアント名の値をあらゆるクライアント名に該当するワイルドカード(*)として指定する方法も利用できます。ユーザー・ファイルのエントリは1人のユーザーにつき1つだけで、ユーザー名にワイルドカードを使用することはできません。ユーザー・ファイルは、tpusradd()、tpusrdel()、およびtpusrmod()の各プログラム、グラフィカル・ユーザー・インタフェース、または管理インタフェースを使用して管理できます。

認証リクエストを処理する際には、特殊なクライアント名の値、つまりtpsysadm (システム管理者)とtpsysop (システム・オペレータ)はAUTHSVR(5)によって特別に扱われます。これらの値は、ユーザー・ファイルのワイルドカードを利用したクライアント名と一致させることはできません。

AUTHSVRによって返されるアプリケーション・キーは、下位17ビットのユーザーIDと、それに続く14ビットのグループIDで構成されます(上位ビットは管理キーとして予約されています)。tpsysadmとtpsysopに対応するアプリケーション・キーは、それぞれ0x80000000と0xC0000000です。このアプリケーション・キーは、TPSVCINFOというデータ構造のappkey要素に含まれるすべてのサービスに渡されます。

SECURITY ACLまたはMANDATORY_ACLの場合、システムの一部として${TUXDIR}/bin/AUTHSVRに収められているAUTHSVRを使用する必要があります。

AUTHSVRに関する追加情報

使用方法

移植性

AUTHSVRは、Oracle Tuxedoに付属のサービスとして非Workstationプラットフォームでサポートされます。

サンプル

# Using USER_AUTH
*RESOURCES
SECURITY  USER_AUTH
AUTHSVC   AUTHSVC

*SERVERS 
AUTHSVR SRVGRP="AUTH" CLOPT="-A -- -f /usr/tuxedo/users" \
 SRVID=100 RESTART=Y GRACE=0 MAXGEN=2
#
#
# Using ACLs
*RESOURCES
SECURITY  ACL
AUTHSVC   ..AUTHSVC

*SERVERS
AUTHSVR SRVGRP="AUTH" SRVID=100 RESTART=Y GRACE=0 MAXGEN=2
#
#
# Using a custom authentication service
*RESOURCES
SECURITY  USER_AUTH
AUTHSVC   KERBEROS

*SERVERS
KERBEROSSVR SRVGRP="AUTH1" SRVID=100 RESTART=Y GRACE=0 MAXGEN=2

関連項目

tpaddusr(1)、tpusradd(1)、UBBCONFIG(5)

『Oracle Tuxedoアプリケーションの設定』

『Oracle Tuxedoアプリケーション実行時の管理』

『C言語を使用したOracle Tuxedo ATMIアプリケーションのプログラミング』

Accesslog(5)

名前

Accesslog(5) - Tuxedoクライアントの有効性のモニター

説明

Accesslog(5)は、クライアントのログイン/ログオフ・アクションをタイムスタンプと場所情報とともに記録するのに役立ちます。それはアクセス・ログを作成し、Tuxedo ULOGファイルに1行追加します。詳細は、「使用例」および「ULOGファイル・エントリ」を参照してください。

Accesslogは、24時間ごとに新しいファイルをアクセス・ログ・ファイルに自動生成します。アクセス・ログの出力ファイルは、以下の形式で生成されます。

hhmmss.uname!pname.pid.tid.ctx: total client ($currentclientcount), $event: $protocol [IP ($clientip)] cltname ($clientname) [usrname ($username)] success.

$currentclientcount = numeric_value

$event = enum_value

$protocol = enum_value

$clientip = string_value

$clientname = string_value

$username = string_value

サンプル

リスト2は、Accesslogのファイル出力の例を示しています。

112749.ubuntu!?proc.31212.3079091888.0: total client (2), logon: NATIVE cltname () success
112749.ubuntu!?proc.31212.3079091888.0: total client (2), logoff: NATIVE cltname () success
112749.ubuntu!WSH.31211.3078347248.0: total client (2), logon: /WS IP (//127.0.1.1:39224), cltname () success
112749.ubuntu!WSH.31211.3078347248.0: total client (2), logoff: /WS IP (//127.0.1.1:39224), cltname () success

ULOGファイル・エントリ

ULOGの各ログ・エントリのヘッダーには、最大クライアント数が自動的に記録されます。

ULOG出力ファイルには、以下の形式の行が挿入されます。

hhmmss.uname!pname.pid.tid.ctx: mm-dd-yyyy: client high water ($highwater), total client ($currentclientcount)

リスト3は、Accesslog(5)の行が追加されたULOGファイルの例を示しています。

145622.ubuntu!tmloadcf.4568.3079399872.-2: 12-17-2008: client high water (0), total client (0)

/*Not Printed by BBL*/
145625.ubuntu!tmloadcf.4568.3079399872.-2: 12-17-2008: client high water (), total client ()

$highwater = numeric-value

$currentclientcount = numeric-value

環境変数

以下の環境変数を設定およびエクスポートします。

ALOGPFX

ALOGRTNSIZE=numeric_value

compilation(5)

名前

compilation - Oracle Tuxedo ATMIシステムのアプリケーション・コンポーネントのコンパイル命令

説明

アプリケーションのクライアントとサーバー、およびOracle Tuxedoシステムにリンクされているサブルーチンをコンパイルする場合、プログラマは以下のことを知っておく必要があります。

コード・モジュールの記述が済み、実行可能プログラムを構築する準備が整ったプログラマは、以下の作業を行う必要があります。

Oracle Tuxedoシステムには、この両方の操作をクライアント・モジュールとサーバー・モジュールで実行するための2つのコマンド、buildclient()とbuildserver()が用意されています。いずれかのコマンドを実行して両方の操作を実行する場合、ファイルをリンクするためのライブラリを必ずコマンドラインで指定してください(詳細については、『Tuxedoコマンド・リファレンス』の「buildclient(1)」および「buildserver(1)」を参照)。

リンクを行うにはbuildclientまたはbuildserverを実行する必要がありますが、より柔軟なコンパイル方法も用意されています。必要に応じて、自分が選択したコンパイル・コマンドを使用してファイルをコンパイルし、次にbuildclientまたはbuildserverを実行してリンク編集を行うこともできます。

このリファレンス・ページの残りの部分では、各種のプログラムで必要なヘッダー・ファイルと環境変数を示します。

基本的なOracle Tuxedoシステム

ヘッダー・ファイルの順序の観点から、UNIXヘッダー・ファイルは常に任意のOracle Tuxedoシステムのヘッダー・ファイルの前にインクルードされる必要があります。一般的に使用されるUNIXヘッダー・ファイルは、stdio.hおよびctype.hです。

環境変数

以下の環境変数を設定およびエクスポートします。

TUXDIR

PATH

ULOGPFX

共有ライブラリを使用してシステムが構築された場合、クライアントを実行する前に、共有ライブラリの位置を定義する環境変数を設定する必要があります。

FMLプログラム

FML関数を呼び出すCプログラムには、以下のヘッダー・ファイルをここに示す順序でインクルードします。

#include <UNIX_header_files> (if needed by the application)
#include "fml.h"

FMLプログラムのコンパイル

FMLの関数を含むプログラムをコンパイルするには、次のようにコマンドを実行します。

cc pgm.c -I $TUXDIR/include -L $TUXDIR/lib -lfml -lengine -o pgm

ここで、pgmは実行可能ファイルの名前です。

-Lオプションがローカルでサポートされていない場合、かわりに次のコマンドを使用します。

cc pgm.c -I $TUXDIR/include $TUXDIR/lib/libfml.a $TUXDIR/lib/libengine.a -o pgm

FML VIEWSのコンパイル

FML VIEWコンパイラを使用するには、次のようにコマンドを実行します。

viewc view_file

ここでview_fileは、VIEW用のソース記述が格納されている1つまたは複数のファイルです。

FMLの環境変数

FMLを使用するアプリケーションを実行するときは、以下の環境変数を設定してエクスポートします。

FIELDTBLS

FLDTBLDIR

viewcを実行する場合、以下の環境変数を設定およびエクスポートします。

FIELDTBLS

FLDTBLDIR

VIEWDIR

関連項目

buildclient(1)、buildserver(1)、viewc、viewc32(1)
UNIXシステムのリファレンス・マニュアルのcc(1)、mc(1)

DMADM(5)

名前

DMADM - ドメイン管理サーバー

形式

DMADM SRVGRP = "identifier"
SRVID = "number" 
REPLYQ = "N"

説明

Domains管理サーバー(DMADM)は、BDMCONFIGファイルに実行時にアクセスするためのOracle Tuxedoシステム提供のサーバーです。

DMADMは、DMADMGRPなどのグループ内で動作するサーバーとして、UBBCONFIGのSERVERSセクションで記述されます。このグループ内で動作するDMADMは1つだけで、応答キューが存在していてはいけません(REPLYQをNに設定する必要があります)。

SERVERSセクションでは、DMADMサーバーのパラメータとして、SEQUENCE、ENVFILE、MAXGEN、GRACE、RESTART、RQPERM、およびSYSTEM_ACCESSも指定できます。

BDMCONFIG環境変数は、バイナリ形式のDMCONFIGファイルが入っているファイルのパス名に設定する必要があります。

移植性

DMADMは、サポートされているすべてのサーバー・プラットフォームでOracle Tuxedoシステム提供のサーバーとしてサポートされます。

相互運用性

DMADMは、Oracle Tuxedoリリース5.0以降にインストールする必要があります。リリース5.0のゲートウェイが存在するドメイン内の他のマシンの場合は、リリース4.1以降でも構いません。

サンプル

次の例は、UBBCONFIGファイルで管理サーバーとゲートウェイ・グループを定義する方法を示しています。この例では、GWTDOMAINゲートウェイ・プロセスを使用して別のOracle Tuxedoドメインと通信します。

#
*GROUPS
DMADMGRP LMID=mach1 GRPNO=1
gwgrp    LMID=mach1 GRPNO=2
#
*SERVERS 
DMADM SRVGRP="DMADMGRP" SRVID=1001 REPLYQ=N RESTART=Y GRACE=0
GWADM SRVGRP="gwgrp" SRVID=1002 REPLYQ=N RESTART=Y GRACE=0
GWTDOMAIN SRVGRP="gwgrp" SRVID=1003 RQADDR="gwgrp" REPLYQ=Y RESTART=Y MIN=1 MAX=1

関連項目

dmadmin(1)、tmboot(1)、DMCONFIG(5)、GWADM(5)、servopts(5)、UBBCONFIG(5)

『Oracle Tuxedoアプリケーションの設定』

『Oracle Tuxedoアプリケーション実行時の管理』

『ATMIアプリケーションでのOracle Tuxedo TOP END Domain Gatewayの使用』

DMCONFIG(5)

名前

DMCONFIG - テキスト形式のDomains構成ファイル

説明

Domains構成は、Oracle Tuxedo Domainsコンポーネントを使用して通信およびサービス共有を行うことができる2つ以上のドメイン(ビジネス・アプリケーション)の集まりです。複数のドメインを接続する方法や複数のドメイン間で相互にアクセスできるサービスについては、Domains構成に参加する各Oracle TuxedoドメインのDomains構成ファイルで定義されます。テキスト形式のDomains構成ファイルはDMCONFIGと呼ばれますが、ファイルの内容がこのリファレンス・ページで説明する形式に従っているかぎり、任意の名前を付けることができます。

DMCONFIGファイルは、dmloadcf(1)ユーティリティによって構文解析され、バイナリ形式のファイルBDMCONFIGにロードされます。DMCONFIGファイルと同様、BDMCONFIGファイルがどのような名前であっても、実際の名前はBDMCONFIG環境変数で指定されたデバイス・ファイル名またはシステム・ファイル名になります。BDMCONFIGファイルは、Domains構成に参加するTuxedoドメインごとに1つ必要です。

DMCONFIGファイルとBDMCONFIGファイルの関係は、Oracle Tuxedoドメインの定義に使用されるUBBCONFIGファイルとTUXCONFIGファイルの関係に似ています。UBBCONFIGファイルとTUXCONFIGファイルについては、UBBCONFIG(5)を参照してください。

DMCONFIGファイルの詳細(例を含む)については、「DMCONFIG(5)に関する追加情報」を参照してください。ATMIとCORBAの両環境向けのOracle Tuxedo Domainsコンポーネントについては、「Oracle Tuxedo Domainsコンポーネント」を参照してください。

用語の定義

Oracle Tuxedoドメインは、単一のTUXCONFIGファイルに記述された環境として定義されます。Oracle Tuxedo用語では、ドメインとアプリケーション(ビジネス・アプリケーション)は同義です。

Domains構成に含まれる各Oracle Tuxedoドメインでは、1つのDomains管理サーバー (DMADM)プロセスが実行されます。DMADMは、特定のOracle Tuxedoドメインで実行されるすべてのドメイン・ゲートウェイ・グループ用の管理サーバーです。

ドメイン・ゲートウェイ・グループは、Oracle Tuxedoシステムのゲートウェイ管理サーバー (GWADM)プロセスとOracle Tuxedoシステムのドメイン・ゲートウェイ・プロセスで構成されます。

Oracle Tuxedoシステムのドメイン・ゲートウェイ・プロセスは、特定のタイプのトランザクション処理(TP)ドメインとの通信サービスを提供します。たとえば、GWTDOMAINプロセスを使用すると、Oracle Tuxedoアプリケーションは他のOracle Tuxedoアプリケーションと通信できます。ドメイン・ゲートウェイは、別のドメインへのリクエストを中継し、応答を受信します。

ローカル・ドメイン・アクセス・ポイントは、他のドメイン(リモート・ドメイン)が使用できるOracle Tuxedoドメインの一連のサービスを表すユーザー指定の論理名です。ローカル・ドメイン・アクセス・ポイントはドメイン・ゲートウェイ・グループにマップされるため、どちらも同義語として使用されます。

リモート・ドメイン・アクセス・ポイントは、ローカル・ドメインが使用できるリモート・ドメインの一連のサービスを表すユーザー指定の論理名です。リモート・ドメインは、別のOracle Tuxedoアプリケーションまたは別のTPシステムで動作するアプリケーションです。

リモート・サービスは、ローカル・ドメインがリモート・ドメイン・アクセス・ポイントとローカル・ドメイン・アクセス・ポイントを介して使用できるリモート・ドメインのサービスです。

ローカル・サービスは、リモート・ドメインがローカル・ドメイン・アクセス・ポイントを介して使用できるローカル・ドメインのサービスです。

構成ファイルの目的

DMCONFIGファイルは、次の目的で使用します。

構成ファイルの形式

DMCONFIGファイルは、次のセクションで構成されます。

DMCONFIGファイル内のアスタリスク(*)で始まる行は、指定セクションの開始を表します。アスタリスク(*)の直後にはセクション名が表示されます。アスタリスクは、セクション名を指定するときに必要です。DM_LOCALセクションは、DM_REMOTEセクションの前になければなりません。

このリファレンス・ページでは、GWTDOMAINゲートウェイ・プロセスによって実装されるTDOMAIN (TDomainゲートウェイ)を構成する方法について説明します。SNAX、OSITP、またはOSITPXドメイン・ゲートウェイの構成については、Oracle Tuxedo Mainframe Adaptersのドキュメントを参照してください。

パラメータは通常、KEYWORD = valueという形式で指定します。等号(=)の前後には空白またはタブ文字を使用できます。この形式により、KEYWORDがvalueに設定されます。有効なキーワードについては、以下の各セクションで説明します。

予約語のDEFAULTで始まる行にはパラメータ指定が含まれており、セクション内の以降の該当するすべての行に対して適用されます。デフォルトの指定はすべてのセクションで使用することができます。1つのセクションで複数回使用することもできます。これらの行の形式は次のとおりです。

DEFAULT: [KEYWORD1 = value1 [KEYWORD2 = value2 [...]]]

この行で設定した値は、別のDEFAULT行によってリセットされるか、セクションが終わるまで有効です。これらの値は、DEFAULTでない行の省略可能なパラメータによってオーバーライドされる場合もあります。DEFAULTでない行におけるパラメータ設定は、その行でのみ有効です。以降の行ではデフォルト設定に戻ります。DEFAULTが行頭に表示されると、それ以前に設定されたすべてのデフォルト値はクリアされ、システムのデフォルト値に戻ります。

値がnumericの場合は、Cの標準表記法を使用して基数を示します。つまり、基数16 (16進)の接頭辞は0x、基数8 (8進)の接頭辞は0、基数10 (10進)には接頭辞が付きません。数値パラメータに指定できる値の範囲は、そのパラメータの説明の下に示されています。

値がidentifier (TYPEパラメータのTDOMAINのようにOracle Tuxedo Domainsコンポーネントにとって既知の文字列値)の場合、一般的に標準C規則が使用されます。標準Cのidentifierの先頭には英字またはアンダースコアを使用し、以降の識別子には英数字またはアンダースコアを使用する必要があります。identifierの長さは最大30バイトです(最後のNULLを除く)。

識別子を二重引用符で囲む必要はありません。整数でも識別子でもない値は、二重引用符で囲む必要があります。

入力フィールドは、1つ以上の空白(またはタブ)文字で区切ります。

"#"はコメントを示します。復帰改行文字でコメントを終了します。

空白行とコメントは無視されます。

コメントは任意の行の最後に自由に入力できます。

行は、復帰改行の後に最低1つのタブを置いて継続できます。コメントを継続することはできません。

Domains関連の新しい用語

Oracle Tuxedoのリリース7.1以降では、Domains用のMIBで、ローカル・ドメインとリモート・ドメインとの相互作用を記述するため、クラスと属性の用語が改善されています。新しい用語は、DMCONFIG(5)リファレンス・ページ、セクション名、パラメータ名、エラー・メッセージ、およびDM_MIB(5)リファレンス・ページ、クラス、エラー・メッセージに適用されます。

後方互換性のため、Oracle Tuxedo 7.1より前に使用されていたDMCONFIG用語とDomains用のMIBの新しい用語との間で別名が提供されています。Oracle Tuxedoリリース7.1以降のDMCONFIGでは、両方のバージョンの用語を使用できます。次の表に、DMCONFIGファイルの旧用語と新用語の対応を示します。

Oracle Tuxedoのリリース7.1以降のdmunloadcfコマンドでは、デフォルトで新しいドメイン関連の用語を使用するDMCONFIGファイルが生成されます。以前のドメイン関連の用語を使用するDMCONFIGファイルを出力するには、-cオプションを使用します。例:

プロンプト> dmunloadcf -c > dmconfig_prev

DM_LOCALセクション

このセクション(DM_LOCAL_DOMAINSセクションともいう)では、1つまたは複数のローカル・ドメイン・アクセス・ポイント識別子と、それらに関連付けるゲートウェイ・グループを定義します。このセクションには、UBBCONFIGファイルで指定されたアクティブなゲートウェイ・グループごとにローカル・ドメイン・アクセス・ポイントのエントリが必要です。各エントリでは、グループで実行されるドメイン・ゲートウェイ・プロセスに必要なパラメータを指定します。

DM_LOCALセクションのエントリの形式は次のとおりです。

LocalAccessPoint required_parameters [optional_parameters]

LocalAccessPointは、UBBCONFIGファイルで定義された特定のゲートウェイ・グループを表すローカル・ドメイン・アクセス・ポイント識別子(論理名)です。LocalAccessPointは、Domains構成に含まれるローカルおよびリモート・ドメイン間でユニークでなければなりません。DM_EXPORTセクションで説明するとおり、ローカル・ドメイン・アクセス・ポイントはローカル・サービスを特定のゲートウェイ・グループに関連付けるために使用します。ローカル・ドメイン・アクセス・ポイントを通じて利用可能なローカル・サービスは、1つ以上のリモート・ドメインのクライアントから利用できます。

DM_LOCALセクションの必須パラメータ

GWGRP = identifier

TYPE = identifier

ACCESSPOINTID (DOMAINIDともいう) = string[1..30]

DM_LOCALセクションの省略可能パラメータ

以下に示すDM_LOCALセクションの省略可能なパラメータでは、ドメイン・ゲートウェイの操作で使用するリソースと制限を指定します。

AUDITLOG = string[1..256] (Oracle Tuxedo 8.0以前では最大78バイト)

BLOCKTIME = numeric

CONNECTION_POLICY = {ON_DEMAND | ON_STARTUP | INCOMING_ONLY | PERSISTENT_DISCONNECT}

MAXRETRY = {numeric | MAXLONG}

RETRY_INTERVAL = numeric

CONNECTION_PRINCIPAL_NAME = string[0..511]

DMTLOGDEV = string[1..256] (Oracle Tuxedo 8.0以前では最大78バイト)

DMTLOGNAME = string[1..18]

DYNAMIC_RAP=value

DMTLOGSIZE = numeric

MAXRAPTRAN (MAXRDTRANともいう) = numeric

MAXTRAN = numeric

MTYPE = string[1..15]

SECURITY = {NONE | APP_PW | DM_PW}

DM_LOCALセクションの非TDomainパラメータ

以下のDM_LOCALセクション・パラメータは補完的に示したもので、TDOMAINドメイン・ゲートウェイには適用されません。

SNAXおよびOSITPパラメータの詳細は、Oracle Tuxedo Mainframe Adaptersのドキュメントを参照してください。

DM_REMOTEセクション

このセクション(DM_REMOTE_DOMAINSセクションともいう)では、1つまたは複数のリモート・ドメイン・アクセス・ポイント識別子とそれらの特性を定義します。

DM_REMOTEセクションのエントリの形式は次のとおりです。

RemoteAccessPoint required_parameters [optional_parameters]

RemoteAccessPointは、ローカルOracle Tuxedoアプリケーションにとって既知の各リモート・ドメインを識別するために選択するリモート・ドメイン・アクセス・ポイント識別子(論理名)です。RemoteAccessPointは、Domains構成に含まれるローカルおよびリモート・ドメイン間でユニークでなければなりません。DM_IMPORTセクションで説明するとおり、リモート・ドメイン・アクセス・ポイントはリモート・サービスを特定のリモート・ドメインに関連付けるために使用します。リモート・ドメイン・アクセス・ポイントを介して使用できるリモート・サービスは、リモート・ドメイン・アクセス・ポイントとローカル・ドメイン・アクセス・ポイントを介してローカル・ドメイン内のクライアントで使用できます。

DM_REMOTEセクションの必須パラメータ

TYPE = identifier

ACCESSPOINTID (またはDOMAINID) = string[1..30]

DM_REMOTEセクションの省略可能パラメータ

以下に示すDM_REMOTEセクションの省略可能なパラメータでは、ローカル・ドメイン・ゲートウェイの操作で使用するリソースと制限を指定します。

ACL_POLICY = {LOCAL | GLOBAL}

LOCAL_PRINCIPAL_NAME = string[0..511]

CONNECTION_PRINCIPAL_NAME = string[0..511]

CREDENTIAL_POLICY = {LOCAL | GLOBAL}

MTYPE = string[1..15]

PRIORITY_TYPE = {LOCAL_RELATIVE | LOCAL_ABSOLUTE | GLOBAL}

INPRIORITY = numeric

REQUEST_VERSION = { numeric | * } ( 0 <= num <= 65535 )

VERSION_POLICY = string_value { PROPAGATE }

DM_REMOTEセクションの非TDomainパラメータ

以下のDM_REMOTEセクション・パラメータは補完的に示したもので、TDOMAINドメイン・ゲートウェイには適用されません。

CODEPAGE = string - SNAXおよびOSITPXドメイン・ゲートウェイに適用可能です。

SNAXおよびOSITPXパラメータの詳細は、Oracle Tuxedo Mainframe Adaptersのドキュメントを参照してください。

DM_EXPORTセクション

このセクション(DM_LOCAL_SERVICESセクションともいう)では、各ローカル・ドメイン・アクセス・ポイントによってエクスポートされるサービスに関する情報を指定します。

個々のローカル・ドメインごとに、このセクションが存在しない場合、または存在してもローカル・ドメインからエクスポートされるローカル・サービスがない場合、ローカル・ドメイン・アクセス・ポイントは、ローカルOracle Tuxedoアプリケーションによって公開されるすべてのサービスに対するリモート・リクエストを受け付けます。このセクションを定義することにより、リモート・ドメインからリクエストできるローカル・サービスのセットが制限されます。

ローカル・サービスは、1つ以上のリモート・ドメインがローカル・ドメイン・アクセス・ポイントを介して使用できるサービスです。

DM_EXPORTセクションのエントリの形式は次のとおりです。

service [optional_parameters]

serviceは、特定のローカル・サービスの識別子の名前(127文字以内)です。この名前は、ローカルのOracle Tuxedoアプリケーション内で実行される1つまたは複数のサーバーによって公開された名前です。

1つまたは複数のリモート・ドメインで使用できるローカル・サービスは、そのプロパティの多くを、TUXCONFIGファイルのSERVICESセクションか、またはそれらのデフォルトから継承します。継承されるプロパティとして、LOAD、PRIO、AUTOTRAN、ROUTING、BUFTYPE、TRANTIMEがあります。

DM_EXPORTセクションの省略可能パラメータ

LACCESSPOINT (LDOMともいう) = identifier

ACL = identifier

CONV = {Y | N}

RNAME = string[1..127]

DM_EXPORTセクションの非TDomainパラメータ

以下のDM_EXPORTセクション・パラメータは補完的に示したもので、TDOMAINドメイン・ゲートウェイには適用されません。

SNAX、OSITPおよびOSITPXパラメータの詳細は、Oracle Tuxedo Mainframe Adaptersのドキュメントを参照してください。

DM_IMPORTセクション

このセクション(DM_REMOTE_SERVICESセクションともいう)では、DM_REMOTEセクションで定義されたリモート・ドメイン・アクセス・ポイントを介してローカル・ドメインにインポートおよび提供されるサービスに関する情報を指定します。DM_IMPORTセクションが存在しない場合、または存在しても空の場合、リモート・サービスはローカル・ドメインで使用できません。

リモート・サービスは、ローカル・ドメインがリモート・ドメイン・アクセス・ポイントとローカル・ドメイン・アクセス・ポイントを介して使用できるサービスです。

DM_IMPORTセクションのエントリの形式は次のとおりです。

service [optional_parameters]

serviceは、特定のリモート・サービスに対してローカルOracle Tuxedoによって公開される識別子の名前(127文字以内)です。リモート・サービスは、1つまたは複数のリモート・ドメインからインポートされます。

ローカル・ドメインで使用できるリモートOracle Tuxedoサービスは、そのプロパティの多くを、TUXCONFIGファイルのSERVICESセクションか、またはそれらのデフォルトから継承します。継承されるプロパティとして、LOAD、PRIO、AUTOTRAN、ROUTING、BUFTYPE、TRANTIMEがあります。

DM_IMPORTセクションの省略可能パラメータ

RACCESSPOINT (RDOMともいう) =
   identifier1[,identifier2][,identifier3][,identifier4]...[,indentifier 10]

LACCESSPOINT (LDOMともいう) = identifier

BLOCKTIME numeric_value

CONV = {Y | N}

LOAD = numeric

RNAME = string[1..127]

ROUTING = identifier

VERSION_RANGE = string_value (0 <= num <= 65535)

DM_IMPORTセクションの非TDomainパラメータ

以下のDM_IMPORTセクション・パラメータは補完的に示したもので、TDOMAINドメイン・ゲートウェイには適用されません。

SNAX、OSITPおよびOSITPXパラメータの詳細は、Oracle Tuxedo Mainframe Adaptersのドキュメントを参照してください。

DM_RESOURCES

この省略可能なセクションでは、グローバルDomains構成情報、特にユーザー指定の構成バージョン文字列を定義します。このフィールドはソフトウェアによってチェックされません。

DM_RESOURCESセクションのパラメータは次の1つだけです。

VERSION = string

stringは、ユーザーが現在のDMCONFIG構成ファイルのバージョン番号を入力するためのフィールドです。

DM_ROUTINGセクション

このセクションでは、型付きバッファであるFML、FML32、VIEW、VIEW32、X_C_TYPE、X_COMMON、またはXMLを使用したローカル・サービス・リクエストのデータ依存型ルーティングに関する情報を指定します。

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

ROUTING_CRITERIA_NAME required_parameters

ROUTING_CRITERIA_NAMEは、DM_IMPORTセクションの特定のサービス・エントリのROUTINGパラメータに割り当てられる(identifier)名です。ROUTING_CRITERIA_NAMEは127文字以下でなければなりません。

DM_ROUTINGセクションの必須パラメータ

FIELD = identifier

FIELD = “root_element[/child_element][/child_element][/. . .][/@attribute_name]”

FIELDTYPE = type

RANGES = "string[1..4096]"

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

DM_ACCESS_CONTROLセクション

このセクションは、1つ以上のアクセス制御リスト(ACL)の名前を指定し、1つ以上のリモート・ドメイン・アクセス・ポイントを指定された各ACL名に関連付けます。ACL=ACL_NAMEを設定してDM_EXPORTセクションでACLパラメータを使用すると、特定のローカル・ドメイン・アクセス・ポイントを通じてエクスポートされるローカル・サービスへのアクセスをACL_NAMEと関連付けられたリモート・ドメイン・アクセス・ポイントのみに制限できます。

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

ACL_NAME required_parameters

ACL_NAMEはアクセス制御リストを指定するための識別子です。長さは15文字までです。

DM_ACCESS_CONTROLセクションの必須パラメータは次の1つだけです。

ACLIST = identifier [,identifier]

ACLISTには、1つまたは複数のリモート・ドメイン・アクセス・ポイント名をカンマで区切って指定します。ワイルドカード文字(*)を使用すると、DM_REMOTEセクションで定義したすべてのリモート・ドメイン・アクセス・ポイントが特定のローカル・ドメイン・アクセス・ポイントからエクスポートされるローカル・サービスにアクセスできます。

DM_TDOMAINセクション

このセクションでは、TDomainゲートウェイのネットワーク固有の情報を定義します。リモート・ドメインからローカル・サービスへのリクエストがローカル・ドメイン・アクセス・ポイントで受け付けられる場合、DM_TDOMAINセクションには、ローカル・ドメインごとに少なくとも1つのエントリがなければなりません。また、ローカル・ドメインからリモート・サービスへのリクエストがリモート・ドメイン・アクセス・ポイントで受け付けられる場合、そのアクセス・ポイントごとに1つのエントリがなければなりません。

DM_TDOMAINセクションは、アクセス・ポイント・エントリに対して次のネットワーク・プロパティを構成するために使用します。

DM_TDOMAINセクションのエントリの形式は次のとおりです。

AccessPoint required_parameters [optional_parameters]

AccessPointは、ローカルまたはリモート・ドメイン・アクセス・ポイントを識別するために使用される識別子値です。AccessPoint識別子は、DM_LOCALセクションで前に定義されたローカル・ドメイン・アクセス・ポイント、またはDM_REMOTEセクションで前に定義されたリモート・ドメイン・アクセス・ポイントと一致する必要があります。

DM_TDOMAINセクションの必須パラメータ

NWADDR = string[1..256] (Oracle Tuxedo 8.0以前では最大78バイト)

DM_TDOMAINセクションの省略可能パラメータ

NWDEVICE = string[1..78]

CMPLIMIT = numeric

MINENCRYPTBITS = {0 | 40 | 56 | 128|256}

MAXENCRYPTBITS = {0 | 40 | 56 | 128|256}

NWPROTOCOL = {LLE | SSL | SSL_ONE_WAY}

SSL_RENEGOTIATION numeric

CONNECTION_POLICY = {LOCAL | ON_DEMAND | ON_STARTUP | INCOMING_ONLY | PERSISTENT_DISCONNECT}

FAILOVERSEQ = -1 <= num <= 32767

LACCESSPOINT (LDOMともいう) = "string"[1..30]

[MAXRETRY = {numeric | MAXLONG}

RETRY_INTERVAL = numeric

TCPKEEPALIVE = {LOCAL | NO | YES}