3.22.2.6 com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local

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

目次索引

第3章 Javaインタフェース

> 3.22 接続情報取得関数インタフェース

> 3.22.2 com.fujitsu.ObjectDirector.EventService.ESクラス

3.22.2.6 com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_begin()

名前

  com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_begin

形式

  import  com.fujitsu.ObjectDirector.EventService.ES.*;
  import  com.fujitsu.ObjectDirector.EventService.ES.ChannelUtilPackage.*;
  public  interface ChannelUtil extends org.omg.CORBA.Object {
      public  void local_begin(org.omg.CORBA.Object  proxy)
          throws org.omg.CosEventComm.Disconnected;
  }

機能説明

　チャネルに対して、ローカルトランザクションの開始を通知します。
　コンシューマの場合、com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_commit()またはcom.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_rollback()までの間には、pullメソッドまたはtry_pullメソッドを発行することができます。
　サプライヤの場合、com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_commit()またはcom.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_rollback()までの間には、pushメソッドを発行することができます。
　また、本メソッド発行後、com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_commit()またはcom.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_rollback()が発行されない場合は、ローカルトランザクションタイムアウト時間が経過した時点で、ノーティフィケーションサービスにより自動的にrollbackされます。
　なお、本メソッドは、同一proxyに対して、2重に発行できません。

パラメタ

　proxy: 　org.omg.CosNotifyChannelAdmin.ConsumerAdmin.obtain_notification_pull_supplier()、またはorg.omg.CosNotifyChannelAdmin.SupplierAdmin.obtain_notification_push_consumer()で取得したチャネルのオブジェクトリファレンス

復帰値

　正常終了した場合は、ありません。
　異常終了した場合は、例外が発生します。

　ユーザ例外の場合、以下の例外が発生します。

　org.omg.CosEventComm.Disconnected: 　イベントチャネルに接続されていません。

　システム例外の場合、以下の例外が発生します。

　org.omg.CORBA.NO_RESOURCES: 　以下のいずれかの可能性があります。
　－　イベントチャネルが閉塞終了中である。
　
　－　イベントチャネルが閉塞／自動閉塞されている。
　org.omg.CORBA.BAD_OPERATION: 　ローカルトランザクションが使用できない環境です。
　org.omg.CORBA.COMM_FAILURE: 　通信異常が発生しました。
　org.omg.CORBA.NO_IMPLEMENT: 　イベントチャネルが起動されていません。
　org.omg.CORBA.NO_MEMORY: 　メモリ不足が発生しました。

目次索引