名前

TPSCMT()−TPCOMMIT の終了時期の設定

形式

01 TPCMTDEF-REC.
 COPY TPCMTDEF. 
 
01 TPSTATUS-REC.
 COPY TPSTATUS.
 
CALL "TPSCMT" USING TPCMTDEF-REC TPSTATUS-REC.

機能説明

TPSCMT() は TP-COMMIT-CONTROL 特性を TPCMTDEF-REC に指定されている値に設定します。この TP-COMMIT-CONTROL 特性は、制御をその呼び出し元に返す際の TPCOMMIT() の動作に影響します。プログラムがトランザクション・モードにあるかどうかに関係なく、プログラムから TPSCMT() を呼び出すことができます。他のプログラムがコミットしなければならないトランザクションに呼び出し元が参加している場合は、TPSCMT() を呼び出してもそのトランザクションに影響を与えないことに注意してください。むしろ、呼び出し元がコミットするその後のトランザクションに影響を与えます。

ほとんどの場合、トランザクションは、BEA Tuxedo ATMI のプログラムが TPCOMMIT() を呼び出したときにのみコミットされます。ただし、例外が 1 つあります。すなわち、UBBCONFIG ファイルの SERVICES セクションで AUTOTRAN 変数が使用可能になっているために、サービスがトランザクション・モードでディスパッチされる場合は、そのトランザクションは TPRETURN() の呼び出し時点で完了します。TPFORWAR() が呼び出された場合、そのトランザクションは、サーバが最終的に TPRETURN() を呼び出すことによって終了します。このため、TPRETURN() を呼び出すサービスにおける TP-COMMIT-CONTROL 特性の設定内容により、TPCOMMIT() がサーバ内からいつ制御を返すかが決まります。TPCOMMIT() がヒューリスティックなエラー・コードを返した場合、サーバはメッセージをログ・ファイルに書き込みます。

次に、TPCMTDEF-REC の有効な設定の一覧を示します。

戻り値

TPSCMT() は正常終了時には、TP-STATUS に [TPOK] を設定し、TP-COMMIT-CONTROL 特性の以前の値を返します。

エラー

次の条件が発生すると、TPSCMT() は異常終了し、TP-STATUS に次の値を設定します。

注意事項

関連項目