Oracle SALT SCA ATMI バインディングのリファレンス

以下の節では、SCA ATMI バインディングのリファレンス情報について説明します。

SCA ATMI バインディングスキーマ

コードリスト F-1 に、ATMI バインディングの要素 (<binding.atmi>) がどのように定義されているかを示します。これは、文法の使用方法と有効なパラメータを示すための擬似スキーマです。

	<map target="name">...</map>*
	<serviceType target="name">...</serviceType>*
	<inputBufferType target="name">...</inputBufferType>*
	<outputBufferType target="name">...</outputBufferType>*
	<errorBufferType target="name">...</errorBufferType>*
	<workStationParameters>?
		<networkAddress>...</networkAddress>?
		<secPrincipalName>...</secPrincipalName>?
		<secPrincipalLocation>...</secPrincipalLocation>?
		<secPrincipalPassId>...</secPrincipalPassId>?
		<encryptBits>...</encryptBits>?
	</workStationParameters>
	<authentication>?
		<userName>...</userName>?
		<clientName>...</clientName>?
		<groupName>...</groupName>?
		<passwordIdentifier>...</passwordIdentifier>?
		<userPasswordIdentifier>...
						</userPasswordIdentifier>?
	</authentication>
	<fieldTablesLocation>...</fieldTablesLocation>?
	<fieldTables>...</fieldTables>?
	<fieldTablesLocation32>...</fieldTablesLocation32>?
	<fieldTables32>...</fieldTables32>?
	<viewFilesLocation>...</viewFilesLocation>?
	<viewFiles>...</viewFiles>?
	<viewFilesLocation32>...</viewFilesLocation32>?
	<viewFiles32>...</viewFiles32>?
	<remoteAccess>...</remoteAccess>?
	<transaction timeout="xsd:long"/>?
</binding.atmi>

SCA ATMI バインディングの属性の説明

</binding.atmi/@requires>

この属性に legacy 値を使用すると、既存の Tuxedo サービスとの相互運用を実現できます。指定しない場合、通信には SCA 間のセマンティクスを使用するものとみなされ、/binding.atmi/map 要素が定義されている場合を除き、実際の Tuxedo サービス名は /service/@name または /reference/@name と実際のメソッド名から構成されます (コードリスト F-1 を参照)。この属性に legacy 値を指定し、呼び出されたメソッドに /binding.atmi/map 要素が定義されていない場合、実行時の動作は以下のようになります。

<reference> 要素の場合は、/reference/@name 内に指定されている値を使用し、使用するインタフェースメソッドに基づくセマンティクスで Tuxedo 呼び出しを実行します。
<service> 要素の場合は、/binding.atmi/map 要素に指定されている Tuxedo サービスが公開され、/binding.atmi/map/@target 属性に指定されているメソッドにマップされます。

この属性にトランザクション値を使用すると、このバインディングの使用時にバインディング拡張が従うべきトランザクション動作を指定できます。有効な値は以下のとおりです。

指定しない (値なし) - すべてのトランザクション動作は Tuxedo コンフィグレーションによって制御されます。Tuxedo コンフィグレーションでトランザクションがサポートされている場合は、トランザクションが存在していればそのトランザクションを伝播できます。Tuxedo コンフィグレーションでトランザクションがサポートされていないのにトランザクションが存在する場合はエラーになります。ただし、既に存在しているトランザクションでないと開始できません。
suspendsTransaction - 呼び出されたサービスにトランザクションコンテキストが伝播されます。<service> 要素の場合は、アプリケーションコードを呼び出す前に、既に存在しているトランザクションが自動的に中断されます。トランザクションは、呼び出しの結果に関係なく後で再開されます。<reference> 要素の場合は、TPNOTRAN フラグを指定して tpcall() を実行したのと同じになります。
propagatesTransaction - <reference> 要素にのみ適用できます。<service> 要素では無視されます。トランザクションが存在しない場合は新しいトランザクションが開始されます。存在する場合は、既存のトランザクションに参加します。

このような動作は、UBBCONFIG ファイルで <service> 要素を AUTOTRAN にコンフィグレーションすることで、コンポーネントまたはコンポジット内で取得できます。Tuxedo サーバが SCA コンポーネントをホストしており、UBBCONFIG ファイルでトランザクショングループにコンフィグレーションされていない場合はエラーが生成されます。

</binding.atmi/tuxconfig>

クライアントのみのプロセスにおいて、/binding.atmi/workstationParameters が設定されていない場合に、<reference> 要素内で使用します。この属性は、プロセスが参加すべき Tuxedo アプリケーションを示します。プロセスを複数のアプリケーションに参加させたり、参加するアプリケーションを再起動なしで切り替えたりすることも可能です。

設定しない場合は、TUXCONFIG 環境変数が使用されます。この属性が必要とされるにもかかわらず設定されていない場合は、プロセスが終了してエラーが返されます。

</binding.atmi/map>

<reference> 要素の場合の </binding.atmi/map> は、/binding.atmi/map/@target 値に対応する呼び出しの実行時に使用すべき Tuxedo サービス名を提供します。この値は、呼び出されるメソッドの名前になります。

<service> 要素の場合の </binding.atmi/map> は、 /binding.atmi/map/@target 値に応じて公開すべき Tuxedo サービス名を提供します。

/binding.atmi/map/@target 値は、対応するサービスインタフェースの名前と一致させる必要があります。

/binding.atmi/map 要素が存在する場合は、Tuxedo サービス名をマッピングするいかなるサービスやメソッドよりも優先されます。</binding.atmi/@requires> 属性を参照してください。

</binding.atmi/serviceType>

処理する呼び出しのタイプを指定する省略可能な要素です。有効な値は以下のとおりです。

Oneway - 応答を期待しない呼び出しです。
RequestResponse - 通常の呼び出しパラダイムです。これがデフォルト値です。

</binding.atmi/inputBufferType>、</binding.atmi/outputBufferType>、</binding.atmi/errorBufferType>

プロセスが交換するバッファのタイプを指定する省略可能な要素です。inputBufferType 要素は、バインディング拡張がリクエストのタイプを特定または確認するために使用します。

outputBufferType 要素は、バインディング拡張が応答のタイプを特定または確認するために使用します。

errorBufferType 要素は、クライアントが受け取った (またはサーバが送出した) 例外のデータ部分に指定されているバッファのタイプを特定するために使用します。

表 F-1 に、サポートされる値とそれぞれに対応する Tuxedo バッファタイプを示します。不正な値や構文が含まれていると、実行時に検出されて呼び出しが失敗します。指定しない場合、デフォルト値 STRING が使用されます。

/binding.atmi/bufferType の値

Tuxedo バッファタイプ

説明

STRING

CARRAY

X_OCTET

VIEW

形式は VIEW/<subtype>

X_C_TYPE

形式は X_C_TYPE/<subtype>

X_COMMON

形式は X_COMMON/<subtype>

VIEW32

形式は VIEW32/<subtype>

XML

FML

形式は次のとおり。

FML/<subtype>、<subtype> は省略可能。

<subtype> 値には、メッセージ (リクエストまたは応答) が XML スキーマ内に記述されている場合に、そのメッセージに使用する SDO タイプを指定できる。

注意 : FML32 <subtype> は、JATMI バインディングには使用できない。

FML32

形式は次のとおり。

FML32/<subtype>、<subtype> は省略可能。

注意 : FML32 <subtype> は、JATMI バインディングには使用できない。

MBSTRING

</binding.atmi/workStationParameters>

Tuxedo WorksStation プロトコルに固有のパラメータを指定する省略可能な要素です。参照でのみ使用します。

/binding.atmi/workStationParameters/networkAddress

このアプリケーションを接続するワークステーションリスナのアドレスです。Tuxedo ワークステーションソフトウェアで認識可能なすべてのアドレス形式を使用できます。もっとも一般的なアドレス形式は次のとおりです。

//<hostname or IP address>:<port>.

詳細については、SALT の『プログラミングガイド』を参照してください。

必要に応じて複数のアドレスを指定できます。その場合は、WSNADDR のパス名のリストをカンマ区切りで指定します。接続が確立されるまで、それらのアドレスが順番に試行されます。アドレスリストのすべてのメンバーは、ネットワークアドレスをパイプで区切った上で、グループ全体を丸かっこで囲むことで指定できます。次に例を示します。

Tuxedo では、丸かっこ内のアドレスがランダムに選択されます。これにより、複数のリスナプロセスの間で負荷をランダムに分散できます。接続が確立されるまで、それらのアドレスが順番に試行されます。

ipv6 をサポートするバージョンの Tuxedo では、対応するアドレス形式もサポートされます。形式は、Tuxedo /WS クライアントの WSNADDR で使用されるアドレスと同じです。

secPrincipalName、secPrincipalLocation、secPrincipalPassId

これらのパラメータは、ワークステーションクライアントで SSL 接続が必要とされる場合に必要なパラメータを指定します。パスワードを別のファイルに格納し、コールバックメカニズムを使用してアクセスできます。デフォルトのコールバックでは、scapasswordtool コマンドを使用して管理する password.store ファイルを使用します。詳細については、SALT の『プログラミングガイド』を参照してください。

encryptBits

クライアント接続がネゴシエートを試みる暗号化の強度を指定します。形式は <minencryptbits>/<maxencprytbits> で、値としては数値を指定します (たとえば 128/128)。無効な値を指定すると、コンフィグレーション例外が送出されます。有効な値は、0 (暗号化を使用しない)、40、56、128、または 256 です (指定した値が暗号化キー内の有効ビットの数である場合)。

</binding.atmi/authentication>

参照タイプの呼び出しで、Tuxedo アプリケーションとの接続の確立に使用するセキュリティパラメータを指定します。以下の値は、それぞれ TPINFO 構造要素 usrname、cltname、grpname、および passwd に対応します (詳細については、『Oracle Tuxedo C リファレンス』の「tpinit(3c)」を参照してください)。

/binding.atmi/authentication/userName
/binding.atmi/authentication/clientName
/binding.atmi/authentication/groupName
/binding.atmi/authentication/passwordIdentifier-(アプリケーションパスワード)
/binding.atmi/authentication/userPasswordIdentifier-(ユーザ認証ごとのユーザパスワード)

パスワードはクリアテキストでは保存されませんが、識別子を使用してルックアップされます。パスワードの取得にはコールバック関数を使用できます。詳細については、Oracle SALT の『リファレンスガイド』の「setSCAPasswordCallback()」を参照してください。

パスワードは、デフォルトでは /reference/binding.atmi/authentication/passwordIdentifier または /reference/binding.atmi/authentication/userPasswordIdentifier 要素と同じディレクトリにあるパスワードストアファイルに、暗号化された状態で保管されています。この識別子は、認証の実行時に必要に応じて読み込まれます。

詳細については、Oracle SALT の『リファレンスガイド』の scapasswordtool および setSCAPasswordCallback(3c) を参照してください。

注意 :

この情報が SCA カーネルでサポートされる場合は、ポリシーセットと目的に基づいて処理する必要があります。

</binding.atmi/fieldTablesLocation>

ローカルファイルシステム内で、フィールドテーブルを検索するディレクトリを指定する省略可能な要素です。相対パスを指定した場合は、$APPDIR からの相対ディレクトリが検索されます。それ以外の場合は絶対パスとみなされます。

</binding.atmi/fieldTablesLocation32>

</binding.atmi/fieldTables>

使用できる FML フィールドテーブルを指定する省略可能な要素です。フィールドテーブルは、/binding.atmi/fieldTablesLocation 要素で指定した場所から検索されます。

/binding.atmi/bufferType 値が FML で、この要素が指定されていないか無効な場合 (つまり、指定されたテーブルが見つからないか、見つかったものがフィールドテーブルでない場合) は、クライアントプロセスの初期化時かサーバプロセスの起動時にエラーが表示されます。

</binding.atmi/fieldTables32>

</binding.atmi/viewFilesLocation>

ローカルファイルシステム内で、ビューテーブルを検索するディレクトリを指定する省略可能な要素です。相対パスを指定した場合は、$APPDIR からの相対ディレクトリが検索されます。それ以外の場合は絶対パスとみなされます。

</binding.atmi/viewFilesLocation32>

</binding.atmi/viewFiles>

影響を受けるコンポーネントで使用する VIEW ファイルを指定する省略可能な要素です。/binding.atmi/bufferType 値が VIEW で、この要素が指定されていないか無効な場合 (つまり、指定されたフィールドが見つからないか、見つかったものがビューファイルでない場合) は、クライアントプロセスの実行時かサーバプロセスの起動時にエラーが表示されます。

</binding.atmi/viewFiles32>

</binding.atmi/remoteAccess>

通信プロトコルとして以下の値のいずれかを指定する省略可能な要素です。デフォルトは Native です。

Native - コンポーネントがネイティブな Tuxedo 通信 (IPC キュー) を使用することを示します。
WorkStation - コンポーネントが Tuxedo /WS 通信プロトコルを使用することを示します。

この値を設定した場合、バインディング拡張は /binding.atmi/workStationParameters 要素が設定されていて有効かどうかも確認します。設定されていないか無効な場合は、実行時エラーメッセージが生成されます。

</binding.atmi/transaction/@timeout>

トランザクションがタイムアウトするまでの実行時間を秒単位で指定します。この属性は、グローバルトランザクションを開始するコンポーネントやクライアントに影響します。<reference> コンポーネントの場合は必須です。<service> コンポーネントに設定した場合は無視されます。また、トランザクションがすでに開始されていたコンポーネントでも無視されます。トランザクションを開始する必要があり、この属性が存在しない場合 (たとえば「requires=propagatesTransaction」が設定されている場合) は、コンフィグレーションエラーが発生します。

リファレンス ガイド