TSCサービス識別子の構成

TSCProxyObjectを使用して利用するサービスの種類は，TSCサービス識別子によって表されます。TSCサービス識別子は，インタフェース名称とTSCアクセプタ名称から構成されます。

• TSCProxyObjectのインタフェース名称
  TSCProxyObjectのインタフェース名称は，TSCProxyObjectを使用して呼び出すサービスのインタフェースの種類を表します。
  
• TSCProxyObjectのTSCアクセプタ名称
  TSCProxyObjectのTSCアクセプタ名称も，TSCProxyObjectを使用して呼び出すサービスのインタフェースの種類を表します。ただし，同じインタフェースを提供するサービスで，実装内容の違いを識別するために使用します。したがって，TSCアクセプタ名称を設定しないで，"TSCアクセプタ名称なし"とすることもできます。
  

サービスの種類の表現方法

TSCProxyObjectによって利用するサービスの種類は，TSCサービス識別子によって表されます。TSCサービス識別子は，インタフェース名称とTSCアクセプタ名称から構成されます。

• TSCAcceptorにTSCアクセプタ名称が設定されていない場合
  TSCProxyObjectが呼び出すサービスのインタフェースの種類は，次のように表されます。
  

   
  TSCアクセプタ名称なしTSCサービス識別子
   

• TSCAcceptorにTSCアクセプタ名称が設定されている場合
  TSCProxyObjectが呼び出すサービスの種類は，次のように表されます。
  

   
  TSCアクセプタ名称ありTSCサービス識別子
   

サービスの種類の表現例

• TSCProxyObjectのインタフェース名称が"ABC"で，TSCアクセプタ名称がない場合
  次のように表される場合，TSCProxyObjectは，"ABC::"への要求メッセージを生成し，"ABC::"としてサービスを提供しているTSCObjectとTSCAcceptorを呼び出すことができます。
  

   
  "ABC::"
   

  サーバアプリケーション側で，TSCProxyObjectに"ABC::"と指定してサービスを呼び出した場合，その要求を受け付けるTSCObjectとTSCAcceptorは，次に示すどちらかです。
  
  • インタフェース名称"ABC:"だけ指定されたTSCAcceptor，およびそのTSCAcceptorに管理されるTSCObject
  • インタフェース名称"ABC"と任意のTSCアクセプタ名称が指定されたTSCAcceptor，およびそのTSCAcceptorに管理されるTSCObject
  つまり，TSCProxyObjectでインタフェース名称だけ指定して呼び出した場合，サーバ側では，同じインタフェース名称を持つTSCAcceptorに管理されるすべてのTSCObjectが，TSCアクセプタ名称の値に関係なく呼び出されます。
  
• TSCProxyObjectのインタフェース名称が"ABC"で，TSCアクセプタ名称が"abc"の場合
  次のように表される場合，TSCProxyObjectは"ABC::abc"への要求メッセージを生成し，"ABC::abc"としてサービスを提供しているTSCObjectとTSCAcceptorを呼び出すことができます。
  

   
  "ABC::abc"
   

  サーバアプリケーション側で，TSCProxyObjectに"ABC::abc"と指定してサービスを呼び出した場合，その要求を受け付けるTSCObjectとTSCAcceptorは，インタフェース名称"ABC"とTSCアクセプタ名称"abc"が指定されたTSCAcceptor，およびそのTSCAcceptorに管理されるTSCObjectです。
  つまり，TSCProxyObjectにインタフェース名称とTSCアクセプタ名称を指定して呼び出した場合，サーバ側では，同じインタフェース名称と同じTSCアクセプタ名称を持つTSCAcceptorに管理されるTSCObjectが呼び出されるため，TSCアクセプタ名称によって呼び出すTSCObjectを選択できます。
  

 
* タイムアウト
 CALL 'TSCProxyObject-TSCTimeoutSet' USING
            BY VALUE       PROXY-PTR
            BY VALUE       TIMEOUT
            BY REFERENCE   CORBA-ENVIRONMENT.
 CALL 'TSCProxyObject-TSCTimeoutGet' USING
            BY VALUE       PROXY-PTR
            BY REFERENCE   CORBA-ENVIRONMENT
         RETURNING         TIMEOUT.
 
* 優先度
 CALL 'TSCProxyObject-TSCPrioritySet' USING
            BY VALUE       PROXY-PTR
            BY VALUE       PRIORITY
            BY REFERENCE   CORBA-ENVIRONMENT.
 CALL 'TSCProxyObject-TSCPriorityGet' USING
            BY VALUE       PROXY-PTR
            BY REFERENCE   CORBA-ENVIRONMENT
         RETURNING         PRIORITY.
 
 CALL 'TSCProxyObject-TSCContextGet' USING
            BY VALUE       PROXY-PTR
            BY REFERENCE   CORBA-ENVIRONMENT
         RETURNING         CONTEXT-PTR.

●CALL 'TSCProxyObject-TSCTimeoutSet' USING

            BY VALUE      PROXY-PTR
            BY VALUE      TIMEOUT
            BY REFERENCE  CORBA-ENVIRONMENT.
 

項目	型・(入出力の区別)意味
引数	BY VALUE PROXY-PTR USAGE POINTER	(入力)ABC_TSCprxyのポインタ
	BY VALUE TIMEOUT PIC S9(9) COMP	(入力)タイムアウト時間（秒）
	BY REFERENCE CORBA-ENVIRONMENT	(出力)例外情報集団項目
戻り値	ありません。
例外	TSCBadParamException

タイムアウト値（呼び出し時の監視時間）を秒単位で設定します。"0"を指定する場合，時間監視をしません。監視時間は，副プログラム呼び出しごとに変更できます。監視時間のデフォルト値は"180"（秒）です。また，initServer発行時の引数argsに，-TSCTimeOutオプションを指定する場合は，監視時間のデフォルト値はその指定値となります。

この副プログラムを複数のスレッド上から同時に呼び出した場合，結果は保証されません。

●CALL 'TSCProxyObject-TSCTimeoutGet' USING

            BY VALUE        PROXY-PTR
            BY REFERENCE    CORBA-ENVIRONMENT
         RETURNING          TIMEOUT.
 

項目	型・(入出力の区別)意味
引数	BY VALUE PROXY-PTR USAGE POINTER	(入力)ABC_TSCprxyのポインタ
	BY REFERENCE CORBA-ENVIRONMENT	(出力)例外情報集団項目
戻り値	TIMEOUT PIC S9(9) COMP	タイムアウト時間（秒）
例外	TSCBadParamException

タイムアウト値（呼び出し時の監視時間）を取得します。

この副プログラムを複数のスレッド上から同時に呼び出した場合，結果は保証されません。

●CALL 'TSCProxyObject-TSCPrioritySet' USING

            BY VALUE        PROXY-PTR
            BY VALUE        PRIORITY
            BY REFERENCE    CORBA-ENVIRONMENT.
 

項目	型・(入出力の区別)意味
引数	BY VALUE PROXY-PTR USAGE POINTER	(入力)ABC_TSCprxyのポインタ
	BY VALUE PRIORITY PIC S9(9) COMP	(入力)プライオリティ値
	BY REFERENCE CORBA-ENVIRONMENT	(出力)例外情報集団項目
戻り値	ありません。
例外	TSCBadParamException

プライオリティ値（副プログラム呼び出し時の優先順位）を設定します。

PRIORITYに1〜8の値を指定することで，キューイング取り出し時の優先順位を変更できます。PRIORITYに指定する値が小さいほど優先度は高くなります。この副プログラムはリクエスト単位に変更することもできます。プライオリティ値のデフォルト値は"4"です。また，initServer発行時の引数argsに，-TSCRequestPriorityオプションを指定する場合は，プライオリティ値のデフォルト値はその指定値となります。

この副プログラムを複数のスレッド上から同時に呼び出した場合，結果は保証されません。

●CALL 'TSCProxyObject-TSCPriorityGet' USING

            BY VALUE          PROXY-PTR
            BY REFERENCE      CORBA-ENVIRONMENT
         RETURNING            PRIORITY.
 

項目	型・(入出力の区別)意味
引数	BY VALUE PROXY-PTR USAGE POINTER	(入力)ABC_TSCprxyのポインタ
	BY REFERENCE CORBA-ENVIRONMENT	(出力)例外情報集団項目
戻り値	PRIORITY PIC S9(9) COMP	プライオリティ値
例外	TSCBadParamException

プライオリティ値（副プログラム呼び出し時の優先順位）を取得します。

この副プログラムを複数のスレッド上から同時に呼び出した場合，結果は保証されません。

●CALL 'TSCProxyObject-TSCContextGet' USING

           BY VALUE          PROXY-PTR
           BY REFERENCE      CORBA-ENVIRONMENT
        RETURNING            CONTEXT-PTR.
 

項目	型・(入出力の区別)意味
引数	BY VALUE PROXY-PTR USAGE POINTER	(入力)ABC_TSCprxyのポインタ
	BY REFERENCE CORBA-ENVIRONMENT	(出力)例外情報集団項目
戻り値	CONTEXT-PTR USAGE POINTER	TSCContextのポインタ
例外	TSCBadParamException

呼び出し時のTSCContextを取得します。ユーザはこのTSCContextにコンテキストデータを設定できます。

マルチスレッド環境で，TSCProxyObjectクラスのインスタンスの副プログラムを呼び出す規則を次に示します。

副プログラム	複数のスレッド上からの同時呼び出し
TSCProxyObject-TSCTimeoutGet	できます。
TSCProxyObject-TSCTimeoutSet	できません。
TSCProxyObject-TSCPriorityGet	できます。
TSCProxyObject-TSCPrioritySet	できません。
TSCProxyObject-TSCContextGet	できません。
クライアント側からのオブジェクト呼び出し	できません。

TSCProxyObjectクラスのインスタンスがほかのクラスのインスタンスを内部参照（アクセス）する規則を次に示します。

副プログラム	複数のスレッド上からの内部参照
TSCProxyObject-TSCTimeoutGet	ありません。
TSCProxyObject-TSCTimeoutSet	ありません。
TSCProxyObject-TSCPriorityGet	ありません。
TSCProxyObject-TSCPrioritySet	ありません。
TSCProxyObject-TSCContextGet	ありません。
クライアント側からのオブジェクト呼び出し	生成時に指定したTSCClient型のインスタンス