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

5.18.1 ネーミングコンテキストインタフェース

5.18.1.1 COSNAMING-NAMINGCONTEXT-BIND

名前

COSNAMING-NAMINGCONTEXT-BIND

形式

REPOSITORY.
    CLASS      CORBA-OBJECT
    CLASS      COSNAMING-NOTFOUND-001
    CLASS      COSNAMING-CANNOTPROCEED-001
    CLASS      COSNAMING-INVALIDNAME-001
    CLASS      COSNAMING-ALREADYBOUND-001
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID.     BIND.
DATA DIVISION.
LINKAGE SECTION.
01 N                     TYPE COSNAMING-NAME.
01 OBJ                   OBJECT REFERENCE CORBA-OBJECT.
PROCEDURE DIVISION       USING     N
                                   OBJ
                         RAISING   CORBA-SYSTEMEXCEPTION
                                   COSNAMING-NOTFOUND-001
                                   COSNAMING-CANNOTPROCEED-001
                                   COSNAMING-INVALIDNAME-001
                                   COSNAMING-ALREADYBOUND-001

機能説明

Nで指定された名前とOBJで指定されたオブジェクトリファレンスのバインディングを作成し、ネーミングコンテキストに登録します。
Nがコンパウンドネームである場合、バインディングはコンパウンドネーム中で最後に指定されたネーミングコンテキストに登録されます。

復帰値

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

COSNAMING-NAMINGCONTEXT-NOTFOUND

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

COSNAMING-NAMINGCONTEXT-CANNOTPROCEED

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

COSNAMING-NAMINGCONTEXT-INVALIDNAME

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

COSNAMING-NAMINGCONTEXT-ALREADYBOUND

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

CORBA-SYSTEMEXCEPTION

その他の要因。

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

5.18.1.2 COSNAMING-NAMINGCONTEXT-REBIND

名前

COSNAMING-NAMINGCONTEXT-REBIND

形式

REPOSITORY.
    CLASS      CORBA-OBJECT
    CLASS      COSNAMING-NOTFOUND-001
    CLASS      COSNAMING-CANNOTPROCEED-001
    CLASS      COSNAMING-INVALIDNAME-001
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID.    REBIND.
DATA DIVISION.
LINKAGE SECTION.
01 N                    TYPE COSNAMING-NAME.
01 OBJ                  OBJECT REFERENCE CORBA-OBJECT.
PROCEDURE DIVISION     USING      N
                                   OBJ
                        RAISING   CORBA-SYSTEMEXCEPTION
                                  COSNAMING-NOTFOUND-001
                                  COSNAMING-CANNOTPROCEED-001
                                  COSNAMING-INVALIDNAME-001

機能説明

Nで指定された名前とOBJで指定されたオブジェクトリファレンスのバインディングを作成し、ネーミングコンテキストに登録します。指定された名前のバインディングがすでに存在してもエラーとはなりません。
Nがコンパウンドネームである場合、バインディングはコンパウンドネーム中で最後に指定されたネーミングコンテキストに登録されます。

復帰値

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

COSNAMING-NAMINGCONTEXT-NOTFOUND

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

COSNAMING-NAMINGCONTEXT-CANNOTPROCEED

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

COSNAMING-NAMINGCONTEXT-INVALIDNAME

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

CORBA-SYSTEMEXCEPTION

その他の要因。

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

5.18.1.3 COSNAMING-NAMINGCONTEXT-BIND_CONTEXT

名前

COSNAMING-NAMINGCONTEXT-BIND_CONTEXT

形式

REPOSITORY.
    CLASS      COSNAMING-NOTFOUND-001
    CLASS      COSNAMING-CANNOTPROCEED-001
    CLASS      COSNAMING-INVALIDNAME-001
    CLASS      COSNAMING-ALREADYBOUND-001
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID.     BIND_CONTEXT.
DATA DIVISION.
LINKAGE SECTION.
01 N                       TYPE COSNAMING-NAME.
01 NC                      OBJECT REFERENCE COSNAMING-NAMINGCONTEXT.
PROCEDURE DIVISION         USING     N
                                     NC
                           RAISING   CORBA-SYSTEMEXCEPTION
                                     COSNAMING-NOTFOUND-001
                                     COSNAMING-CANNOTPROCEED-001
                                     COSNAMING-INVALIDNAME-001
                                     COSNAMING-ALREADYBOUND-001

機能説明

Nで指定された名前とNCで指定されたネーミングコンテキストのオブジェクトリファレンスのバインディングを作成し、ネーミングコンテキストに登録します。
Nがコンパウンドネームである場合、バインディングはコンパウンドネーム中で最後に指定されたネーミングコンテキストに登録されます。

復帰値

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

COSNAMING-NAMINGCONTEXT-NOTFOUND

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

COSNAMING-NAMINGCONTEXT-CANNOTPROCEED

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

COSNAMING-NAMINGCONTEXT-INVALIDNAME

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

COSNAMING-NAMINGCONTEXT-ALREADYBOUND

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

CORBA-SYSTEMEXCEPTION

その他の要因。

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

注意事項

NCには、登録先のネーミングサービスのオブジェクトリファレンス、および登録先のネーミングサービスにすでに登録されているネーミングコンテキストのオブジェクトリファレンスを指定しないでください。

5.18.1.4 COSNAMING-NAMINGCONTEXT-REBIND_CONTEXT

名前

COSNAMING-NAMINGCONTEXT-REBIND_CONTEXT

形式

REPOSITORY.
    CLASS      COSNAMING-NOTFOUND-001
    CLASS      COSNAMING-CANNOTPROCEED-001
    CLASS      COSNAMING-INVALIDNAME-001
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID.     REBIND_CONTEXT.
DATA DIVISION.
LINKAGE SECTION.
01 N                        TYPE COSNAMING-NAME.
01 NC                       OBJECT REFERENCE COSNAMING-NAMINGCONTEXT.
PROCEDURE DIVISION          USING     N
                                      NC
                            RAISING   CORBA-SYSTEMEXCEPTION
                                      COSNAMING-NOTFOUND-001
                                      COSNAMING-CANNOTPROCEED-001
                                      COSNAMING-INVALIDNAME-001

機能説明

Nで指定された名前とNCで指定されたネーミングコンテキストのオブジェクトリファレンスのバインディングを作成し、ネーミングコンテキストに登録します。指定された名前のバインディングがすでに存在してもエラーにはなりません。
Nがコンパウンドネームである場合、バインディングはコンパウンドネーム中で最後に指定されたネーミングコンテキストに登録されます。

復帰値

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

COSNAMING-NAMINGCONTEXT-NOTFOUND

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

COSNAMING-NAMINGCONTEXT-CANNOTPROCEED

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

COSNAMING-NAMINGCONTEXT-INVALIDNAME

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

CORBA-SYSTEMEXCEPTION

その他の要因。

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

注意事項

NCには、登録先のネーミングサービスのオブジェクトリファレンス、および登録先のネーミングサービスにすでに登録されているネーミングコンテキストのオブジェクトリファレンスを指定しないでください。

5.18.1.5 COSNAMING-NAMINGCONTEXT-RESOLVE

名前

COSNAMING-NAMINGCONTEXT-RESOLVE

形式

REPOSITORY.
    CLASS      CORBA-OBJECT
    CLASS      COSNAMING-NOTFOUND-001
    CLASS      COSNAMING-CANNOTPROCEED-001
    CLASS      COSNAMING-INVALIDNAME-001
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID.     RESOLVE.
DATA DIVISION.
LINKAGE SECTION.
01 0--RESULT              OBJECT REFERENCE CORBA-OBJECT.
01 N                      TYPE COSNAMING-NAME.
PROCEDURE DIVISION        USING      N
                          RETURNING  0--RESULT
                          RAISING    CORBA-SYSTEMEXCEPTION
                                     COSNAMING-NOTFOUND-001
                                     COSNAMING-CANNOTPROCEED-001
                                     COSNAMING-INVALIDNAME-001

機能説明

ネーミングコンテキスト中で、Nに指定された名前と結合されているオブジェクトリファレンスを返します。

復帰値

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

COSNAMING-NAMINGCONTEXT-NOTFOUND

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

COSNAMING-NAMINGCONTEXT-CANNOTPROCEED

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

COSNAMING-NAMINGCONTEXT-INVALIDNAME

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

CORBA-SYSTEMEXCEPTION

その他の要因。

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

5.18.1.6 COSNAMING-NAMINGCONTEXT-UNBIND

名前

COSNAMING-NAMINGCONTEXT-UNBIND

形式

REPOSITORY.
    CLASS      COSNAMING-NOTFOUND-001
    CLASS      COSNAMING-CANNOTPROCEED-001
    CLASS      COSNAMING-INVALIDNAME-001
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID.    UNBIND.
DATA DIVISION.
LINKAGE SECTION.
01 N                       TYPE COSNAMING-NAME.
PROCEDURE DIVISION         USING     N
                           RAISING   CORBA-SYSTEMEXCEPTION
                                     COSNAMING-NOTFOUND-001
                                     COSNAMING-CANNOTPROCEED-001
                                     COSNAMING-INVALIDNAME-001

機能説明

ネーミングコンテキストから、Nで指定された名前のバインディングを削除します。

復帰値

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

COSNAMING-NAMINGCONTEXT-NOTFOUND

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

COSNAMING-NAMINGCONTEXT-CANNOTPROCEED

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

COSNAMING-NAMINGCONTEXT-INVALIDNAME

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

CORBA-SYSTEMEXCEPTION

その他の要因。

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

5.18.1.7 COSNAMING-NAMINGCONTEXT-NEW_CONTEXT

名前

COSNAMING-NAMINGCONTEXT-NEW_CONTEXT

形式

REPOSITORY.
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID.   NEW_CONTEXT.
DATA DIVISION.
LINKAGE SECTION.
01 0--RESULT              OBJECT REFERENCE COSNAMING-NAMINGCONTEXT.
PROCEDURE DIVISION        RETURNING  0--RESULT
                          RAISING    CORBA-SYSTEMEXCEPTION

機能説明

ネーミングコンテキストを管理するネーミングサーバ内に新しいネーミングコンテキストを作成し、作成されたネーミングコンテキストのオブジェクトリファレンスを返します。

復帰値

正常終了した場合は、ネーミングコンテキストのオブジェクトリファレンスが返されます。
異常終了した場合は、CORBA-SYSTEMEXCEPTIONが発生します。

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

注意事項

5.18.1.8 COSNAMING-NAMINGCONTEXT-BIND_NEW_CONTEXT

名前

COSNAMING-NAMINGCONTEXT-BIND_NEW_CONTEXT

形式

REPOSITORY.
    CLASS      COSNAMING-NOTFOUND-001
    CLASS      COSNAMING-CANNOTPROCEED-001
    CLASS      COSNAMING-INVALIDNAME-001
    CLASS      COSNAMING-ALREADYBOUND-001
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID.     BIND_NEW_CONTEXT.
DATA DIVISION.
LINKAGE SECTION.
01 0--RESULT              OBJECT REFERENCE COSNAMING-NAMINGCONTEXT.
01 N                      TYPE COSNAMING-NAME.
PROCEDURE DIVISION        USING      N
                          RETURNING  0--RESULT
                          RAISING    CORBA-SYSTEMEXCEPTION
                                     COSNAMING-NOTFOUND-001
                                     COSNAMING-CANNOTPROCEED-001
                                     COSNAMING-INVALIDNAME-001
                                     COSNAMING-ALREADYBOUND-001

機能説明

新しいネーミングコンテキストを作成し、そのオブジェクトリファレンスとNで指定された名前のバインディングを作成して、既存のネーミングコンテキストに登録します。呼び出し元には、新しいネーミングコンテキストのオブジェクトリファレンスを返します。Nがコンパウンドネームである場合、バインディングはコンパウンドネーム中で最後に指定されたネーミングコンテキストに登録されます。また、新しいネーミングコンテキストは、名前の登録が行われたネーミングコンテキストを管理するネーミングサーバ内に作成されます。

復帰値

正常終了した場合は、生成された新しいネーミングコンテキストのオブジェクトリファレンスが返されます。
異常終了した場合は、以下の例外が発生します。

COSNAMING-NAMINGCONTEXT-NOTFOUND

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

COSNAMING-NAMINGCONTEXT-CANNOTPROCEED

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

COSNAMING-NAMINGCONTEXT-INVALIDNAME

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

COSNAMING-NAMINGCONTEXT-ALREADYBOUND

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

CORBA-SYSTEMEXCEPTION

その他の要因。

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

5.18.1.9 COSNAMING-NAMINGCONTEXT-DESTROY

名前

COSNAMING-NAMINGCONTEXT-DESTROY

形式

REPOSITORY.
    CLASS      COSNAMING-NOTEMPTY-001
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID.     DESTROY.
DATA DIVISION.
LINKAGE SECTION.
PROCEDURE DIVISION       RAISING   CORBA-SYSTEMEXCEPTION
                                   COSNAMING-NOTEMPTY-001

機能説明

ネーミングコンテキストを削除します。

復帰値

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

COSNAMING-NAMINGCONTEXT-NOTEMPTY

ネーミングコンテキスト内にバインディングが存在します。

CORBA-SYSTEMEXCEPTION

その他の要因。

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

5.18.1.10 COSNAMING-NAMINGCONTEXT-LIST

名前

COSNAMING-NAMINGCONTEXT-LIST

形式

REPOSITORY.
    CLASS      CORBA-SYSTEMEXCEPTION

METHOD-ID.     LIST.
DATA DIVISION.
LINKAGE SECTION.
01 HOW_MANY              TYPE CORBA-UNSIGNED-LONG.
01 BL                    TYPE COSNAMING-BINDINGLIST.
01 BI                    OBJECT REFERENCE COSNAMING-BINDINGITERATOR.
PROCEDURE DIVISION       USING     HOW_MANY
                                   BL
                                   BI
                         RAISING   CORBA-SYSTEMEXCEPTION

機能説明

ネーミングコンテキスト中のバインディングのリストを、最大 HOW_MANYで指定された個数分返します。HOW-MANYで指定された値が、nsconfigファイルのbl_how_manyパラメタで設定されている最大バインディング数より大きい場合、ネーミングサービスは最大bl_how_manyパラメタで指定された個数分のバインディングを返します。HOW-MANYに0が設定された場合、クライアントはバインディングにアクセスするためのBIと、長さ0のシーケンスのBLを返します。

リストはBLで指定されたCOSNAMING-BINDINGLISTHOLDER に設定されます。ネーミングコンテキスト内のバインディングの数がHOW_MANYで指定された数よりも多い場合、ネーミングコンテキスト内の現在の位置を示すオブジェクトが生成され、このオブジェクトリファレンスがBIに返されます。このオブジェクトをバインディングアイテレータといいます。BIに返されたオブジェクトリファレンスは、COSNAMING-BINDINGITERATOR-NEXT_ONEおよびCOSNAMING-BINDINGITERATOR-NEXT_Nの呼び出し時に使用します。

復帰値

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

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