TSCClient（COBOL）

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

TSCClientはシステム提供クラスです。

ABC_TSCprxyをTSCデーモンと関連づける場合，ABC_TSCprxyを生成する時点で，TSCClientはABC_TSCprxy-NEW副プログラムの引数に渡されます。

TSCClientは，TSCデーモン中のクライアントアプリケーション管理部分を表すクラスです。クライアントアプリケーション側からのTSCユーザオブジェクトの呼び出し要求は，TSCClientを経由してTSCデーモンに渡されます。

ユーザは，クライアントアプリケーションがTSCデーモンと接続するときにTSCClientを取得します。クライアントアプリケーションとTSCデーモンの接続には，TSCデーモンと直結する方法と，TSCレギュレータを経由する方法があります。次にTSCClientの特徴を示します。

属性としてTSCドメイン名称とTSC識別子を持ちます。

クライアントアプリケーションとTSCデーモン間の直結の接続は，クライアントアプリケーションプロセス内でTSCClientを最初に取得するときに確立されます。その後，同じTSCデーモンに対してTSCClientを取得する場合は，その接続を共有します。逆に，取得したすべてのTSCClientを解放すると接続が切断されます。

一つのクライアントアプリケーションから複数のTSCデーモンへ接続を確立することもできます。また，TSCユーザオブジェクト呼び出し要求が，この接続を経由してTSCデーモンに渡される場合，並行して処理されます。

ただし，シングルスレッドライブラリを使用するアプリケーションプログラムの場合，TSCデーモンに直結してリクエストできません。

TSCレギュレータを経由する場合のクライアントアプリケーションとTSCデーモン間の接続は，TSCClientを取得するたびに確立されます。逆に，TSClientを解放するたびに，割り当てられた接続が切断されます。

一つのクライアントアプリケーションから複数のTSCデーモンへ接続を確立することもできます。また，TSCユーザオブジェクト呼び出し要求がこの一つの接続を経由してTSCデーモンに渡される場合，並行して処理されないで順番に処理されます。

 
CALL 'TSCClient-getTSCDomainName' USING
            BY VALUE       CLIENT-PTR
            BY REFERENCE   CORBA-ENVIRONMENT
         RETURNING         DOMAIN-NAME.
 
CALL 'TSCClient-getTSCID' USING
            BY VALUE       CLIENT-PTR
            BY REFERENCE   CORBA-ENVIRONMENT
         RETURNING         TSCID.

●CALL 'TSCClient-getTSCDomainName' USING

            BY VALUE          CLIENT-PTR
            BY REFERENCE      CORBA-ENVIRONMENT
         RETURNING            DOMAIN-NAME.

項目	型・(入出力の区別)意味
引数	BY VALUE CLIENT-PTR USAGE POINTER	(入力)TSCClientのポインタ
引数	BY REFERENCE CORBA-ENVIRONMENT	(出力)例外情報集団項目
戻り値	DOMAIN-NAME USAGE POINTER	TSCドメイン名称のポインタ
例外	TSCBadParamException

TSCドメイン名称を返します。

●CALL 'TSCClient-getTSCID' USING

            BY VALUE          CLIENT-PTR
            BY REFERENCE      CORBA-ENVIRONMENT
         RETURNING            TSCID.

項目	型・(入出力の区別)意味
引数	BY VALUE CLIENT-PTR USAGE POINTER	(入力)TSCClientのポインタ
引数	BY REFERENCE CORBA-ENVIRONMENT	(出力)例外情報集団項目
戻り値	TSCID USAGE POINTER	TSC識別子のポインタ
例外	TSCBadParamException

TSC識別子を返します。

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

副プログラム	複数のスレッド上からの同時呼び出し
TSCClient-getTSCDomainName	できます。
TSCClient-getTSCID	できます。

インスタンスの副プログラム呼び出しの内部参照（アクセス）規則

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

副プログラム	内部参照
TSCClient-getTSCDomainName	ありません。
TSCClient-getTSCID	ありません。

TSCClientクラスのインスタンスを解放したあと，このインスタンスを内部参照するインスタンスからのアクセスは，メモリアクセス違反となります。OTMは，その際の動作を保証しません。

また，複数のスレッドから同時にこのクラスの同じインスタンスを内部参照できます。