このスクリプトは、e-docsドキュメントの検索に必要なGoogle検索のURLを出力します。
このスクリプトは、e-docsドキュメントに必要なバナーを出力します。
このスクリプトは、e-docsドキュメントの検索に必要なGoogle検索のパラメータを出力します。
Oracle Tuxedoアプリケーションの設定
Oracle Tuxedoサービス・メタデータ・リポジトリの管理
ここでは、以下の内容について説明します。
Oracle Tuxedoサービス・メタデータ・リポジトリ
Oracle Tuxedoサービス・メタデータ・リポジトリには、Oracle TuxedoクライアントがOracle Tuxedoサービスのパラメータ情報にアクセスするために使用するOracle Tuxedoサービスの定義が格納されます。このリポジトリを使用すると、Oracle Tuxedoアプリケーションの開発者と管理者は、一部またはすべてのOracle Tuxedoアプリケーション・サービスに関する詳細なサービス・パラメータ情報を格納および取得できます。
Oracle Tuxedoサービス・メタデータ・リポジトリは、アプリケーションの開発または変更時に、開発者と管理者による対話形式の問合せを処理することを目的に設計されました。アプリケーションの本番フェーズで、自動化された大量の問合せを処理するためのものではありません。
Oracle Tuxedoサービス・メタデータ・リポジトリは、5つのユーティリティと組み合せて使用します
注意:
.TMMETAREPOS
バッファ形式はMIB(5) に似ています。
tmloadrepos(1) :バイナリのメタデータ・リポジトリ・ファイルを作成または更新し、サービス・パラメータ情報と共にロードします。
tmunloadrepos(1) : Oracle Tuxedoサービス・メタデータ・リポジトリからのサービス情報を表示します。出力は、オプションでプレーン・テキスト形式、WSDL形式またはC擬似コードとして指定できます
tpgetrepos(3c) : FML32バッファを使用して、Oracle Tuxedoサービス・メタデータ・リポジトリからのサービス情報を出力します
tpsetrepos(3c) : FML32バッファを使用して、サービス・メタデータ・リポジトリに対するサービス・パラメータ情報の追加、削除、更新を行います。
Oracle Joltリポジトリとの類似点と相違点
Oracle Joltにも、サービス名、入出力バッファ・タイプ、パラメータ名、パラメータのデータ型、各パラメータが予期される回数、各パラメータが入力用か、出力用か、入出力両用かなどのOracle Tuxedoサービス情報をアプリケーションから手動で入力できるようにするためのサービス・リポジトリが用意されています。これらすべての点では、Oracle Tuxedoサービス・メタデータ・リポジトリとよく似ています。しかし、表8-1 に示すように、明確な相違点もいくつかあります。
表8-1 Oracle Joltリポジトリとの類似点と相違点
Oracle Tuxedoサービス・メタデータ・リポジトリ
JAVAクライアントによるOracle Tuxedoサーバーとの通信用に設計されています
Oracle TuxedoサーバーとのWebサービス・ベースの通信用に設計されています
あり(Oracle Joltリポジトリよりも詳しいサービス情報をユーザーに提供します)
バイナリ(すばやくアクセスできるように
サービスに索引が付けられます)
管理ユーティリティ、プログラミングAPI、システム・サービス。
Oracle Tuxedoサービス・メタデータ・リポジトリ・ファイルは読み込めません
既存のOracle Joltリポジトリ・ファイルを読み込めますが、変更はできません。Oracle Joltリポジトリ・ファイルは作成できません。
MIB(5)との類似点と相違点
Oracle Tuxedoシステム・メタデータ・リポジトリにプログラム的にアクセスするには、Tuxedo MIB形式によく似たFML32バッファ形式を使用します。ただし、表8-2 に示すように、明確な相違点もいくつかあります。
表8-2 MIB(5)との類似点と相違点
あり。ただし、いくつかの制限があります。
「METAREPOS(5)」 を参照してください。
真正のMIBクラス・エンティティはありませんが、似たようなエンティティを使用します。
TMMETADA
サーバーの
.TMMETAREPOS
。
Oracle Tuxedoサービス・メタデータ・リポジトリの作成
メタデータ・リポジトリ・ファイルには、Oracle Tuxedoサービス・メタデータ・リポジトリでアクセスするすべてのサービス・パラメータ情報を格納します。tmloadrepos
コマンドは、メタデータ・リポジトリ・ファイルを作成するために使用します。メタデータ・リポジトリ・ファイルのサービス・パラメータ情報は、指定したプレーン・テキストのリポジトリ入力ファイル から入力するか、リポジトリ入力ファイルが指定されていない場合はコンピュータのコンソール(標準 入力)から直接入力します。例:
Oracle Tuxedoサービス・メタデータ・リポジトリの入力ファイル
repository_input
_file
には、サービス・パラメータ・キーワードとそれらの関連値が含まれます。キーワードは、サービス・レベルとパラメータ・レベルの2つのカテゴリに分かれます。
1行に指定できるキーワードと値の組合せは1つのみです。1行に入力できる文字の長さは1024バイトまでです。文字列パラメータ値を引用符で囲む必要はありません。
repository_input
ファイルでは、 <keyword><=value>
という構文を使用し、次の入力規則に従う必要があります。
"("
および")"
パラメータでサブ・パラメータを定義する必要がある場合、単一の左カッコ'('から構成される行と単一の右カッコ')'から構成される行は、パラメータのサブパラメータ部分の開始と終了を示します。左と右のカッコは再帰的に使用できます。
\
および「\」
repository_input
ファイルには、読みやすくするための空白行を挿入できます。新しい行は文字で始めます。実際の「\」文字を使用する場合は、「\\」と記述する必要があります。
#
「#」で始まる行はコメント行と解釈されます。このようなコメントは、
svcdescription
または
paramdescription
キーワードで指定したコメントと異なり、バイナリの
repository_file
やtmunloadreposによる出力には含まれません。
repository_input
ファイルは、0個以上のサービス・パラメータ定義で構成できます。各サービス定義は、<service>
キーワードで始まる行で開始し、その後に他のいずれかのサービス・レベル・キーワードで始まる0個以上の行が続き、その後にパラメータ・レベル・キーワードが続きます。1つのサービスで、同じサービス・レベル・キーワードを繰り返し使用することはできません。
サービス・レベルのキーワードと値を使う
サービス定義は、キーワードservice<=NAME>
または省略形sv<=NAME>
で開始する必要があります。 CARRAY
、STRING
またはXML
バッファ・タイプを使用しているサービスには、サービスあたり1つのパラメータのみ使用できます。Oracle Tuxedoサービス・メタデータ・リポジトリのサービス・レベル・キーワードを表8-3 に示します。
表8-3 サービス・レベル・キーワード、省略形、値
注意:値を指定したこのキーは、メタデータ・リポジトリ・インスタンスごとに1つのみ指定できます。同じメタデータ・リポジトリ内で重複させることはできません。
注意:
service
キーワードと
tuxservice
キーワードの違いは以下のとおりです。
service
は、メタデータ・リポジトリに格納するサービス・エントリを表します。
tuxservice
は実際のOracle Tuxedoサービス名を表します。複数のservice
定義で、tuxservice
と同じ値を指定できます。
これら2つのキーワードを組み合せて使用すると、1つのOracle Tuxedoサービスに対して複数のサービス定義を指定できます。
tuxservice
は、デフォルトでは
service
と同じ値になります
service
- サービスが同期型の場合
oneway
- サービスがクライアントにレスポンスを送信しない場合
queue
- サービスが/Q関連のアプリケーションの場合
サービスの生成元のタイプ(オプション)。以下の値を指定できます。
tuxedo - このサービスは、Oracle Tuxedoから生成したサービスです
webservice - このサービスは、外部のWebサービス・インタフェースから変換されたSALTプロキシ・サービスです。
指定しない場合、tuxedoがデフォルト値になります。
注意:
Oracle Tuxedoサービスにはwebserviceを指定しないでください(webserviceはSALTプロキシ・サービス用に予約されています)。
Y(デフォルト値)またはN。Oracle Joltリポジトリでは、このキーワードを使用して、Oracle Joltクライアントに対するサービスの可用性を判別します。
このキーワードは、Oracle Tuxedoリポジトリでは使用されていませんが、既存のOracle Joltバルク・ローダー・ファイルとの互換性を維持するために残されています。
Oracle Tuxedoサービス・リクエスト(入力)バッファ・タイプ。次の値型のいずれかを選択します(大文字と小文字は区別されます)。
FML
、
FML32
、
VIEW
、
VIEW32
、
STRING
、
CARRAY
、
XML
、
X_OCTET
、
X_COMMON
、
X_C_TYPE
、
MBSTRING
、またはアプリケーション定義のカスタム・バッファ型を表すその他の任意の文字列。
注意:
各サービス定義の「inbuf」
の値をNULLにすることはできません。
TPSUCCESSが指定されたOracle Tuxedoサービス・レスポンス(出力)バッファ・タイプ。次の値型のいずれかを選択します(大文字と小文字は区別されます)。
FML
、
FML32
、
VIEW
、
VIEW32
、
STRING
、
CARRAY
、
XML
、
X_OCTET
、
X_COMMON
、
X_C_TYPE
、
MBSTRING
、またはアプリケーション定義のカスタム・バッファ型を表すその他の任意の文字列。
注意:
「service」
または「queue」
方式のサービスのサービス定義では、「outbuf」
の値をNULLにすることはできません。
TPFAILが指定されたOracle Tuxedoサービス・レスポンス(エラー)バッファ・タイプ。次の値型のいずれかを選択します(大文字と小文字は区別されます)。
FML
、
FML32
、
VIEW
、
VIEW32
、
STRING
、
CARRAY
、
XML
、
X_OCTET
、
X_COMMON
、
X_C_TYPE
、
MBSTRING
、またはアプリケーション定義のカスタム・バッファ型を表すその他の任意の文字列。
注意:
このキーワードが必須になるのは、バッファ・タイプとしてVIEW
、VIEW32
、X_COMMON
、またはX_C_TYPE
を使用している場合のみです。
注意:
このキーワードが必須になるのは、バッファ・タイプとしてVIEW
、VIEW32
、X_COMMON
、またはX_C_TYPE
を使用している場合のみです。
注意:
このキーワードが必須になるのは、バッファ・タイプとしてVIEW
、VIEW32
、X_COMMON
、またはX_C_TYPE
を使用している場合のみです。
入力バッファに対するカスタマイズされたメッセージ・スキーマの関連付け(オプション)。値形式は次のとおりです。
XSD_E:<element_local_name>@namespaceURI
たとえば、XSD_E:Book@http://example.orgは、入力バッファがXMLネームスペース"http://example.org"に定義されたXML要素<Book>に関連付けられていることを表しています。
注意:
このキーワードは、Oracle SALT拡張メッセージのマッピングおよび変換機能をサポートするために導入されています。SALTメッセージ変換については、Oracle SALTの『Webサービスのプログラミング』の「データ型のマッピングとメッセージ変換」 を参照してください。
出力バッファに対するカスタマイズされたメッセージ・スキーマの関連付け(オプション)。値形式は次のとおりです。
XSD_E:<element_local_name>@namespaceURI
エラー・バッファに対するカスタマイズされたメッセージ・スキーマの関連付け(オプション)。値形式は次のとおりです。
XSD_E:<element_local_name>@namespaceURI
任意の文字列値。文字列が長い場合は、改行して読みやすくできます。
送信キュー・スペース名。
「queue」
方式のサービスでは省略可能です。
送信キュー名。
「queue」
方式のサービスでは省略可能です。
応答キュー名。
「queue」
方式のサービスでは省略可能です。
エラー・キュー名。
「queue」
方式のサービスでは省略可能です。
受信キュー・スペース名。
「queue」
方式のサービスでは省略可能です。
受信キュー名。
「queue」
方式のサービスでは省略可能です。
このパラメータは、Oracle Tuxedoサービス・メタデータ・リポジトリ専用で、アプリケーションで使用するあらゆる文字列に対応できます。
Oracle Tuxedoでは、このパラメータは解釈されません。
このパラメータは、Oracle Tuxedoサービス・メタデータ・リポジトリ専用で、アプリケーションで使用するあらゆる文字列に対応できます。
Oracle Tuxedoでは、このパラメータは解釈されません。
このパラメータは省略可能です。このサービスで使用するFMLまたはFML32フィールドの検索に使用するフィールド表のカンマ区切りのリストを指定します。
fieldtbls
は、アプリケーション開発者が参照用に使用するパラメータです。
パラメータ・レベルのキーワードと値を使う
パラメータは、キーワード<param><=NAME>
または省略形<pn><=NAME>
から開始し、パラメータ・キーワードのリストが続きます。別の<param>
または<service>
キーワードで終了するか、またはファイルの終わりが検出されると終了します。パラメータは、<param><=NAME>
の後に任意の順序でリストできます。
注意:
1つのサービスで複数の<param>
キーワードを指定できます。つまり、ある特定のサービスに複数のパラメータが存在できます。たとえば、FML
またはVIEW
バッファを持つパラメータなどです。
Oracle Tuxedoサービス・メタデータ・リポジトリのパラメータ・レベル・キーワードを表8-4 に示します。
表8-4 パラメータ・レベル・キーワード、省略形、値
byte
、
short
、
integer
、
float
、
double
、
string
、
carray
、
dec_t
、
xml
、
ptr
、
fml32
、
view32
、
mbstring
。
注意:
パラメータ・タイプは、サービス・バッファ・タイプと一貫している必要があります。たとえば、FML16
バッファでは、byte (char)
、short
、integer
、long
、float
、 double
、string
、carray
のタイプのパラメータのみ使用できます。他のすべてのタイプのパラメータは許可されません。次のバッファ・タイプ/パラメータ・タイプの一致表を参照してください。
in
、
out
、err、
inout
、inerr、outerr、inouterr、
noaccess
。
in
- 入力のみに使用されるパラメータを示します。
out
- 出力のみに使用されるパラメータを示します。
err
- エラー出力のみに使用されるパラメータを示します。
inout
- 入力と出力の両方に使用されるパラメータを示します。
inerr
- 入力とエラー出力の両方に使用されるパラメータを示します。
outerr
- 出力とエラー出力の両方に使用されるパラメータを示します。
inouterr
- 入力、出力およびエラー出力に使用されるパラメータを示します。
noacesss
- 古いパラメータやビューの入力フィールドとして提供する必要のあるパラメータなど、入力で提供する必要はあるがサーバーでは参照されないパラメータを示します。
入力で期待されるパラメータのセットは、
in
、
inout
、inerr、inouterrまたは
noacces
sアクセスです
出力で戻されるパラメータのセットは、
out
、inout、outerrまたは
inouterr
アクセスで指定されます。
エラー出力で戻されるパラメータのセットは、
err
、inerr、outerrまたは
inouterr
アクセスで指定されます。
オカレンスの最大数(デフォルトは1)。無制限のオカレンスを表す値は0です。値の範囲は
[0, 32767]
です。
Oracle Joltリポジトリでは、このパラメータはテスト画面を書式設定するためにリポジトリ・エディタでのみ使用されます。Oracle Tuxedoリポジトリでは、このパラメータは表示用に格納され、
tmunloadrepos(1) 擬似コード生成オプションでも使用されます。
任意の文字列値。文字列が長い場合は、改行して読みやすくできます。
このオプションのパラメータは、パラメータに割り当てられているバイト数を示します。非数値パラメータの擬似コード生成に使用され、プログラマが参照する目的で使用できます。
carray
、
string
、
xml
、
mbstring
のパラメータ・タイプでは、この値が期待されます。
パラメータの最小限の指定回数。値の範囲は
[0, 32767]
です。
このオプションのパラメータは、
FML/FML32
フィールド
の場合にパラメータのフィールド数を示します。
注意:
環境FLDTBLDIR(32)
を使用してフィールド表ディレクトリを指定し、環境FIELDTBLS(32)
またはfieldtbl
サービス・レベル・キーワードを使用してフィールド表ファイルを指定することでfieldtbl
ファイルがすでに定義されている場合は、この情報を使用することをお薦めします。
注意:
fldnum
フィールドを構成した場合は、param
値ではなくfldnum
値に従って応答fldid
を受信します。
このパラメータは、ビュー構造メンバーではオプションです。フィールド・バッファ内のフィールド名を示すために使用されます。
「viewfile(5)」 を参照してください
このパラメータは、ビュー構造メンバーではオプションです。有効な値は、
'C'
、
'F'
、
'L'
、
'N'
、
'P'
、
'S'
のオプションの組合せです。
「viewfile(5)」 を参照してください。
このパラメータは、ビュー構造メンバーではオプションです。ビュー・メンバーのデフォルトのnull値を示します。
このパラメータはオプションで、分解FML32フィールドのXMLスキーマ情報を保存します。
注意:
このパラメータ・キーワードは、"servicemode=webservice"タイプのサービス定義(アウトバウンド・コールのSALTプロキシ・サービス)用に導入されました。パラメータ値は外部WSDLファイルの変換からOracle SALT wsdlcvtユーティリティで生成されます。このキーワード値を手動で指定または変更しないでください。
このパラメータはオプションで、分解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
表8-6 サービス・バッファ・タイプ(大文字で開始)/サービス・パラメータ・タイプ(小文字)の対応表II
Oracle Tuxedoサービス・メタデータ・リポジトリの構成
Oracle Tuxedoサービス・メタデータ・リポジトリを構成するには、次の操作が必要です。
UBBCONFIG(5) の*SERVERS
セクションにTMMETADATA
を追加します。
UBBCONFIG
で
tmloadcf(1) を実行します。
tmloadrepos(1)
を使用してサービス・パラメータ情報を作成し、メタデータ・リポジトリ・ファイルに入力します。
サーバーを起動します。
Oracle Tuxedoメタデータ・サーバーが実行されると、.TMMETAREPOS
サービスが自動的にアクティブになります。.TMMETAREPOS
はOracle Tuxedoシステム・サービスであり、変更できません。
サーバーに対して行われたすべてのリクエストは、先に到着したものから順に処理されます。
複数のOracle Tuxedoサービス・メタデータ・リポジトリ・サーバーの構成
特定のOracle Tuxedoノードで複数のTMMETADATA
サーバーを設定するには、2つの重要な構成ルールに従う必要があります。
一貫性のあるリクエスト結果を提供するために、各TMMETADATAサーバーは、同じメタデータ・リポジトリ・ファイルまたはファイルの正確なコピーにアクセスするように構成する必要があります。したがって、安定したバージョンのメタデータ・リポジトリを複数のTMMETADATAサーバー・アクセスで使用可能にすることを強くお薦めします。
特定のノード上の複数のTMMETADATA
サーバーに対して、権限設定を一貫して適用する必要があります(読取り専用または読取り/書込み)。
Oracle Tuxedoサービス・メタデータ・リポジトリ・ファイルへのアクセス
Oracle Tuxedoサービス・メタデータ・リポジトリは、サービス・メタデータ・リポジトリ・パラメータ情報を表示、更新、追加または削除するために、ネイティブおよびリモートのクライアント・アクセスを促進します。
関連項目
TMMETADATA(5) 、METAREPOS(5) 、tmloadrepos(1) 、tmunloadrepos(1) 、tpgetrepos(3c) 、tpsetrepos(3c)