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

[目次][索引][前へ][次へ]

TSCDomain(COBOL)

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

TSCDomainは,TSCドメイン情報およびTSC識別子情報を管理するホルダクラスです。

形式

 
CALL 'TSCDomain-NEW' USING
                 BY VALUE     DOMAIN-NAME
                 BY VALUE     TSCID
                 BY VALUE     FLAG
                 BY REFERENCE CORBA-ENVIRONMENT
            RETURNING   DOMAIN-PTR.
 
CALL 'TSCDomain-DELETE' USING
                 BY VALUE      DOMAIN-PTR
                 BY REFERENCE  CORBA-ENVIRONMENT.

副プログラム

●CALL 'TSCDomain-NEW' USING

            BY VALUE      DOMAIN-NAME
            BY VALUE      TSCID
            BY VALUE      FLAG
            BY REFERENCE  CORBA-ENVIRONMENT
         RETURNING         DOMAIN-PTR
 
項目 型・(入出力の区別)意味
引数 BY VALUE DOMAIN-NAME USAGE POINTER (入力)TSCドメイン名称
BY VALUE TSCID USAGE POINTER (入力)TSC識別子
BY VALUE FLAG PIC S9(9) COMP (入力)0または1のフラグ値
BY REFERENCE CORBA-ENVIRONMENT (出力)例外情報集団項目
戻り値 DOMAIN-PTR USAGE POINTER TSCDomainインスタンスのポインタ
例外 TSCBadParamException
TSCInitializeException

TSCDomainクラスのインスタンスを作成します。

FLAGの値によって動作が異なります。FLAGが"0"の場合,TSCドメイン名称だけからTSCDomainを作成します。TSCIDの指定は無視されます。FLAGが"1"の場合,TSCドメイン名称およびTSC識別子からTSCDomainを作成します。

DOMAIN-NAMEおよびTSCIDに文字列を指定する場合は,先頭が"TSC"または"tsc"ではない1〜31文字の英数字の文字列を指定してください。なお,TSCIDにIPアドレスを指定する場合は,ピリオド(.)も使用できます。また,DOMAIN-NAMEにNULLを指定する場合,TSCIDにNULLを指定する場合,またはFLAGに0を指定する場合は,アプリケーションプログラムの開始時に指定するコマンドオプション引数-TSCRetryReferenceの指定の有無によって管理する情報が異なります。

●CALL 'TSCDomain-DELETE' USING

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

TSCDomainクラスのインスタンスを削除します。