Hitachi

OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 プログラム作成リファレンス C言語編


X/Openに準拠した関数

X/Openに準拠した関数(XATMIインタフェース,TXインタフェース)と機能の対応を表4-1に,OpenTP1のUAPとの関係を表4-2に示します。

表4‒1 X/Openに準拠した関数と機能の対応

機能

X/Openに準拠した関数名と機能

XATMIインタフェース

tpacall()

リクエスト/レスポンス型サービスの呼び出し

tpalloc()

型付きバッファの割り当て

tpadvertise()

サービス名の広告

tpcall()

リクエスト/レスポンス型サービスの呼び出しと応答の受信

tpcancel()

リクエスト/レスポンス型サービスのキャンセル

tpconnect()

会話型サービスとのコネクションの確立

tpdiscon()

会話型サービスとのコネクションの切断

tpfree()

型付きバッファの解放

tpgetrply()

リクエスト/レスポンス型サービスからの非同期応答の受信

tprealloc()

型付きバッファのサイズの変更

tprecv()

会話型サービスからのメッセージの受信

tpreturn()

サービス関数からのリターン

tpsend()

会話型サービスへのメッセージの送信

tpservice()

サービス関数のテンプレート

tptypes()

型付きバッファの情報の取得

tpunadvertise()

サービス名の広告の取り消し

TXインタフェース

tx_begin()

トランザクションの開始

tx_close()

リソースマネジャ集合のクローズ

tx_commit()

トランザクションのコミット

tx_info()

現在のトランザクションに関する情報の返却

tx_open()

リソースマネジャ集合のオープン

tx_rollback()

トランザクションのロールバック

tx_set_commit_return()

commit_return特性の設定

tx_set_transaction_control()

transaction_control特性の設定

tx_set_transaction_timeout()

transaction_timeout特性の設定

表4‒2 X/Openに準拠した関数とOpenTP1のUAPとの関係

X/Openに準拠した関数

SUP

SPP

MHP

オフラ

インの業務をするUAP

Trnの処理の範囲でない

Trnの処理範囲(root)

Trnの処理の範囲でない

Trnの範囲

Trnの処理の範囲でない

Trnの処理範囲(root)

root

root以外

tpacall

tpadvertise

※1

※1

※1

tpalloc

tpcall

tpcancel

tpconnect

tpdiscon

tpgetrply

tpfree

tprecv

tprealloc

tpreturn

※2

※2

※2

tpsend

tpservice※3

※3

※3

※3

※3

※3

tptypes

tpunadvertise

※1

※1

※1

tx_begin※4

tx_close

tx_commit

TX_CHAINED指定※4

tx_commit

TX_UNCHAINED指定※4

tx_info

tx_open

tx_rollback

TX_CHAINED指定※4

tx_rollback

TX_UNCHAINED指定※4

tx_set_commit_return※4

tx_set_transaction_control※4

tx_set_transaction_timeout※4

(凡例)

Trn:トランザクション

root:ルート

○:該当する条件で呼び出せます。

−:該当する条件では呼び出せません。

MHPの「Trn(トランザクション)処理の範囲でない」とは,非トランザクション属性のMHP,またはMHPのメイン関数の範囲を示します。

注※1

※1で示す関数は,サービス関数の中でだけ,呼び出せます。

注※2

※2で示す関数は,XATMIインタフェースのサービス関数をリターンするためだけに使います。

注※3

tpserviceは,サービス関数の実体です。

注※4

※4で示す関数を呼び出すUAPは,ユーザサービス定義でatomic_update=Yを指定してください。