ページの先頭行へ戻る
Interstage Application Server リファレンスマニュアル(API編)
Interstage

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

5.21.1.1 ISOD-LBO-CREATE_LBG

名前

ISOD-LBO-CREATE_LBG

形式

REPOSITORY.
    CLASS      COSNAMING-NAMINGCONTEXT
    CLASS      CORBA-OBJECT
    CLASS      ISOD-LBG
    CLASS      ISOD-LBO-NOTFOUND
    CLASS      ISOD-LBO-CANNOTPROCEED
    CLASS      ISOD-LBO-INVALIDNAME
    CLASS      ISOD-LBO-ALREADYEXIST
    CLASS      ISOD-LBO-INVALIDTYPE
    CLASS      ISOD-LBO-BADOBJECT
    CLASS      ISOD-LBO-OPERATIONBUSY
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID.     CREATE_LBG.
DATA DIVISION.
LINKAGE SECTION.
01 NC                    OBJECT REFERENCE COSNAMING-NAMINGCONTEXT.
01 N                     TYPE COSNAMING-NAME.
01 LOADBALANCETYPE       TYPE CORBA-UNSIGNED-LONG.
01 DEFAULTOBJECTREF      OBJECT REFERENCE CORBA-OBJECT.
01 RESULT                OBJECT REFERENCE ISOD-LBG.
PROCEDURE DIVISION       USING     NC
                                   N
                                   LOADBALANCETYPE
                                   DEFAULTOBJECTREF
                         RETURNING RESULT
                         RAISING   CORBA-SYSTEMEXCEPTION
                                   ISOD-LBO-NOTFOUND
                                   ISOD-LBO-CANNOTPROCEED
                                   ISOD-LBO-INVALIDNAME
                                   ISOD-LBO-ALREADYEXIST
                                   ISOD-LBO-INVALIDTYPE
                                   ISOD-LBO-BADOBJECT
                                   ISOD-LBO-OPERATIONBUSY

機能説明

本関数は、ロードバランスオブジェクトグループを作成し、ネーミングサービスに登録します。NCで指定されたネーミングコンテキスト配下にNで指定された名前で登録します。
Nがコンパウンドネームである場合、バインディングはコンパウンドネーム中で最後に指定されたネーミングコンテキストに登録されます。

復帰値

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

ISOD-LBO-NOTFOUND

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

ISOD-LBO-CANNOTPROCEED

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

ISOD-LBO-INVALIDNAME

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

ISOD-LBO-ALREADYEXIST

指定された名前のバインディングがすでに存在します。

ISOD-LBO-INVALIDTYPE

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

ISOD-LBO-BADOBJECT

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

ISOD-LBO-OPERATIONBUSY

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

CORBA-SYSTEMEXCEPTION

その他の要因。

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

5.21.1.2 ISOD-LBO-RESOLVE_LBG

名前

ISOD-LBO-RESOLVE_LBG

形式

REPOSITORY.
    CLASS      COSNAMING-NAMINGCONTEXT
    CLASS      ISOD-LBG
    CLASS      ISOD-LBO-NOTFOUND
    CLASS      ISOD-LBO-CANNOTPROCEED
    CLASS      ISOD-LBO-INVALIDNAME
    CLASS      ISOD-LBO-OPERATIONBUSY
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID.     RESOLVE_LBG.
DATA DIVISION.
LINKAGE SECTION.
01 RESULT                     OBJECT REFERENCE ISOD-LBG.
01 NC                         OBJECT REFERENCE COSNAMING-NAMINGCONTEXT.
01 N                          TYPE COSNAMING-NAME.
PROCEDURE DIVISION            USING      NC
                                         N
                              RETURNING  RESULT
                              RAISING    CORBA-SYSTEMEXCEPTION
                                         ISOD-LBO-NOTFOUND
                                         ISOD-LBO-CANNOTPROCEED
                                         ISOD-LBO-INVALIDNAME
                                         ISOD-LBO-OPERATIONBUSY

機能説明

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

復帰値

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

ISOD-LBO-NOTFOUND

Nで指定された名前が見つかりません。

ISOD-LBO-CANNOTPROCEED

ネーミングコンテキストが存在しません。

ISOD-LBO-INVALIDNAME

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

ISOD-LBO-OPERATIONBUSY

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

CORBA-SYSTEMEXCEPTION

その他の要因。

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

5.21.1.3 ISOD-LBO-DELETE_LBG

名前

ISOD-LBO-DELETE_LBG

形式

REPOSITORY.
    CLASS      COSNAMING-NAMINGCONTEXT
    CLASS      CORBA-OBJECT
    CLASS      ISOD-LBO-NOTFOUND
    CLASS      ISOD-LBO-CANNOTPROCEED
    CLASS      ISOD-LBO-INVALIDNAME
    CLASS      ISOD-LBO-NOTEMPTY
    CLASS      ISOD-LBO-OPERATIONBUSY
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID.    DELETE_LBG.
DATA DIVISION.
LINKAGE SECTION.
01 RESULT                  OBJECT REFERENCE CORBA-OBJECT.
01 NC                      OBJECT REFERENCE COSNAMING-NAMINGCONTEXT.
01 N                       TYPE COSNAMING-NAME.
PROCEDURE DIVISION         USING     N
                                     NC
                           RETURNING RESULT
                           RAISING   CORBA-SYSTEMEXCEPTION
                                     ISOD-LBO-NOTFOUND
                                     ISOD-LBO-CANNOTPROCEED
                                     ISOD-LBO-INVALIDNAME
                                     ISOD-LBO-NOTEMPTY
                                     ISOD-LBO-OPERATIONBUSY

機能説明

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

復帰値

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

ISOD-LBO-NOTFOUND

Nで指定された名前が見つかりません。

ISOD-LBO-CANNOTPROCEED

ネーミングコンテキストが存在しません。

ISOD-LBO-INVALIDNAME

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

ISOD-LBO-NOTEMPTY

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

ISOD-LBO-OPERATIONBUSY

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

CORBA-SYSTEMEXCEPTION

その他の要因。

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

5.21.1.4 ISOD-LBO-LIST_LBG

名前

ISOD-LBO-LIST

形式

REPOSITORY.
    CLASS      COSNAMING-NAMINGCONTEXT
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID.     LIST_LBG.
DATA DIVISION.
LINKAGE SECTION.
01 NC                    OBJECT REFERENCE COSNAMING-NAMINGCONTEXT.
01 OBJECTGROUPLIST       TYPE ISOD-LBO-LBGLIST.
PROCEDURE DIVISION       USING     NC
                                   OBJECTGROUPLIST
                         RAISING   CORBA-SYSTEMEXCEPTION

機能説明

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

本関数で獲得できるロードバランスオブジェクトグループの数の上限は、256個です。

復帰値

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

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

注意事項

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

5.21.1.5 ISOD-LBO-NOTIFY_DOWN

名前

ISOD-LBO-NOTIFY_DOWN

形式

REPOSITORY.
    CLASS      ISOD-LBO-INVALIDARGUMENT
    CLASS      ISOD-LBO-CANNOTPROCEED2
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID.     NOTIFY_DOWN.
DATA DIVISION.
LINKAGE SECTION.
01 HOSTNAME              PIC X ANY LENGTH.
PROCEDURE DIVISION       USING     HOSTNAME
                         RAISING   CORBA-SYSTEMEXCEPTION
                                   ISOD-LBO-INVALIDARGUMENT
                                   ISOD-LBO-CANNOTPROCEED2

機能説明

本関数は、ロードバランス機能にサーバがダウンしたことを通知します。

本関数が呼び出されると、HOSTNAMEで指定されたアドレスのサーバのオブジェクトのオブジェクトリファレンスの返却を停止します。

復帰値

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

ISOD-LBO-INVALIDARGUMENT

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

ISOD-LBO-CANNOTPROCEED2

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

CORBA-SYSTEMEXCEPTION

その他の要因。

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

5.21.1.6 ISOD-LBO-NOTIFY_RECOVER

名前

ISOD-LBO-NOTIFY_RECOVER

形式

REPOSITORY.
    CLASS      ISOD-LBO-INVALIDARGUMENT
    CLASS      ISOD-LBO-CANNOTPROCEED2
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID.     NOTIFY_RECOVER.
DATA DIVISION.
LINKAGE SECTION.
01 HOSTNAME              PIC X ANY LENGTH.
PROCEDURE DIVISION       USING     HOSTNAME
                         RAISING   CORBA-SYSTEMEXCEPTION
                                   ISOD-LBO-INVALIDARGUMENT
                                   ISOD-LBO-CANNOTPROCEED2

機能説明

本関数は、ロードバランス機能にサーバが起動または復旧したことを通知します。

本関数が呼び出されると、HOSTNAMEで指定されたアドレスのサーバのオブジェクトのオブジェクトリファレンスの返却を開始します。

復帰値

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

ISOD-LBO-INVALIDARGUMENT

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

ISOD-LBO-CANNOTPROCEED2

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

CORBA-SYSTEMEXCEPTION

その他の要因。

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