ABC_TSCprxy(COBOL)

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

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

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

ユーザ定義IDLインタフェースのマッピング

ユーザ定義IDLインタフェース内に定義されたオペレーションのCOBOL言語へのマッピングは,TPBrokerと同様です。

形式

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-POINTERABC_TSCprxyのポインタ

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

ユーザ定義IDLインタフェース依存副プログラム

●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を削除します。