TSCClient(COBOL)

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

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

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

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

TSCデーモンに直結する場合のTSCClientの取得

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

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

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

TSCレギュレータを経由する場合のTSCClientの取得

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 POINTERTSCドメイン名称のポインタ
例外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 POINTERTSC識別子のポインタ
例外TSCBadParamException

TSC識別子を返します。

マルチスレッド環境での副プログラム呼び出し規則

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

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

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

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

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

インスタンスへの内部参照(アクセス)規則

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

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