サーバアプリケーションの開始

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

●-TSCDomain TSCドメイン名称

～＜1～31文字の英数字＞《TSCDOMAIN》

自プロセスを管理するTSCドメイン名称を指定します。"TSC"または"tsc"で始まるTSCドメイン名称は指定しないでください。省略した場合は"TSCDOMAIN"が設定されます。

●-TSCID TSC識別子

～＜1～31文字の英数字，およびピリオド（.）＞《IPアドレス》

自プロセスを管理するTSC識別子を指定します。ピリオド（.）は，IPアドレスを指定する場合だけ使用できます。同じTSCドメインとTSC識別子を持つTSCデーモンが，同じコンピュータ内で開始している必要があります。

省略した場合は，IPアドレスがTSC識別子に設定されます。例えば，ホストのIPアドレスが"172.17.112.43"のとき，"172.17.112.43"という文字列がTSC識別子となります。

●-TSCAPID アプリケーション識別子

～＜1～32文字の英数字＞

開始するプロセスのアプリケーション識別子を指定します。-TSCDomainオプション，および-TSCIDオプションで指定したTSCノード内で一意となるように指定してください。

-TSCAPIDオプションを指定したサーバアプリケーションは，tscstopprcコマンドで終了できます。

●-TSCMyHost ホスト名称またはIPアドレス

～＜1～64文字の文字列＞《hostnameコマンドで取得されるホスト名称》

マルチホームドホスト環境でOTMが使用するホスト名称またはIPアドレスを指定します。省略した場合は，hostnameコマンドで取得されるホスト名称が設定されます。

-TSCMyHostオプションを指定する場合は，-OAipAddrオプションに-TSCMyHostオプションと同じコマンドオプション引数を指定してください。同じコマンドオプション引数を指定しないと，異常終了や例外発生などの予期しない動作が発生することがあります。-OAipAddrオプションについては，マニュアル「VisiBroker for C++　リファレンス」または「VisiBroker for Java　リファレンス」を参照してください。

-TSCIDオプションを省略して-TSCMyHostオプションを指定した場合，デフォルトのTSC識別子は-TSCMyHostオプションで指定したIPアドレスになります。

●-TSCRootAcceptor TSCルートアクセプタ登録名称

～＜1～31文字の英数字＞《default》

TSCルートアクセプタ登録名称を指定します。

-TSCRootAcceptorオプションの指定値は，TSCルートアクセプタ登録名称を指定しないで，TSCルートアクセプタの状態をactive状態に変更する場合に利用されます。省略した場合は"default"が設定されます。

●-TSCNice nice値

～＜符号なし整数＞《0》

自プロセスのnice値の増分を指定します。省略した場合，"0"が設定されます。指定値の範囲はOSが提供するniceの指定範囲に従います。

●-TSCTimeOut タイムアウト値

～＜符号なし整数＞((0～2147483647))《180》（単位：秒）

サービスの要求を送信してからサービスの応答が返るまでの待ち時間を指定します。また，接続・切断処理，リバインドで発生する通信，またはユーザオブジェクトの活性化・非活性化で発生する通信の時間を監視するためにも使用されます。"0"を指定した場合，無限に待ち続けます。省略した場合は"180（秒）"が設定されます。

●-TSCParallelCount 常駐スレッド数

～＜符号なし整数＞((1～127))《1》

TSCルートアクセプタ単位に常駐するスレッド数（パラレルカウント）を指定します。

省略した場合は"1"が設定されます。

●-TSCRequestPriority プライオリティ値

～＜符号なし整数＞((1～8))《4》

スケジュール用キューに滞留したリクエストを引き出すときのプライオリティ（優先順位）を指定します。指定値が小さいほどプライオリティは高くなります。

省略した場合は"4"が設定されます。

●-TSCAcceptor TSCアクセプタ名称

～＜1～31文字の英数字＞

TSCアクセプタ名称を指定します。

TSCアクセプタ名称を指定しないでTSCアクセプタのインスタンスを生成する場合に利用されます。

●-TSCRequestWay 1 | 0

～＜符号なし整数＞((1 | 0))《0》

サーバアプリケーションからの接続経路を指定します。なお，シングルスレッドライブラリを使用するアプリケーションプログラムの場合，TSCデーモンに直結したリクエストはできません。

"0"を指定すると，TSCデーモンに直結してリクエストします。

"1"を指定すると，TSCレギュレータを経由してリクエストします。TSCレギュレータによってコネクションのレギュレートを実行します。

省略した場合は"0"が設定されます。

●-TSCClientMessageBufferCount クライアント通信用バッファ数

～＜符号なし整数＞((1～64))《1》

TSCデーモンに直結するクライアントアプリケーションの通信用バッファの数を指定します。

TSCデーモンに直結するクライアントアプリケーションの場合，-TSCClientMessageBufferCountオプションで指定した値に従ってクライアント通信用バッファが生成されます。TSCレギュレータを経由するクライアントアプリケーションの場合，-TSCClientMessageBufferCountオプションは無視されます。

クライアント通信用バッファはクライアントアプリケーションがリクエストに対する応答をTSCデーモンから受信するためのバッファです。クライアントアプリケーションプロセス内で，特定のTSCデーモンに同時に要求するスレッド数が増加すると，通信用バッファに対して多数のスレッドが同時に要求するようになり，スレッド間での競合が増加します。そこで，同時に要求するスレッド数に応じてクライアント通信用バッファ数を増加することによって競合を減少できます。スレッド間での競合を増加させないで性能を維持するためには，要求するスレッド数"4"に対して，クライアント通信用バッファ数"1"を目安に指定することをお勧めします。

省略した場合は"1"が設定されます。

●-TSCRebindTimes リバインド回数

～＜符号なし整数＞((0～255))《0》

1回のメソッド呼び出しでリバインドを繰り返す回数を指定します。"0"を指定した場合はリバインドしないで，例外がクライアントアプリケーションに返されます。省略した場合は"0"が設定されます。

オートリバインド機能の詳細については，「2.1.3　TSCノードとのリバインド」を参照してください。

●-TSCRebindInterval リバインド間隔

～＜符号なし整数＞((0～65535))《15》（単位：秒）

リバインドが失敗してから，次のリバインドを実行するまでの間隔を指定します。省略した場合は"15（秒）"が設定されます。

●-TSCTimeOutRebind

TSCNoResponseExceptionクラスが内容コードTIMED_OUTで発生した場合にリバインドします。このオプションは，-TSCRebindTimesオプションを指定した場合だけ有効です。詳細については，「2.1.3　TSCノードとのリバインド」を参照してください。

●-TSCWatchTime クラス監視時間

～＜符号なし整数＞((0～2147483647))《300》（単位：秒）

TSCWatchTimeクラスの監視時間を指定します。監視時間を指定しないでTSCWatchTimeクラスのインスタンスを生成する場合に使用します。"0"を指定した場合，監視をしません。省略した場合は"300（秒）"が設定されます。

サーバアプリケーションの時間監視の機能については，「2.7.6　サーバアプリケーションの時間監視」を参照してください。

●-TSCWatchMethod メソッド監視時間

～＜符号なし整数＞((0～2147483647))《0》（単位：秒）

IDLファイルに記述したメソッド単位の実行監視時間を指定します。

指定した場合には，監視時間内にメソッドの処理が終了しないとき，プロセスを異常終了します。-TSCWatchMethodオプションとTSCWatchTimeクラスとは併用できます。また，TSCWatchTimeクラスをアプリケーションプログラム中で記述しない場合でも，メソッドの実行監視時間については-TSCWatchMethodオプションで設定できます。

"0"を指定した場合は監視をしません。省略した場合は"0"が設定されます。

●-TSCPort ポート番号

～＜符号なし整数＞((5001～65535))

サーバアプリケーションの新しいコネクションを探すときに使用するポート番号を指定します。省略した場合は，OSが自動的に割り当てたポート番号を使用します。

●-TSCRetryReference 接続先情報ファイル名称

UNIXの場合～＜英数字，ピリオド（.），スラント（/），コロン（:）^※，チルダ（~）^※，プラス（+），およびハイフン（-）＞

Windowsの場合～＜英数字，ピリオド（.），スラント（/）^※，円符号（\），コロン（:），チルダ（~）^※，プラス（+），およびハイフン（-）＞

注※: UNIXの場合の":"，"~"，およびWindowsの場合の"/"，"~"は，Javaアプリケーションで，接続先情報ファイルをURLで指定する場合だけ使用できます。

サーバアプリケーションからリクエストを送信するときの，TSCノードへの接続時に使用される接続先情報ファイルを指定します。接続先情報ファイルは相対パスまたは絶対パスで指定できます。

Javaアプリケーションの場合には，WWWサーバ上の接続先情報ファイルをURLで指定できます。接続先情報ファイルのURLは次に示す形式で指定してください。

 
<http>://<ホスト名またはIPアドレス>[:<ポート番号>]/<パス>

ただし，ローカルコンピュータ内のファイルを指定する場合は，接続先情報ファイル名称を上記の形式にはしないでください。

接続先情報ファイルはtscgetrefコマンドで作成してください。接続先情報ファイルの詳細については，「2.2　接続先情報ファイルを使用する接続」を参照してください。

●-TSCRetryWay マルチノードリトライ接続の接続方式

～＜4けたの符号なし整数＞《0000》

接続先情報ファイルを指定してマルチノードリトライ接続を実行する場合に，その接続方式を指定します。省略した場合は"0000（ファイル検索方式かつ順次方式）"が設定されます。

上位1けた目～2けた目: "00"を指定してください。

上位3けた目: マルチノードリトライ方式を指定します。; "0"を指定すると，ファイル検索方式で接続します。この場合，TSCAdmクラスのgetTSCClient()メソッドに指定した条件に従って，接続先情報ファイルから接続対象が選択されます。; "1"を指定すると，API優先方式で接続します。この場合，最初の接続では，TSCDomainオブジェクトに指定したTSCドメイン名称とTSC識別子を持つTSCノードに対してTPBrokerのスマートエージェントを使用します。接続に失敗した場合は，接続先情報ファイルから接続対象が選択されます。

上位4けた目: マルチノードリトライ順序を指定します。; "0"を指定すると，接続先情報ファイルの先頭から順に接続します（順次方式）。; "1"を指定すると，接続先情報ファイルからランダムに接続対象を選択して接続します（ランダム方式）。

-TSCRetryWayオプションの指定値と，実際に選択される接続対象の関係については，「2.2.4　マルチノードリトライ接続の接続対象」を参照してください。なお，-TSCRetryWayオプションは，-TSCRetryReferenceオプションで接続先情報ファイルが正しく指定されている場合だけ有効になります。

●-TSCSessionInterval セション呼び出しインターバル監視時間

～＜符号なし整数＞((1～2147483647))《180》（単位：秒）

セション呼び出し中のオブジェクトが，応答を返してから次のリクエストまたはセション呼び出しの終了要求を受け取るまでを監視する時間（最大時間間隔）を指定します。省略した場合は"180（秒）"が設定されます。

セション呼び出しインターバル監視時間がタイムアウトになった場合，TSCRootAcceptorクラスのdeactivate()メソッドと同じ処理をして，セション呼び出し待ち状態だったオブジェクトが使用されないようにします。セション呼び出しインターバル時間監視の詳細については，「2.4.5　セション呼び出しインターバル時間監視」を参照してください。

●-TSCQueueLength スケジュール用キュー長

～＜符号なし整数＞((1～32767))

TSCルートアクセプタ単位に生成されるスケジュール用キューの長さを指定します。

-TSCQueueLengthオプションを省略した場合は，TSCデーモンで保持しているスケジュール用キューの生成時の長さ（tscstartコマンドの-TSCMaxRequestCountオプションで指定した長さ）が有効になります。

スケジュール用キューを共有する場合，すでに生成されているスケジュール用キューの長さが優先されます。