Interstage Application Server リファレンスマニュアル(API編)

1.20.2 Controlインタフェース

1.20.2.1 CosTransactions_Control_get_terminator

名前

CosTransactions_Control_get_terminator

形式

#include  "orb.h"
#include  "CosTransactions.h"
CosTransactions_Terminator CosTransactions_Control_get_terminator(
                              CosTransactions_Control  control,
                              CORBA_Environment       *env);

機能説明

トランザクションの完了を行うTerminatorオブジェクトを返します。

パラメタ

control

Currentインタフェースのget_control機能で取得したControlオブジェクトを指定します。

*env

例外情報を獲得するためにCORBA_Environment構造体を参照するポインタを指定します。

復帰値

正常終了した場合は、env構造体の_majorにCORBA_NO_EXCEPTIONが設定され、復帰値にTerminatorオブジェクトを返します。異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONまたはCORBA_USER_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。

ユーザ例外の場合、以下の詳細情報が設定されます。

ex_CosTransactions_Unavailable

Terminatorオブジェクトを利用できません。

システム例外の場合、以下の詳細情報が設定されます。

ex_CORBA_StExcep_NO_IMPLEMENT：

OTSシステムが起動されていません。

ex_CORBA_StExcep_COMM_FAILURE：

通信異常が発生しました。

ex_CORBA_StExcep_NO_RESOURCES

資源不足が発生しました。

ex_CORBA_StExcep_NO_MEMORY：

動的メモリの獲得に失敗しました。

ex_CORBA_StExcep_INTERNAL：

CORBAサービスで異常が発生しました。

1.20.2.2 CosTransactions_Control_get_coordinator

名前

CosTransactions_Control_get_coordinator

形式

#include  "orb.h"
#include  "CosTransactions.h"
CosTransactions_Coordinator  CosTransactions_Control_get_coordinator(
                              CosTransactions_Control   control,
                              CORBA_Environment       *env);

機能説明

トランザクションをコーディネイトするCoordinatorオブジェクトを返します。
このCoordinatorオブジェクトを使用してサーバアプリケーションでトランザクションの同期をとる運用ができるようになります。

パラメタ

control

Currentインタフェースのget_control機能で取得したControlオブジェクトを指定します。

*env

例外情報を獲得するためにCORBA_Environment構造体を参照するポインタを指定します。

復帰値

正常終了した場合は、env構造体の_majorにCORBA_NO_EXCEPTIONが設定され、復帰値にCoordinatorオブジェクトを返します。異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONまたはCORBA_USER_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。

ユーザ例外の場合、以下の詳細情報が設定されます。

ex_CosTransactions_Unavailable

Coordinatorオブジェクトを利用できません。

システム例外の場合、以下の詳細情報が設定されます。

ex_CORBA_StExcep_NO_IMPLEMENT：

OTSシステムが起動されていません。

ex_CORBA_StExcep_COMM_FAILURE：

通信異常が発生しました。

ex_CORBA_StExcep_NO_RESOURCES

資源不足が発生しました。

ex_CORBA_StExcep_NO_MEMORY：

動的メモリの獲得に失敗しました。

ex_CORBA_StExcep_INTERNAL：

CORBAサービスで異常が発生しました。