名前
com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.get_proxys
形式
import com.fujitsu.ObjectDirector.EventService.ES.*; import com.fujitsu.ObjectDirector.EventService.ES.ChannelUtilPackage.*; public interface ChannelUtil extends org.omg.CORBA.Object{ public ProxyData[] get_proxys( ProxyKind kind); } class ProxyData { org.omg.CORBA.Object proxy; int time; int ipaddress; ProxyKind kind; };
機能説明
イベントチャネルに接続しているコンシューマ/サプライヤの接続情報を取得します。
パラメタ
取得するProxyオブジェクトのタイプ。
本パラメタに指定する値に応じて、取得する接続情報が異なります。以下に本パラメタに指定する値と復帰値情報の対応を示します。
kindに指定可能な値 | 復帰値情報 |
---|---|
ChannelUtilPackage.Proxykind.ALL_PROXYS | すべての接続情報を取得 |
ChannelUtilPackage.Proxykind.PROXY_CONSUMER | すべてのProxyConsumerの一覧を取得 |
ChannelUtilPackage.Proxykind.PROXY_SUPPLIER | すべてのProxySupplierの一覧を取得 |
ChannelUtilPackage.Proxykind.PROXY_PULL_CONSUMER_EVENT | CosEventChannelAdminのProxyPullConsumerの一覧を取得 |
ChannelUtilPackage.Proxykind.PROXY_PULL_SUPPLIER_EVENT | CosEventChannelAdminのProxyPullSupplierの一覧を取得 |
ChannelUtilPackage.Proxykind.PROXY_PUSH_CONSUMER_EVENT | CosEventChannelAdminのProxyPushConsumerの一覧を取得 |
ChannelUtilPackage.Proxykind.PROXY_PUSH_SUPPLIER_EVENT | CosEventChannelAdminのProxyPushSupplierの一覧を取得 |
ChannelUtilPackage.Proxykind.PROXY_PULL_CONSUMER_NOTIFY | CosNotifyChannelAdminのProxyPullConsumerの一覧を取得 |
ChannelUtilPackage.Proxykind.PROXY_PULL_SUPPLIER_NOTIFY | CosNotifyChannelAdminのProxyPullSupplierの一覧を取得 |
ChannelUtilPackage.Proxykind.PROXY_PUSH_CONSUMER_NOTIFY | CosNotifyChannelAdminのProxyPushConsumerの一覧を取得 |
ChannelUtilPackage.Proxykind.PROXY_PUSH_SUPPLIER_NOTIFY | CosNotifyChannelAdminのProxyPushSupplierの一覧を取得 |
ChannelUtilPackage.Proxykind.STRUCTURED_PROXY_PULL_CONSUMER | CosNotifyChannelAdminのStructuredProxyPullConsumerの一覧を取得 |
ChannelUtilPackage.Proxykind.STRUCTURED_PROXY_PULL_SUPPLIER | CosNotifyChannelAdminのStructuredProxyPullSupplierの一覧を取得 |
ChannelUtilPackage.Proxykind.STRUCTURED_PROXY_PUSH_CONSUMER | CosNotifyChannelAdminのStructuredProxyPushConsumerの一覧を取得 |
ChannelUtilPackage.Proxykind.STRUCTURED_PROXY_PUSH_SUPPLIER | CosNotifyChannelAdminのStructuredProxyPushSupplierの一覧を取得 |
ProxyData構造体の各メンバには以下の値が設定されます。
メンバ | 設定値 |
---|---|
Proxy | イベントチャネルに接続しているコンシューマ/サプライヤのオブジェクトリファレンス |
Time | イベントチャネルに接続された時間 |
ipaddress | イベントチャネルに接続しているコンシューマ/サプライヤのIPアドレス |
kind | イベントチャネルに接続しているコンシューマ/サプライヤのプロキシ種別 |
復帰値
正常終了した場合は、イベントチャネルに接続しているコンシューマ/サプライヤの接続情報が返されます。
異常終了した場合は、例外が発生します。
システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。
注意
IPv6環境のIPアドレスで運用している場合、メンバ“ipaddress”には“0”が格納されます。
IPv6環境で使用する場合は、com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.get_proxys6()を使用してください。
名前
com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.get_proxys6
形式
import com.fujitsu.ObjectDirector.EventService.ES.*; import com.fujitsu.ObjectDirector.EventService.ES.ChannelUtilPackage.*; public interface ChannelUtil extends org.omg.CORBA.Object{ public ProxyData6[] get_proxys6( ProxyKind kind); } class ProxyData6 { org.omg.CORBA.Object proxy; int time; byte[] ipaddress; int ip_format; ProxyKind kind; };
機能説明
イベントチャネルに接続しているコンシューマ/サプライヤの接続情報を取得します。
ip_formatには、ipaddressがIPv6形式で格納されている場合は“1”が、IPv4形式の場合は“0”が入力されます。
パラメタ
取得するProxyオブジェクトのタイプ。
本パラメタに設定する値に応じて、取得する接続情報が異なります。kindに指定した値と復帰値情報の対応については、“3.22.2.1 com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.get_proxys()”の“kind値と復帰値情報の対応”を参照してください。
復帰値
正常終了した場合は、イベントチャネルに接続しているコンシューマ/サプライヤの接続情報が返されます。
異常終了した場合は、例外が発生します。
システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。
注意
IPv6環境で運用している場合は、IPv4クライアントのメンバ“ipaddress”にはIPv4射影アドレスが格納されます。IPv6環境で運用する設定については、“チューニングガイド”の“Interstageのチューニング”-“IPv6環境での運用について”、および“CORBAサービスの動作環境ファイル”-“config”(IP-versionパラメタ)を参照してください。
名前
com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.get_consumer_count
形式
import com.fujitsu.ObjectDirector.EventService.ES.*; public interface ChannelUtil extends org.omg.CORBA.Object{ int get_consumer_count(); }
機能説明
イベントチャネルに接続しているコンシューマ数を取得します。
復帰値
正常終了した場合は、イベントチャネルに接続しているコンシューマ数が返されます。
異常終了した場合は、例外が発生します。
システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。
名前
com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.get_supplier_count
形式
import com.fujitsu.ObjectDirector.EventService.ES.*; public interface ChannelUtil extends org.omg.CORBA.Object{ int get_supplier_count();
}
機能説明
イベントチャネルに接続しているサプライヤ数を取得します。
復帰値
正常終了した場合は、イベントチャネルに接続しているサプライヤ数が返されます。
異常終了した場合は、例外が発生します。
システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。
名前
com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.get_queue_length
形式
import com.fujitsu.ObjectDirector.EventService.ES.*; public interface ChannelUtil extends org.omg.CORBA.Object{ int get_queue_length(); }
機能説明
イベントチャネルにキューイングされているイベントデータ数を取得します。
復帰値
正常終了した場合は、イベントチャネルにキューイングされているイベントデータ数が返されます。
異常終了した場合は、例外が発生します。
システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。
名前
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); }
機能説明
チャネルに対して、ローカルトランザクションの開始を通知します。
コンシューマの場合、com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_commit()またはcom.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_rollback()までの間には、以下のメソッドを発行することができます。
org.omg.CosNotifyComm.StructuredPullSupplier.pull_structured_event()
org.omg.CosNotifyComm.StructuredPullSupplier.try_pull_structured_event()
サプライヤの場合、com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_commit()またはcom.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_rollback()までの間には、以下のメソッドを発行することができます。
また、本メソッド発行後、com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_commit()またはcom.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_rollback()が発行されない場合は、ローカルトランザクションタイムアウト時間が経過した時点で、ノーティフィケーションサービスにより自動的にrollbackされます。
なお、本メソッドは、同一proxyに対して、2重に発行できません。
パラメタ
復帰値
正常終了した場合は、ありません。
異常終了した場合は、例外が発生します。
システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。
名前
com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_commit
形式
import com.fujitsu.ObjectDirector.EventService.ES.*; import com.fujitsu.ObjectDirector.EventService.ES.ChannelUtilPackage.*; public interface ChannelUtil extends org.omg.CORBA.Object { public void local_commit(org.omg.CORBA.Object proxy); }
機能説明
チャネルに対して、ローカルトランザクションの完了を通知します。
コンシューマの場合、本メソッドの完了時点でイベントチャネルからメッセージの受信が完了します。
サプライヤの場合、本メソッドの完了時点でイベントチャネルからの配信が完了します。
パラメタ
復帰値
正常終了した場合は、ありません。
異常終了した場合は、例外が発生します。
システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。
名前
com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_rollback
形式
import com.fujitsu.ObjectDirector.EventService.ES.*; import com.fujitsu.ObjectDirector.EventService.ES.ChannelUtilPackage.*; public interface ChannelUtil extends org.omg.CORBA.Object { public void local_rollback(org.omg.CORBA.Object proxy); }
機能説明
チャネルに対して、ローカルトランザクションのキャンセルを通知します。本メソッドを発行することにより、ノーティフィケーションサービスのイベントチャネルはcom.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_begin()発行前の状態に戻ります。
パラメタ
復帰値
正常終了した場合は、ありません。
異常終了した場合は、例外が発生します。
システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。
名前
com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.pull_cancel
形式
import com.fujitsu.ObjectDirector.EventService.ES.*; import com.fujitsu.ObjectDirector.EventService.ES.ChannelUtilPackage.*; public interface ChannelUtil extends org.omg.CORBA.Object { public void pull_cancel(org.omg.CORBA.Object proxy); }
機能説明
本メソッドは、対象proxyのpull待ち状態(pullおよびcom.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.pull_wait()メソッド発行による待ち合わせ状態)をキャンセルします。
パラメタ
org.omg.CosNotifyChannelAdmin.ConsumerAdmin.obtain_notification_pull_supplier()で取得したチャネルのオブジェクトリファレンス。
注)pullおよびcom.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.pull_wait()で指定したオブジェクトリファレンスと同一のオブジェクトリファレンスを指定してください。
復帰値
正常終了した場合は、ありません。
異常終了した場合は、例外が発生します。
システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。
名前
com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.pull_wait
形式
import com.fujitsu.ObjectDirector.EventService.ES.*; import com.fujitsu.ObjectDirector.EventService.ES.ChannelUtilPackage.*; public interface ChannelUtil extends org.omg.CORBA.Object { public void pull_wait(org.omg.CORBA.Object proxy) throws org.omg.CosEventComm.Disconnected; }
機能説明
本メソッドは、対象proxyがpullまたはtry_pullでデータ取得が可能な状態となるまで待ち合わせます。メソッド実行後、データ取得が可能な状態となった時点で呼び出し元に復帰します。
対象proxyがすでにpullでデータ取得可能な状態である場合は、即時復帰します。pullと同様、待ち合わせ時間内にデータが取得可能状態にならない場合は、タイムアウトで復帰します。
パラメタ
org.omg.CosNotifyChannelAdmin.ConsumerAdmin.obtain_notification_pull_supplier()で取得したチャネルのオブジェクトリファレンス
復帰値
正常終了した場合は、ありません。
異常終了した場合は、例外が発生します。
ユーザ例外の場合は、以下の例外が発生します。
イベントチャネルに接続されていません。
イベントチャネル生成時にコネクション情報を自動回収する処理を有効とした場合(esmkchnlコマンド実行時に-autodisconオプションを指定した場合)は、CORBAサービスのクライアント側無通信監視時間超過によりコネクションが切断された可能性があります。継続して通信する場合は、イベントチャネルへの接続から行ってください。
システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。