ABC_TSCspxy（COBOL）

トランザクショナル分散オブジェクト基盤　TPBroker Object Transaction Monitor　プログラマーズガイド

ABC_TSCspxyはユーザ定義IDLインタフェース依存クラスです。

ABC_TSCspxyは，セション呼び出し用のTSCユーザプロキシの実装クラスです。ユーザ定義IDLインタフェースに従って，ユーザデータをバイト配列データに変換し，TSCSessionProxyを呼び出します。ユーザ定義IDLインタフェースに従って，トランザクションフレームジェネレータがABC_TSCspxyを自動生成します。ABC_TSCspxyは，次の点を除いてABC_TSCprxyと同様の働きをします。

TSCSessionProxyを継承します。
トランザクションフレームジェネレータに-TSCspxyオプションを指定したときだけ生成されます。
onewayのオペレーションを定義したユーザ定義IDLからは生成できません。

各副プログラム名の"_TSCspxy"の部分は，tscidl2cblコマンドの-TSCspxy_extオプションによって変更できます。省略した場合，"_TSCspxy"が設定されます。

 
 CALL 'ABC_TSCspxy-NEW' USING
             BY VALUE       CLIENT-PTR
             BY VALUE       ACCEPTOR-NAME
             BY REFERENCE   CORBA-ENVIRONMENT
          RETURNING      SPROXY-HANDLE.
 
*ユーザ定義IDLインタフェース依存の副プログラム群
 CALL 'ABC-xxx' USING
             BY VALUE       SPROXY-HANDLE
             ...
             BY REFERENCE   CORBA-ENVIRONMENT
          (RETURNING ...) .
 
 CALL 'ABC_TSCspxy-DEL' USING
             BY VALUE       SPROXY-HANDLE
             BY REFERENCE   CORBA-ENVIRONMENT.

●CALL 'ABC_TSCspxy-NEW' USING

            BY VALUE          CLIENT-PTR
            BY VALUE          ACCEPTOR-NAME
            BY REFERENCE      CORBA-ENVIRONMENT
         RETURNING      SPROXY-HANDLE.

項目	型・(入出力の区別)意味
引数	BY VALUE CLIENT-PTR USAGE POINTER	(入力)接続するTSCClientのポインタ
	BY VALUE ACCEPTOR-NAME USAGE-POINTER	(入力)TSCアクセプタ名称のポインタ
	BY REFERENCE CORBA-ENVIRONMENT	(出力)例外情報集団項目
戻り値	SPROXY-HANDLE USAGE-POINTER	ABC_TSCspxyのポインタ

CLIENT-PTRで示されるTSCClientと接続するABC_TSCspxyを生成します。このABC_TSCspxyのTSCアクセプタ名称はACCEPTOR-NAMEです。ACCEPTOR-NAMEがNULLの場合は，ACCEPTOR-NAMEは無視されます。

●CALL 'ABC-xxx' USING

            BY VALUE          SPROXY-HANDLE
            ...
            BY REFERENCE      CORBA-ENVIRONMENT
         (RETURNING ...).

項目	型・(入出力の区別)意味
引数	BY VALUE SPROXY-HANDLE USAGE POINTER	(入力)ABC_TSCspxyのポインタ
引数	BY REFERENCE CORBA-ENVIRONMENT	(出力)例外情報集団項目
戻り値	ユーザ定義IDLインタフェースに依存します。
例外	TSCSystemException（各種例外）ユーザ定義IDLインタフェース中のraisesに定義されたユーザ例外

ユーザ定義IDLインタフェースで定義された，ABCインタフェース内のxxxオペレーションを呼び出します。SPROXY-HANDLEとCORBA-ENVIRONMENT以外の引数，および戻り値はユーザ定義IDLインタフェースに依存します。

●CALL 'ABC_TSCspxy-DEL' USING

            BY VALUE          SPROXY-HANDLE
            BY REFERENCE      CORBA-ENVIRONMENT.

項目	型・(入出力の区別)意味
引数	BY VALUE SPROXY-HANDLE USAGE POINTER	(入力)ABC_TSCprxyのポインタ
引数	BY REFERENCE CORBA-ENVIRONMENT	(出力)例外情報集団項目
戻り値	ありません。

ABC_TSCspxyを削除します。