ページの先頭行へ戻る
Interstage Application Server リファレンスマニュアル(API編)
Interstage
第3章 Javaインタフェース > 3.19 ロードバランス機能インタフェース > 3.19.1 ロードバランスオプションインタフェース
前次

3.19.1 ロードバランスオプションインタフェース

3.19.1.1 com.fujitsu.ObjectDirector.ISOD.LBO.create_LBG()

名前

com.fujitsu.ObjectDirector.ISOD.LBO.create_LBG

形式

public com.fujitsu.ObjectDirector.ISOD.LBG create_LBG(org.omg.CosNaming.NamingContext nc, 
      org.omg.CosNaming.NameComponent[] name, 
      com.fujitsu.ObjectDirector.ISOD.LBOPackage.LoadBalanceType loadbalancetype, 
      org.omg.CORBA.Object defaultobjref) throws 
com.fujitsu.ObjectDirector.ISOD.LBOPackage.NotFound, 
com.fujitsu.ObjectDirector.ISOD.LBOPackage.CannotProceed, 
com.fujitsu.ObjectDirector.ISOD.LBOPackage.InvalidName, 
com.fujitsu.ObjectDirector.ISOD.LBOPackage.AlreadyExist, 
com.fujitsu.ObjectDirector.ISOD.LBOPackage.InvalidType, 
com.fujitsu.ObjectDirector.ISOD.LBOPackage.BadObject, 
com.fujitsu.ObjectDirector.ISOD.LBOPackage.OperationBusy;

機能説明

本関数は、ロードバランスオブジェクトグループを作成し、ネーミングサービスに登録します。ncで指定されたネーミングコンテキスト配下にnameで指定された名前で登録します。

パラメタ

nc

ネーミングコンテキストオブジェクト。

name

作成するロードバランスオブジェクトグループ名。
NameComponentオブジェクトの配列として指定します。

loadbalancetype

com.fujitsu.ObjectDirector.ISOD.LBOPackage.LoadBalanceType.roundrobinを指定します。

defaultobjref

ロードバランス機能が動作していない場合に、ネーミングサービスが返却するオブジェクトリファレンス（デフォルトオブジェクトリファレンス）。
nullを指定した場合、かつロードバランス機能が動作していない場合は、ネーミングサービスからはオブジェクトリファレンスが返却されません。
このオブジェクトリファレンスは、com.fujitsu.ObjectDirector.ISOD.LBG.bind()およびcom.fujitsu.ObjectDirector.ISOD.LBG.unbind()では、登録および削除はできません。デフォルトオブジェクトリファレンスは、ロードバランスオブジェクトグループ作成後に、com.fujitsu.ObjectDirector.ISOD.LBG.rebind_default()を使用して変更することができます。

復帰値

正常終了した場合は、生成したロードバランスオブジェクトグループのオブジェクトリファレンスが返却されます。
異常終了した場合は、以下の例外が発生します。

com.fujitsu.ObjectDirector.ISOD.LBOPackage.NotFound

nで指定したネーミングコンテキストが見つかりません。

com.fujitsu.ObjectDirector.ISOD.LBOPackage.CannotProceed

ncで指定されたネーミングコンテキストが存在しません。

com.fujitsu.ObjectDirector.ISOD.LBOPackage.InvalidName

名前の指定に誤りがあります。

com.fujitsu.ObjectDirector.ISOD.LBOPackage.AlreadyExist

指定された名前とオブジェクトのバインディングがすでに存在します。

com.fujitsu.ObjectDirector.ISOD.LBOPackage.InvalidType

ロードバランスタイプの指定に誤りがあります。

com.fujitsu.ObjectDirector.ISOD.LBOPackage.BadObject

defaultobjectrefで指定されたオブジェクトが不当です。

com.fujitsu.ObjectDirector.ISOD.LBOPackage.OperationBusy

同時処理可能な要求の上限に達しました。リトライしてください。

org.omg.CORBA.SystemException

その他の要因。

システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

3.19.1.2 com.fujitsu.ObjectDirector.ISOD.LBO.resolve_LBG()

名前

com.fujitsu.ObjectDirector.ISOD.LBO.resolve_LBG

形式

public com.fujitsu.ObjectDirector.ISOD.LBG resolve_LBG(org.omg.CosNaming.NamingContext nc, 
      org.omg.CosNaming.NameComponent[] n) throws
com.fujitsu.ObjectDirector.ISOD.LBOPackage.NotFound, 
com.fujitsu.ObjectDirector.ISOD.LBOPackage.CannotProceed, 
com.fujitsu.ObjectDirector.ISOD.LBOPackage.InvalidName, 
com.fujitsu.ObjectDirector.ISOD.LBOPackage.OperationBusy;

機能説明

本関数は、ロードバランスオブジェクトグループを検索します。ncで指定されるネーミングコンテキスト配下のnで指定された名前のロードバランスオブジェクトグループを検索します。

パラメタ

nc

ネーミングコンテキストオブジェクト。

n

検索するロードバランスオブジェクトグループ名。
NameComponentオブジェクトの配列として指定します。

復帰値

正常終了した場合は、検出したロードバランスオブジェクトグループのオブジェクトリファレンスが返却されます。
異常終了した場合は、以下の例外が発生します。

com.fujitsu.ObjectDirector.ISOD.LBOPackage.NotFound

nで指定した名前が見つかりません。

com.fujitsu.ObjectDirector.ISOD.LBOPackage.CannotProceed

ncで指定されたネーミングコンテキストが存在しません。

com.fujitsu.ObjectDirector.ISOD.LBOPackage.InvalidName

名前の指定に誤りがあります。

com.fujitsu.ObjectDirector.ISOD.LBOPackage.OperationBusy

同時処理可能な要求の上限に達しました。リトライしてください。

org.omg.CORBA.SystemException

その他の要因。

システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

3.19.1.3 com.fujitsu.ObjectDirector.ISOD.LBO.delete_LBG()

名前

com.fujitsu.ObjectDirector.ISOD.LBO.delete_LBG

形式

public org.omg.CORBA.Object delete_LBG(org.omg.CosNaming.NamingContext nc, 
      org.omg.CosNaming.NameComponent[] n) throws
com.fujitsu.ObjectDirector.ISOD.LBOPackage.NotFound,
com.fujitsu.ObjectDirector.ISOD.LBOPackage.CannotProceed,
com.fujitsu.ObjectDirector.ISOD.LBOPackage.InvalidName,
com.fujitsu.ObjectDirector.ISOD.LBOPackage.NotEmpty,
com.fujitsu.ObjectDirector.ISOD.LBOPackage.OperationBusy;

機能説明

本関数は、ロードバランスオブジェクトグループをネーミングサービスから削除します。ncで指定されたネーミングコンテキスト配下のnで指定された名前のロードバランスオブジェクトグループが削除されます。削除対象のロードバランスオブジェクトグループに、デフォルトオブジェクト以外のオブジェクトが登録されている場合は、例外となります。

パラメタ

nc

ネーミングコンテキストオブジェクト。

n

削除するロードバランスオブジェクトグループ名。
NameComponentオブジェクトの配列として指定します。

復帰値

正常終了した場合は、デフォルトオブジェクトのオブジェクトリファレンスが返されます。
異常終了した場合は、以下の例外が発生します。

com.fujitsu.ObjectDirector.ISOD.LBOPackage.NotFound

nで指定した名前が見つかりません。

com.fujitsu.ObjectDirector.ISOD.LBOPackage.CannotProceed

ncで指定されたネーミングコンテキストが存在しません。

com.fujitsu.ObjectDirector.ISOD.LBOPackage.InvalidName

名前の指定に誤りがあります。

com.fujitsu.ObjectDirector.ISOD.LBOPackage.NotEmpty

オブジェクトグループにデフォルトオブジェクト以外のオブジェクトが1つ以上登録されています。

com.fujitsu.ObjectDirector.ISOD.LBOPackage.OperationBusy

同時処理可能な要求の上限に達しました。リトライしてください。

org.omg.CORBA.SystemException

その他の要因。

システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

3.19.1.4 com.fujitsu.ObjectDirector.ISOD.LBO.list_LBG()

名前

com.fujitsu.ObjectDirector.ISOD.LBO.list_LBG

形式

public void list_LBG(org.omg.CosNaming.NamingContext nc, 
      com.fujitsu.ISOD.LBOPackage.LBGListHolder bl);

機能説明

本関数は、ロードバランスオブジェクトグループのリストを返却します。
ncで指定されたネーミングコンテキスト配下のロードバランスオブジェクトグループのリストを返却します。本関数では、ロードバランスオブジェクトグループの名前とロードバランスタイプの情報を持つ構造体(BindingObjectGroup)のシーケンスを返却します。
本関数で獲得できるロードバランスオブジェクトグループの数の上限は256個です。

パラメタ

nc

ネーミングコンテキストオブジェクト。

bl

ロードバランスオブジェクトグループのリストの設定領域。

復帰値

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

org.omg.CORBA.SystemException

その他の要因。

システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

注意事項

ロードバランスオブジェクトグループが257個以上登録されている場合は、すべてのオブジェクトグループの一覧を取得することができません。

3.19.1.5 com.fujitsu.ObjectDirector.ISOD.LBO.notify_down()

名前

com.fujitsu.ObjectDirector.ISOD.LBO.notify_down

形式

public void notify_down(java.lang.String HostName ) throws
      com.fujitsu.ObjectDirector.ISOD.LBOPackage.InvalidArgument, 
      com.fujitsu.ObjectDirector.ISOD.LBOPackage.CannotProceed2;

機能説明

本関数は、ロードバランス機能にサーバがダウンしたことを通知します。本関数が呼び出されると、HostNameで指定されたアドレスのサーバのオブジェクトのオブジェクトリファレンスの返却を停止します。

パラメタ

HostName

ダウンしたサーバのホスト名またはIPアドレス。

復帰値

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

com.fujitsu.ObjectDirector.ISOD.LBOPackage.InvalidArgument

HostNameの指定に誤りがあります。

com.fujitsu.ObjectDirector.ISOD.LBOPackage.CannotProceed2

ロードバランス機能のDBの処理で異常が発生しました。

3.19.1.6 com.fujitsu.ObjectDirector.ISOD.LBO.notify_recover()

名前

com.fujitsu.ObjectDirector.ISOD.LBO.notify_recover

形式

public void notify_recover(java.jang.String HostName) throws
com.fujitsu.ObjectDirector.ISOD.LBOPackage.InvalidArgument,
com.fujitsu.ObjectDirector.ISOD.LBOPackage.CannotProceed2;

機能説明

本関数は、ロードバランス機能にサーバが起動または復旧したことを通知します。本関数が呼び出されると、HostNameで指定されたアドレスのサーバのオブジェクトのオブジェクトリファレンスの返却を開始します。

パラメタ

HostName

復旧したサーバのホスト名またはIPアドレス。

復帰値

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

com.fujitsu.ObjectDirector.ISOD.LBOPackage.InvalidArgument

HostNameの指定に誤りがあります。

com.fujitsu.ObjectDirector.ISOD.LBOPackage.CannotProceed2

ロードバランス機能のDBの処理で異常が発生しました。

前次
Copyright 2011-2012 FUJITSU LIMITED