ページの先頭行へ戻る
Interstage Application Server リファレンスマニュアル(API編)
第4章 COBOLインタフェース > 4.10 ネーミングサービスインタフェース > 4.10.3 ネーミングコンテキスト拡張インタフェース
前次

4.10.3 ネーミングコンテキスト拡張インタフェース

4.10.3.1 COSNAMING-NAMINGCONTEXTEXT-TO-STRING

名前

  COSNAMING-NAMINGCONTEXTEXT-TO-STRING

形式

ENVIRONMENT DIVISION.
   CONFIGURATION SECTION. 
   SPECIAL-NAMES. 
     SYMBOLIC CONSTANT
     COPY SYMBOL-CONST IN CORBA. 
     . 

  DATA DIVISION. 
    COPY CONST IN CORBA. 
    01 COPY COSNAMING-NAMINGCONTEXTEXT IN CORBA REPLACING COSNAMING-
      NAMINGCONTEXTEXT    BY NCE. 
    01 COPY COSNAMING-NAME IN CORBA REPLACING COSNAMING-NAME BY N. 
    01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT BY ENV. 
    01 COPY COSNAMING-NAMINGCONTEXTEXT-STR IN CORBA REPLACING COSNAMING-
      NAMINGCONTEXTEXT-STR BY SN. 

  PROCEDURE DIVISION. 
    CALL "COSNAMING-NAMINGCONTEXTEXT-TO-STRING" USING
         NCE
         N
         ENV
         SN.

機能説明

  Nで指定された構造体型のバインディング名を文字列表記のバインディング名に変換します。NCEはネーミングコンテキストのオブジェクトリファレンスです。
  本関数は復帰値を格納する領域を獲得するため、この領域が不要になった時点で、CORBA-FREE関数を使用して領域を解放する必要があります。

復帰値

  正常終了した場合は、文字列表記のバインディング名が返され、ENV構造体のMAJORにCORBA-NO-EXCEPTIONが設定されます。
  異常終了した場合は、ENV構造体のMAJORにCORBA-SYSTEM-EXCEPTIONまたはCORBA-USER-EXCEPTIONが設定され、ENV構造体のIDに詳細情報が設定されます。
  ユーザ例外の場合は、以下の詳細情報が設定されます。

  IDL:CosNaming/NamingContext/InvalidName:1.0

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

  システム例外の場合は、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

4.10.3.2 COSNAMING-NAMINGCONTEXTEXT-TO-NAME

名前

  COSNAMING-NAMINGCONTEXTEXT-TO-NAME

形式

ENVIRONMENT DIVISION.
   CONFIGURATION SECTION. 
   SPECIAL-NAMES. 
     SYMBOLIC CONSTANT
     COPY SYMBOL-CONST IN CORBA. 
     . 

  DATA DIVISION. 
    COPY CONST IN CORBA. 
    01 COPY COSNAMING-NAMINGCONTEXTEXT IN CORBA REPLACING COSNAMING-
      NAMINGCONTEXTEXT    BY NCE. 
    01 COPY COSNAMING-NAMINGCONTEXTEXT-STR IN CORBA REPLACING COSNAMING-
      NAMINGCONTEXTEXT-STR BY SN. 
    01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT BY ENV. 
    01 N USAGE POINTER. 

  PROCEDURE DIVISION. 
    CALL "COSNAMING-NAMINGCONTEXTEXT-TO-NAME" USING
         NCE
         SN
         ENV
         N.

機能説明

  SNで指定された文字列表記のバインディング名を構造体型のバインディング名に変換します。NCEはネーミングコンテキストのオブジェクトリファレンスです。
  本関数は復帰値を格納する領域を獲得するため、この領域が不要になった時点で、CORBA-FREE関数を使用して領域を解放する必要があります。

復帰値

  正常終了した場合は、構造体型のバインディング名が返され、ENV構造体のMAJORにCORBA-NO-EXCEPTIONが設定されます。
  異常終了した場合は、ENV構造体のMAJORにCORBA-SYSTEM-EXCEPTIONまたはCORBA-USER-EXCEPTIONが設定され、ENV構造体のIDに詳細情報が設定されます。
  ユーザ例外の場合は、以下の詳細情報が設定されます。

  IDL:CosNaming/NamingContext/InvalidName:1.0

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

  システム例外の場合は、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

4.10.3.3 COSNAMING-NAMINGCONTEXTEXT-TO-URL

名前

  COSNAMING-NAMINGCONTEXTEXT-TO-URL

形式

ENVIRONMENT DIVISION.
   CONFIGURATION SECTION. 
   SPECIAL-NAMES. 
     SYMBOLIC CONSTANT
     COPY SYMBOL-CONST IN CORBA. 
     . 

  DATA DIVISION. 
    COPY CONST IN CORBA. 
    01 COPY COSNAMING-NAMINGCONTEXTEXT IN CORBA REPLACING COSNAMING-NAMINGCONTEXTEXT BY NCE. 
    01 COPY COSNAMING-NAMINGCONTEXTEXT-ADD IN CORBA 
       REPLACING COSNAMING-NAMINGCONTEXTEXT-ADD BY ADDRKEY. 
    01 COPY COSNAMING-NAMINGCONTEXTEXT-STR IN CORBA 
       REPLACING COSNAMING-NAMINGCONTEXTEXT-STR BY SN. 
    01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT BY ENV. 
    01 COPY COSNAMING-NAMINGCONTEXTEXT-URL IN CORBA 
       REPLACING COSNAMING-NAMINGCONTEXTEXT-URL BY URL. 

  PROCEDURE DIVISION. 
    CALL "COSNAMING-NAMINGCONTEXTEXT-TO-NAME" USING
         NCE
         ADDRKEY
         SN
         ENV
         URL.

機能説明

  ADDRKEYで指定されたアドレスと、SNで指定された文字列表記のバインディング名からURLスキーマを作成します。NCEはネーミングコンテキストのオブジェクトリファレンスです。なお、SNには日本語文字列を含む文字列表記のバインディング名を使用することはできません。
  本関数は返値を格納する領域を獲得するため、この領域が不要になった時点で、CORBA-FREE関数を使用して領域を解放する必要があります。

復帰値

  正常終了した場合、URLスキーマが返され、ENV構造体のMAJORにCORBA-NO-EXCEPTIONが設定されます。
  異常終了した場合、ENV構造体のMAJORにCORBA-SYSTEM-EXCEPTIONまたはCORBA-USER-EXCEPTIONが設定され、ENV構造体のIDに詳細情報が設定されます。
  ユーザ例外の場合は、以下の詳細情報が設定されます。

  IDL:CosNaming/NamingContextExt/InvalidAddress:1.0

  アドレスの指定に誤りがあります。

  IDL:CosNaming/NamingContext/InvalidName:1.0

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

  システム例外の場合は、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

4.10.3.4 COSNAMING-NAMINGCONTEXTEXT-RESOLVE-STR

名前

  COSNAMING-NAMINGCONTEXTEXT-RESOLVE-STR

形式

ENVIRONMENT DIVISION.
   CONFIGURATION SECTION. 
   SPECIAL-NAMES. 
     SYMBOLIC CONSTANT
     COPY SYMBOL-CONST IN CORBA. 
     . 

  DATA DIVISION. 
    COPY CONST IN CORBA. 
    01 COPY COSNAMING-NAMINGCONTEXTEXT IN CORBA REPLACING COSNAMING-NAMINGCONTEXTEXT BY NCE. 
    01 COPY COSNAMING-NAMINGCONTEXTEXT-STR IN CORBA REPLACING COSNAMING-NAMINGCONTEXTEXT-
      STR BY SN. 
    01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT BY ENV. 
    01 COPY OBJECT IN CORBA REPLACING CORBA-OBJECT BY OBJ. 

  PROCEDURE DIVISION. 
    CALL "COSNAMING-NAMINGCONTEXTEXT-RESOLVE-STR" USING
         NCE
         SN
         ENV
         OBJ.

機能説明

  NCEで指定されたネーミングコンテキスト中で、SNに指定された文字列表記のバインディング名と結合されているオブジェクトリファレンスを返します。
  本関数はオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA-OBJECT-RELEASE関数を使用して領域を解放する必要があります。

復帰値

  正常終了した場合は、オブジェクトリファレンスが返され、ENV構造体のMAJORにCORBA-NO-EXCEPTIONが設定されます。
  異常終了した場合は、ENV構造体のMAJORにCORBA-SYSTEM-EXCEPTIONまたはCORBA-USER-EXCEPTIONが設定され、ENV構造体のIDに詳細情報が設定されます。
  ユーザ例外の場合は、以下の詳細情報が設定されます。

  IDL:CosNaming/NamingContext/NotFound:1.0

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

  IDL:CosNaming/NamingContext/CannotProceed:1.0

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

  IDL:CosNaming/NamingContext/InvalidName:1.0

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

  システム例外の場合は、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

前次
Copyright FUJITSU LIMITED 2009