ABC_TSCprxy（COBOL）

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

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

ABC_TSCprxyは，TSCユーザプロキシの実装クラスです。ユーザ定義IDLインタフェースに従って，ユーザデータをバイト配列データに変換し，TSCProxyObjectを呼び出します。なお，ユーザ定義IDLインタフェースに従って，トランザクションフレームジェネレータがABC_TSCprxyを自動生成します。

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

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

●CALL 'ABC_TSCprxy-NEW' USING

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

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

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

●CALL 'ABC-xxx' USING

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

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

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

●CALL 'ABC_TSCprxy-DEL' USING

            BY VALUE          PROXY-HANDLE
            BY REFERENCE      CORBA-ENVIRONMENT.

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

ABC_TSCprxyを削除します。