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

4.18.1.1 ISOD-LBO-CREATE-LBG

名前

　ISOD-LBO-CREATE-LBG

形式

ENVIRONMENT DIVISION.
   CONFIGURATION SECTION.
   SPECIAL-NAMES.
     SYMBOLIC CONSTANT
     COPY SYMBOL-CONST IN CORBA.
     .
   DATA DIVISION.
     COPY CONST IN CORBA.
     01 COPY ISOD-LBO REPLACING ISOD-LBO BY LBO. 
     01 COPY COSNAMING-CONTEXT IN CORBA REPLACING COSNAMING-CONTEXT BY NC.
     01 COPY COSNAMING-NAME IN CORBA REPLACING COSNAMING-NAME BY N.
     01 COPY ENUM IN CORBA REPLACING CORBA-NUM BY LOADBALANCETYPE.
     01 COPY OBJECT IN CORBA REPLACING CORBA-OBJECT BY DEFAULTOBJREF.
     01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT ENV.
     01 COPY OBJECT IN CORBA REPLACING CORBA-OBJECT BY RESULT.
     
   PROCEDURE DIVISION.
     CALL "ISOD-LBO-CREATE-LBG"  USING
          LBO
          NC
          N
          LOADBALANCETYPE
          DEFAULTOBJECTREF
          ENV
          RESULT.

機能説明

　本関数は、ロードバランスオブジェクトグループを作成し、ネーミングサービスに登録します。NCで指定されたネーミングコンテキスト配下にNで指定された名前で登録します。
　ロードバランスオブジェクトグループの生成に成功した場合、復帰値として生成したロードバランスオブジェクトグループのオブジェクトリファレンスが返却されます。
　LOADBALANCETYPEには、ISOD-LBG-ROUNDROBINを指定します。
　DEFAULTOBJECTREFには、ロードバランス機能が動作していない場合に、ネーミングサービスが返却するオブジェクトリファレンス（デフォルトオブジェクトリファレンス）を指定してください。指定しない場合は、ロードバランス機能が動作していない場合には、ネーミングサービスからはオブジェクトリファレンスが返却されません。このオブジェクトリファレンスは、ISOD-LBG BINDおよび ISOD-LBG UNBINDオペレーションでは、登録および削除はできません。指定した場合は、ロードバランスオブジェクトグループ作成後に、ISOD-LBG REBIND-DEFAULTオペレーションを使用して変更することができます。

復帰値

　正常終了した場合はENV構造体のMAJORにCORBA-NO-EXCEPTIONが設定されます。
　異常終了した場合はCORBA-USER-EXCEPTIONが設定され、ENV構造体のIDに詳細情報が設定される。IDの値と意味は次のとおりです。

IDL:ISOD/LBO/NotFound:1.0
   Nで指定されたネーミングコンテキストが見つかりません。
IDL:ISOD/LBO/CannotProceed:1.0
   NCで指定されたネーミングコンテキストが存在しません。
IDL:ISOD/LBO/InvalidName:1.0
  名前の指定に誤りがあります。
IDL:ISOD/LBO/AlreadyExist:1.0
  指定された名前のバインディングがすでに存在します。
IDL:ISOD/LBO/InvalidType:1.0
  ロードバランスタイプの指定に誤りがあります。
IDL:ISOD/LBO/BadObject:1.0
  DEFAULTOBJECTREFで指定されたオブジェクトが不当です。
IDL:ISOD/LBO/OperationBusy:1.0
  同時処理可能な要求の上限に達しました。リトライしてください。