bea ホーム | 製品 | dev2dev | support | askBEA
BEA Logo Tuxedo
 ドキュメントのダウンロード   サイトマップ   用語集 
検索
0

Tuxedo COBOL リファレンス

 Previous Next Contents View as PDF  

TXSETTRANCTL(3cbl)

名前

TXSETTRANCTL()transaction_control 特性の設定

形式

DATA DIVISION.
* Include TX definitions.
01
TX-RETURN-STATUS.
COPY TXSTATUS.
01
TX-INFO-AREA.
COPY TXINFDEF.
PROCEDURE DIVISION.
CALL "TXSETTRANCTL" USING
TX-INFO-AREA TX-RETURN-STATUS.

機能説明

TXSETTRANCTL() は、TRANSACTION-CONTROL で指定されている値を transaction_control 特性に設定します。この特性は、TXCOMMIT() および TXROLLBACK() が、呼び出し元に制御を返す前に新しいトランザクションを開始するかどうかを決定します。TXSETTRANCTL() は、アプリケーション・プログラムがトランザクション・モードであるかどうかに関係なく、呼び出すことができます。この設定は、TXSETTRANCTL() がこの後で呼び出されて変更されるまで、有効です。

この特性の初期設定は TX-UNCHAINED です。

TRANSACTION-CONTROL の有効な設定を次に示します。

TX-UNCHAINED

このフラグは、TXCOMMIT() および TXROLLBACK() が、呼び出し元に制御を返す前に新しいトランザクションを開始しないことを示します。呼び出し元は、新しいトランザクションを開始するには、TXBEGIN() を発行しなければなりません。

TX-CHAINED

このフラグは、TXCOMMIT() および TXROLLBACK() が、呼び出し元に制御を返す前に新しいトランザクションを開始することを示します。

戻り値に使用されるレコードは、TX-RETURN-STATUS です。

戻り値

TXSETTRANCTL() は正常終了時には、負数でない値 TX-OK を返します。

エラー

次の条件が発生すると、TXSETTRANCTL()transaction_control 特性の設定を変更せずに次のいずれかの負の値を返します。

[TX-EINVAL]

TRANSACTION-CONTROL が、TX-UNCHAINEDTX-CHAINED のいずれでもありません。

[TX-PROTOCOL-ERROR]

この関数が不正なコンテキストで呼び出されました (たとえば、呼び出し元がまだ TXOPEN() を呼び出していない場合)。

[TX-FAIL]

トランザクション・マネージャが致命的エラーを検出しました。このエラーでは、トランザクション・マネージャは、アプリケーションのために作業を行うことができなくなります。エラーの正確な内容がログ・ファイルに書き込まれます。

関連項目

TXBEGIN(3cbl)TXCOMMIT(3cbl)TXOPEN(3cbl)TXROLLBACK(3cbl)TXINFORM(3cbl)

 

Back to Top Previous Next
Contact e-docsContact BEAwebmasterprivacy