TXCLOSE(3cbl)

名前

TXCLOSE() - リソース・マネージャ・セットのクローズ

形式

DATA DIVISION.
 * Include TX definitions. 
01 TX-RETURN-STATUS.
 COPY TXSTATUS. 
PROCEDURE DIVISION. 
CALL "TXCLOSE" USING TX-RETURN-STATUS.

機能説明

TXCLOSE() は、移植生の高い方法でリソース・マネージャ・セットをクローズします。 これにより、トランザクション・マネージャが呼び出されて、リソース・マネージャ固有の情報がトランザクション・マネージャ固有の方法で読み取られ、この情報が呼び出し元にリンクされたリソース・マネージャに渡されます。

TXCLOSE() は、呼び出し元にリンクされているリソース・マネージャをすべてクローズします。 この関数は、リソース・マネージャ固有の「クローズ」呼び出しの代わりに使用されるので、アプリケーション・プログラムは、移植性を損なう可能性のある呼び出しを使用することがなくなります。 リソース・マネージャは終了の内容がそれぞれで異なるため、個々のリソース・マネージャを「クローズ」するために必要な情報をリソース・マネージャごとに通知しなければなりません。

TXCLOSE() は、アプリケーションの制御スレッドがグローバル・トランザクションに関与する必要がなくなったときに呼び出してください。 呼び出し元がトランザクション・モードにあると、TXCLOSE() は異常終了します ([TX-PROTOCOL-ERROR] が返されます)。 したがって、現在のトランザクションに関与しない制御スレッドがあっても、リソース・マネージャは一切クローズされません。

TXCLOSE() が正常終了すると (TX-OK)、呼び出し元のスレッドにリンクしているリソース・マネージャはすべてクローズされます。

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

戻り値

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

エラー

次の条件が発生すると、TXCLOSE() は異常終了し、次のいずれかの負の値を返します。

関連項目