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

ドキュメントのダウンロード

サイトマップ

用語集

検索

e-docs > Tuxedo > Tuxedo のファイル形式とデータ記述方法 > セクション 5 ―ファイル形式、データ記述方法、MIB、およびシステム・プロセスのリファレンス

Tuxedo のファイル形式とデータ記述方法

T_SERVICE クラスの定義

概要

T_SERVICE クラスは、アプリケーション内のサービスのコンフィギュレーション属性を表します。これらの属性値によって、コンフィギュレーション済みのサービスを識別できます。T_SERVICE オブジェクトは、T_SVCGRP クラスの一部としてコンフィギュレーションされていないサービスに対するアクティブ化時のコンフィギュレーション属性を提供します。アプリケーション内でアクティブなサービスの実行時情報は、T_SVCGRP クラスでのみ取得可能です。T_SERVICE クラスを実行時に更新しても、通常はアクティブな T_SVCGRP オブジェクトには反映されません (TA_ROUTINGNAME は例外です)。

T_SERVICE クラスおよび T_SVCGRP クラスは、アプリケーション内のサービス名に対するアクティブ化時の属性設定を定義します。サーバを初めてアクティブにしたため、または tpadvertise() を呼び出したために新たなサービスがアクティブ化 (宣言) されると、サービス開始時に使用する属性値は以下の順序で決定されます。

サービス名とサービス・グループが一致するコンフィギュレーション済みの T_SVCGRP オブジェクトが存在する場合、宣言されたサービスの初期コンフィギュレーションには、このオブジェクトで定義された属性が使用されます。
1 に該当せず、かつサービス名が一致するコンフィギュレーション済みの T_SERVICE オブジェクトが存在する場合、宣言されたサービスの初期コンフィギュレーションには、このオブジェクトで定義された属性が使用されます。
1 および 2 に該当せず、かつ TA_SERVICENAME 属性値が一致するコンフィギュレーション済みの T_SVCGRP オブジェクトが見つかった場合、宣言されたサービスの初期コンフィギュレーションには、最初に見つかったオブジェクトが使用されます。
上記のいずれにも該当しない場合、宣言されたサービスの初期コンフィギュレーションには、サービス属性のシステム・デフォルト値が使用されます。

アプリケーション・サービスに対するコンフィギュレーション属性の指定はすべて省略可能です。つまり、コンフィギュレーション値を指定しない場合、サービスのアクティブ化時にサーバが宣言したサービスには確立済みのデフォルト・サービス値が使用されます (サービスのアクティブ化時に属性値を識別する方法については上記を参照のこと)。サーバが提供するサービス名は実行時に作成されます (buildserver(1) を参照)。ただし、サーバ・オブジェクトに指定されたコマンド行オプションによってオーバライドされる場合もあります (T_SERVER:TA_CLOPT および servopts(5) を参照)。

属性表

表 58 TM_MIB(5): T_SERVICE クラス定義の属性表

属性	タイプ	パーミッション	値	デフォルト値
TA_SERVICENAME(r)(*)	string	ru-r--r--	string[1..15]	N/A
TA_STATE(k)	string	rw-r--r--	GET: "{ACT \| INA}" SET: "{NEW \| INV}"	N/A N/A
TA_AUTOTRAN	string	rwyr--r--	"{Y \| N}"	"N"
TA_LOAD	long	rwyr--r--	1 <= num < 32,768	50
TA_PRIO	long	rwyr--r--	1 <= num < 101	50
TA_SVCTIMEOUT	long	rwyr--r--	0 <= num	0
TA_TRANTIME	long	rwyr--r--	0 <= num	30
TA_BUFTYPE	string	rw-r--r--	string[1..256]	"ALL"
TA_ROUTING名前	string	rwxr--r--	string[0..15]	""
TA_SIGNATURE_REQUIRED	string	rwxr--r--	"{Y\|N}"	"N"
TA_ENCRYPTION_REQUIRED	string	rwxr--r--	"{Y\|N}"	"N"
(k)-GET キー・フィールド (r)-オブジェクトの作成に必要なフィールド (SET TA_STATE NEW) (*)-GET/SET キー、SET 操作では 1 つ以上必要

属性の意味

TA_SERVICENAME: string[1..15]

サービス名。

TA_STATE:

GET: "{ACTive | INActive}"

GET 操作は、選択した T_SERVICE オブジェクトのコンフィギュレーション情報を検索します。以下に示す状態は、GET 要求への応答で返される TA_STATE の意味を示します。

ACTive	T_SERVICE オブジェクトが定義済みで、TA_SERVICENAME の値が一致する T_SVCGRP オブジェクトの少なくとも 1 つはアクティブです。
INActive	T_SERVICE オブジェクトが定義済みで、TA_SERVICENAME の値が一致する T_SVCGRP オブジェクトはアクティブではありません。

SET: "{NEW | INValid}"

SET 操作は、選択した T_SERVICE オブジェクトのコンフィギュレーション情報を更新します。以下に示す状態は、SET 要求で設定される TA_STATE の意味を示します。以下に示されていない状態は設定できません。

NEW	アプリケーションに対する T_SERVICE オブジェクトを作成します。状態の変更は INValid 状態でのみ可能です。正常に終了すると、オブジェクトの状態は INActive になります。制限事項: コンフィギュレーションされていないサービスが、それらを宣言しているサーバによってアクティブなままになっている場合があります。この場合、新規に T_SERVICE オブジェクトを作成することはできません。
unset	既存の T_SERVICE オブジェクトを変更します。この組み合わせは INValid 状態では使用できません。正常終了した場合、オブジェクトの状態は変わりません。
INValid	アプリケーションに対する T_SERVICE オブジェクトを削除します。状態の変更は、INActive 状態でのみ可能です。正常終了すると、オブジェクトの状態は INValid になります。