Oracle Tuxedoサービス・メタデータ・リポジトリの管理

Oracle Tuxedoサービス・メタデータ・リポジトリには、Oracle TuxedoクライアントがOracle Tuxedoサービスのパラメータ情報にアクセスするために使用するOracle Tuxedoサービスの定義が格納されます。このリポジトリを使用すると、Oracle Tuxedoアプリケーションの開発者と管理者は、一部またはすべてのOracle Tuxedoアプリケーション・サービスに関する詳細なサービス・パラメータ情報を格納および取得できます。

Oracle Tuxedoサービス・メタデータ・リポジトリは、アプリケーションの開発または変更時に、開発者と管理者による対話形式の問合せを処理することを目的に設計されました。アプリケーションの本番フェーズで、自動化された大量の問合せを処理するためのものではありません。

Oracle Tuxedoサービス・メタデータ・リポジトリは、5つのユーティリティと組み合せて使用します

Oracle Joltリポジトリとの類似点と相違点

Oracle Joltにも、サービス名、入出力バッファ・タイプ、パラメータ名、パラメータのデータ型、各パラメータが予期される回数、各パラメータが入力用か、出力用か、入出力両用かなどのOracle Tuxedoサービス情報をアプリケーションから手動で入力できるようにするためのサービス・リポジトリが用意されています。これらすべての点では、Oracle Tuxedoサービス・メタデータ・リポジトリとよく似ています。しかし、表8-1に示すように、明確な相違点もいくつかあります。

表8-1 Oracle Joltリポジトリとの類似点と相違点
	Oracle Joltリポジトリ	Oracle Tuxedoサービス・メタデータ・リポジトリ
機能	JAVAクライアントによるOracle Tuxedoサーバーとの通信用に設計されています	Oracle TuxedoサーバーとのWebサービス・ベースの通信用に設計されています
GUIインタフェース	はい	いいえ
プレーン・テキストのリポジトリ入力ファイルの使用	はい(bulkloader経由)	はい(`tmloadrepos`経由)。
サービスおよびパラメータのキーワードと値	はい	はい(Oracle Joltリポジトリよりも詳しいサービス情報をユーザーに提供します)
リポジトリ・ファイルの形式	プレーン・テキスト。	バイナリ(すばやくアクセスできるようにサービスに索引が付けられます)
アクセス方法	管理ユーティリティ、直接編集。	管理ユーティリティ、プログラミングAPI、システム・サービス。
アンロードの出力形式	プレーン・テキスト。	プレーン・テキストおよびC疑似コード。
相互運用性	Oracle Tuxedoサービス・メタデータ・リポジトリ・ファイルは読み込めません	既存のOracle Joltリポジトリ・ファイルを読み込めますが、変更はできません。Oracle Joltリポジトリ・ファイルは作成できません。

MIB(5)との類似点と相違点

Oracle Tuxedoシステム・メタデータ・リポジトリにプログラム的にアクセスするには、Tuxedo MIB形式によく似たFML32バッファ形式を使用します。ただし、表8-2に示すように、明確な相違点もいくつかあります。

表8-2 MIB(5)との類似点と相違点
	`MIB(5)`	`METAREPOS(5)`
入出力バッファ	FML32	FML32
汎用MIBフィールド	はい	はい。ただし、いくつかの制限があります。「METAREPOS(5)」を参照してください。
真正のMIBクラス・エンティティ	多数	真正のMIBクラス・エンティティはありませんが、似たようなエンティティを使用します。
サービス・エントリ	`BBL`の`.TMIB`。	`TMMETADA`サーバーの `.TMMETAREPOS`。

Oracle Tuxedoサービス・メタデータ・リポジトリの作成

メタデータ・リポジトリ・ファイルには、Oracle Tuxedoサービス・メタデータ・リポジトリでアクセスするすべてのサービス・パラメータ情報を格納します。tmloadreposコマンドは、メタデータ・リポジトリ・ファイルを作成するために使用します。メタデータ・リポジトリ・ファイルのサービス・パラメータ情報は、指定したプレーン・テキストのリポジトリ入力ファイルから入力するか、リポジトリ入力ファイルが指定されていない場合はコンピュータのコンソール(標準入力)から直接入力します。例:

tmloadrepos-i/usr/tuxedo/repository_input_file /usr/tuxedo/service_metatdata_repository

Oracle Tuxedoサービス・メタデータ・リポジトリの入力ファイル

repository_input_fileには、サービス・パラメータ・キーワードとそれらの関連値が含まれます。キーワードは、サービス・レベルとパラメータ・レベルの2つのカテゴリに分かれます。

1行に指定できるキーワードと値の組合せは1つのみです。1行に入力できる文字の長さは1024バイトまでです。文字列パラメータ値を引用符で囲む必要はありません。

repository_inputファイルでは、 <keyword><=value>という構文を使用し、次の入力規則に従う必要があります。

"("および")"

\ および“\”

#

repository_inputファイルは、0個以上のサービス・パラメータ定義で構成できます。各サービス定義は、<service>キーワードで始まる行で開始し、その後に他のいずれかのサービス・レベル・キーワードで始まる0個以上の行が続き、その後にパラメータ・レベル・キーワードが続きます。1つのサービスで、同じサービス・レベル・キーワードを繰り返し使用することはできません。

サービス・レベルのキーワードと値を使う

サービス定義は、キーワードservice<=NAME>または省略形sv<=NAME>で開始する必要があります。 CARRAY、STRINGまたはXMLバッファ・タイプを使用しているサービスには、サービスあたり1つのパラメータのみ使用できます。Oracle Tuxedoサービス・メタデータ・リポジトリのサービス・レベル・キーワードを表8-3に示します。

サービス・レベル
キーワード

キーワード
の省略形

値

service

任意のOracle Tuxedoサービス名

注意:値を指定したこのキーは、メタデータ・リポジトリ・インスタンスごとに1つのみ指定できます。同じメタデータ・リポジトリ内で重複させることはできません。

tuxservice

tsv

実際のOracle Tuxedoサービス名

注意: serviceキーワードとtuxserviceキーワードの違いは以下のとおりです。

serviceは、メタデータ・リポジトリに格納するサービス・エントリを表します。
tuxserviceは実際のOracle Tuxedoサービス名を表します。複数のservice定義で、tuxserviceと同じ値を指定できます。

これら2つのキーワードを組み合せて使用すると、1つのOracle Tuxedoサービスに対して複数のサービス定義を指定できます。tuxserviceは、デフォルトではserviceと同じ値になります

servicetype

サービスの呼出し方式。以下の値を指定できます。

request - response - サービスは同期型です

oneway - サービスはクライアントにレスポンスを送信しません

queue - サービスは/Q関連アプリケーションです

conv - サービスは変換型です

SNAISC

ISC

アウトバウンドTuxedoサービス・リクエストがAPPCトランザクション・プログラムまたはCICSプログラムにマップできるようにします。servicemodeの値がsnaの場合にのみ有効です。有効な値のリストは、APPC、ATI、DPL、DTPです。デフォルト値APPCでは、リモート・サービスを、CICS下で実行するかどうかを問わずトランザクション・プログラムとして指定します。値DPLでは、リモート・サービスをCICS下で実行されるプログラムにマップします。

servicemode

サービスの生成元のタイプ(オプション)。以下の値を指定できます。

tuxedo - このサービスは、Oracle Tuxedoから生成したサービスです

webservice - 外部のWebサービス・インタフェースから変換されたプロキシ・サービス

sna - SNAゲートウェイ用インポート・サービス。エクスポート・サービスの場合、tuxedoがデフォルト値です。

指定しない場合、tuxedoがデフォルト値になります。

注:	Oracle Tuxedoサービスにはwebserviceを指定しないでください(webserviceはSALTプロキシ・サービス用に予約されています)。

export

ex

Y(デフォルト値)またはN。Oracle Joltリポジトリでは、このキーワードを使用して、Oracle Joltクライアントに対するサービスの可用性を判別します。

このキーワードは、Oracle Tuxedoリポジトリでは使用されていませんが、既存のOracle Joltバルク・ローダー・ファイルとの互換性を維持するために残されています。

注:	`export`をNに設定すると、サービスはC疑似コードまたはテキスト形式ではエクスポートされません。

errbuf

ebt

TPFAILが指定されたOracle Tuxedoサービス・レスポンス(エラー)バッファ・タイプ。次の値型のいずれかを選択します(大文字と小文字は区別されます)。

FML、FML32、VIEW、VIEW32、STRING、CARRAY、XML、X_OCTET、X_COMMON、X_C_TYPE、MBSTRING、またはアプリケーション定義のカスタム・バッファ型を表すその他の任意の文字列。

inview

vn

入力バッファのビュー名(オプション)。

注:	このキーワードが必須になるのは、バッファ・タイプとして`VIEW`、`VIEW32`、`X_COMMON`、`X_C_TYPE`、`FML`、`FML32`のいずれかを使用している場合のみです。

outview

VN

出力バッファのビュー名(オプション)。

注:	このキーワードが必須になるのは、バッファ・タイプとして`VIEW`、`VIEW32`、`X_COMMON`、`X_C_TYPE`、`FML`、`FML32`のいずれかを使用している場合のみです。

errview

evn

エラー・バッファのビュー名(オプション)。

注:	このキーワードが必須になるのは、バッファ・タイプとして`VIEW`、`VIEW32`、`X_COMMON`、または`X_C_TYPE`を使用している場合のみです。

inbufschema

isc

入力バッファに対するカスタマイズされたメッセージ・スキーマの関連付け(オプション)。値形式は次のとおりです。

XSD_E:<element_local_name>@namespaceURI

たとえば、XSD_E:Book@http://example.orgは、入力バッファがXMLネームスペース"http://example.org"に定義されたXML要素<Book>に関連付けられていることを表しています。

注:	このキーワードは、Oracle SALT拡張メッセージのマッピングおよび変換機能をサポートするために導入されています。SALTメッセージ変換の詳細は、Oracle SALTのWebサービスのプログラミングのデータ型のマッピングとメッセージ変換に関する項を参照してください。

outbufschema

osc

出力バッファに対するカスタマイズされたメッセージ・スキーマの関連付け(オプション)。値形式は次のとおりです。

XSD_E:<element_local_name>@namespaceURI

errbufschema

esc

エラー・バッファに対するカスタマイズされたメッセージ・スキーマの関連付け(オプション)。値形式は次のとおりです。

XSD_E:<element_local_name>@namespaceURI

svcdescription

sd

任意の文字列値。文字列が長い場合は、改行して読みやすくできます。

sendqspace

sqs

送信キュー・スペース名。「queue」方式のサービスでは省略可能です。

sendqueue

sqn

送信キュー名。「queue」方式のサービスでは省略可能です。

rplyqueue

rqn

応答キュー名。「queue」方式のサービスでは省略可能です。

errqueue

eqn

エラー・キュー名。「queue」方式のサービスでは省略可能です。

rcvqspace

RQS

受信キュー・スペース名。「queue」方式のサービスでは省略可能です。

rcvqueue

RQN

受信キュー名。「queue」方式のサービスでは省略可能です。

version

vs

このパラメータは、Oracle Tuxedoサービス・メタデータ・リポジトリ専用で、アプリケーションで使用するあらゆる文字列に対応できます。

Oracle Tuxedoでは、このパラメータは解釈されません。

attributes

att

このパラメータは、Oracle Tuxedoサービス・メタデータ・リポジトリ専用で、アプリケーションで使用するあらゆる文字列に対応できます。

Oracle Tuxedoでは、このパラメータは解釈されません。

fieldtbls

ftb

このパラメータは省略可能です。このサービスで使用するFMLまたはFML32フィールドの検索に使用するフィールド表のカンマ区切りのリストを指定します。fieldtblsは、アプリケーション開発者が参照用に使用するパラメータです。

パラメータ・レベルのキーワードと値を使う

パラメータは、キーワード<param><=NAME>または省略形<pn><=NAME>から開始し、パラメータ・キーワードのリストが続きます。別の<param>または<service>キーワードで終了するか、またはファイルの終わりが検出されると終了します。パラメータは、<param><=NAME>の後に任意の順序でリストできます。

Oracle Tuxedoサービス・メタデータ・リポジトリのパラメータ・レベル・キーワードを表8-4に示します。

パラメータ・レベル・
キーワード

メタデータ・リポジトリの
省略形

値

param

pn

任意のパラメータ名

type

pt

byte、short、integer、float、double、string、carray、dec_t、xml、ptr、fml32、view32、mbstring。

注:	パラメータ・タイプは、サービス・バッファ・タイプと一貫している必要があります。たとえば、`FML16`バッファでは、`byte (char)`、`short`、`integer`、`long`、`float`、 `double`、`string`、`carray`のタイプのパラメータのみ使用できます。他のすべてのタイプのパラメータは許可されません。次のバッファ・タイプ/パラメータ・タイプの一致表を参照してください。

subtype

pst

view32型のパラメータのビュー名

access

pa

in、out、err、inout、inerr、outerr、inouterr、noaccess。

in - 入力のみに使用されるパラメータを示します。
out - 出力のみに使用されるパラメータを示します。
err - エラー出力のみに使用されるパラメータを示します。
inout - 入力と出力の両方に使用されるパラメータを示します。
inerr - 入力とエラー出力の両方に使用されるパラメータを示します。
outerr - 出力とエラー出力の両方に使用されるパラメータを示します。
inouterr - 入力、出力およびエラー出力に使用されるパラメータを示します。
noacesss - 古いパラメータやビューの入力フィールドとして提供する必要のあるパラメータなど、入力で提供する必要はあるがサーバーでは参照されないパラメータを示します。

入力で期待されるパラメータのセットは、in、inout、inerr、inouterrまたはnoaccessアクセスです

出力で戻されるパラメータのセットは、out、inout、outerrまたはinouterrアクセスで指定されます。

エラー出力で戻されるパラメータのセットは、err、inerr、outerrまたはinouterrアクセスで指定されます。

count

po

オカレンスの最大数(デフォルトは1)。無制限のオカレンスを表す値は0です。値の範囲は[0, 32767]です。

Oracle Joltリポジトリでは、このパラメータはテスト画面を書式設定するためにリポジトリ・エディタでのみ使用されます。Oracle Tuxedoリポジトリでは、このパラメータは表示用に格納され、tmunloadrepos(1)擬似コード生成オプションでも使用されます。

paramdescription

pd

任意の文字列値。文字列が長い場合は、改行して読みやすくできます。

size

pl

このオプションのパラメータは、パラメータに割り当てられているバイト数を示します。非数値パラメータの擬似コード生成に使用され、プログラマが参照する目的で使用できます。

carray、string、xml、mbstringのパラメータ・タイプでは、この値が期待されます。

requiredcount

ro

パラメータの最小限の指定回数。値の範囲は[0, 32767]です。

fldnum

fno

このオプションのパラメータは、FML/FML32フィールドの場合にパラメータのフィールド数を示します。

注:	環境`FLDTBLDIR(32)`を使用してフィールド表ディレクトリを指定し、環境`FIELDTBLS(32)`または`fieldtbl`サービス・レベル・キーワードを使用してフィールド表ファイルを指定することで`fieldtbl`ファイルがすでに定義されている場合は、この情報を使用することをお薦めします。

注:	`fldnum`フィールドを構成した場合は、`param`値ではなく`fldnum`値に従って応答`fldid`を受信します。

vfbname

vfb

このパラメータは、ビュー構造メンバーではオプションです。フィールド・バッファ内のフィールド名を示すために使用されます。「viewfile(5)」を参照してください

vflag

vfl

このパラメータは、ビュー構造メンバーではオプションです。有効な値は、'C'、'F'、'L'、'N'、'P'、'S'のオプションの組合せです。「viewfile(5)」を参照してください。

vnull

vnu

このパラメータは、ビュー構造メンバーではオプションです。ビュー・メンバーのデフォルトのnull値を示します。

paramschema

psc

このパラメータはオプションで、分解FML32フィールドのXMLスキーマ情報を保存します。

注:	このパラメータ・キーワードは、"servicemode=webservice"タイプのサービス定義(アウトバウンド・コールのSALTプロキシ・サービス)用に導入されました。パラメータ値は外部WSDLファイルの変換からOracle SALT wsdlcvtユーティリティで生成されます。このキーワード値を手動で指定または変更しないでください。

primetype

pxt

このパラメータはオプションで、分解FML32フィールドの元のXML原始データ型を保存します。

注:	このパラメータ・キーワードは、"servicemode=webservice"タイプのサービス定義(アウトバウンド・コールのSALTプロキシ・サービス)用に導入されました。パラメータ値は外部WSDLファイルの変換からOracle SALT wsdlcvtユーティリティで生成されます。このキーワード値を手動で指定または変更しないでください。

(

埋め込まれたFML32またはVIEW32バッファ・フィールドに含まれるパラメータの説明の開始を示します。

関連付けられた値は含まれず、1行に単独で指定されます。FML32またはVIEW32値でこのパラメータに前述のタイプ・キーワードが指定されている場合にのみ有効です。

閉じる右カッコ')'は、埋込みパラメータの説明を終了します。

)

対応する左カッコ'('で開始した埋込みFML32またはVIEW32パラメータ定義を終了します。

関連付けられた値は含まれず、1行に単独で指定されます。前に対応する'('キーワードがある場合にのみ有効です。

また、埋込みの最大レベルは、埋込みFML32のネスト・レベルの上限(現在は18)によって決まります。

パラメータのオカレンス

Oracle Tuxedoに一般に適用されるルールとして、(その情報構造により)FML/FML32、VIEW/VIEW32、X_COMMONおよびX_C_TYPEタイプのバッファのみが複数のパラメータを指定できます。他のすべてのタイプのバッファは、対応するパラメータ・タイプのパラメータを1つのみ持ちます。たとえば、CARRAYタイプのバッファには、そこに含まれる必要な情報を記述する1つのCARRAYタイプ・パラメータのみあります。アプリケーション・サービスを定義するにはこのルールに従う必要があります。

表8-5 サービス・バッファ・タイプ(大文字で開始)/サービス・パラメータ・タイプ(小文字)の対応表I
	byte (char)	`short`	`integer`	`long`	`float`	`double`	`string`
`CARRAY`
`FML`	X	X	X	X	X	X	X
`FML32`	X	X	X	X	X	X	X
`STRING`							X
`VIEW`	X	X	X	X	X	X	X
`VIEW32`	X	X	X	X	X	X	X
`X_COMMON`		X		X			X
`X_C_TYPE`	X	X	X	X	X	X	X
`XML`							X
`X_OCTET`
`MBSTRING`

表8-6 サービス・バッファ・タイプ(大文字で開始)/サービス・パラメータ・タイプ(小文字)の対応表II
	bool	`Unsigned char`	`Signed char`	`Wchar_t`	`Unsigned int`	`Unsigned long`	`Long long`	Unsigned long long	Long double
`VIEW`	X	X	X	X	X	X	X	X	X
`VIEW32`	X	X	X	X	X	X	X	X	X

Oracle Tuxedoサービス・メタデータ・リポジトリの構成

Oracle Tuxedoサービス・メタデータ・リポジトリを構成するには、次の操作が必要です。

Oracle Tuxedoメタデータ・サーバーが実行されると、.TMMETAREPOSサービスが自動的にアクティブになります。.TMMETAREPOSはOracle Tuxedoシステム・サービスであり、変更できません。

サーバーに対して行われたすべてのリクエストは、先に到着したものから順に処理されます。

複数のOracle Tuxedoサービス・メタデータ・リポジトリ・サーバーの構成

特定のOracle Tuxedoノードで複数のTMMETADATAサーバーを設定するには、2つの重要な構成ルールに従う必要があります。

Oracle Tuxedoサービス・メタデータ・リポジトリ・ファイルへのアクセス

Oracle Tuxedoサービス・メタデータ・リポジトリは、サービス・メタデータ・リポジトリ・パラメータ情報を表示、更新、追加または削除するために、ネイティブおよびリモートのクライアント・アクセスを促進します。

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

Oracle Tuxedoサービス・メタデータ・リポジトリの管理