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を指定してください。