Cosminexus サービスプラットフォーム システム構築・運用ガイド

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

HCSCサーバランタイム定義ファイル

形式

 
[historyrecord={ON|OFF}]
[historyrecord-data={ON|OFF}]
[historyrecord-binarylength={FULL|電文データの長さ}]
 
[methodtrace-filepath=メソッドトレース出力先パス]
[requesttrace-filepath=リクエストトレース出力先パス]
[methodtrace-filenum=メソッドトレース面数]
[requesttrace-filenum=リクエストトレース面数]
[methodtrace-filesize=メソッドトレースファイルサイズ]
[requesttrace-filesize=リクエストトレースファイルサイズ]
[methodtrace-level={1|2|3|4|5}]
[requesttrace={ON|OFF}]
[bptrace-level={0|10|20|30}]
[bptrace-filenum=BPトレースの面数]
[bptrace-filesize=BPトレースのサイズ]
 
[dab-bufsize=DABrokerからの受信データのバッファ長]
[jdbc-bufsize=JDBCで取り扱うバッファ長]
[jdbc-longvarbinary={REAL|LOCATOR}]
[jdbc-longvarbinary-access-size=HiRDBに一度に要求するデータの長さ]
[jdbc-maxbinarysize=取得するデータの最大長]
[jdbc-longvarbinary-truncerror={TRUE|FALSE}]
 
[request-ejb.instance.minimum=標準の同期受付(SessionBean)のインスタンス最小数]
[request-ejb.instance.maximum=標準の同期受付(SessionBean)のインスタンス最大数]
[request-ejb.ctm={true|false}]
[request-ejb.parallel.count=CTMがアプリケーションを呼び出すために用意するスレッド数]
[request-ejb.optional.name=標準の同期受付(SessionBean)の別名]
[request-soap.instance.minimum=標準の同期受付(Webサービス)の最小同時実行数]
[request-soap.instance.maximum=標準の同期受付(Webサービス)の最大同時実行数]
[request-soap.exclusive.threads=標準の同期受付(Webサービス)の占有スレッド数]
[request-soap.queue-size=標準の同期受付(Webサービス)の実行待ちキューのサイズ]
[request-jms.instance.maximum=標準の非同期受付(MDB(WS-R))のインスタンス最大数]
[receptionstop-monitor-timer=受付終了タイムアウト時間]
 
[soapfault-targetnamespace-filepath=SOAP Fault動作定義ファイルの絶対パス]
 
[xmltelegram-maxcache-num=XML電文をキャッシュできる数]
[telegram-validation={ON|OFF}]
 
[cscserver-connect-timeout=タイムアウト値]
 

機能

セットアップ後のHCSCサーバの定義情報をHCSC-Managerから設定します。

ファイルの格納先

 
<Cosminexusのインストールディレクトリ>\CSC\config\manager\templates\cscsvconfig.properties
 

設定できるプロパティ

(1)実行履歴管理

historyrecord={ON|OFF} 〜<<OFF>>

電文の実行履歴を採取するかどうかを指定します。HCSCサーバセットアップ定義ファイルのdb-useプロパティでOFFを指定した場合に,このプロパティでONを指定するとエラーになります。

historyrecord-data={ON|OFF} 〜<<OFF>>

電文の実行履歴の電文データ(ユーザ電文)を採取するかどうかを指定します。historyrecordプロパティでONを指定した場合だけ有効になります。

historyrecord-binarylength={FULL|電文データの長さ} 〜<英大文字または数字>((0−2147483639))<<0>>

採取する電文データ(ユーザ電文)の長さを指定します。historyrecordプロパティおよびhistoryrecord-dataプロパティでONを指定した場合だけ有効になります。

(2)ログトレース

methodtrace-filepath=メソッドトレース出力先パス 〜<文字列(2バイト文字含む)および空白><<<Cosminexusログ出力ディレクトリ>\csc\maintenance>>

メッセージング基盤,およびビジネスプロセス基盤のメソッドトレースの出力先パスを絶対パスで指定します。ディレクトリ区切りは「/」または「\\」を使用します。存在しないディレクトリを指定した場合は,省略値が使用されます。省略値はCosminexusの設定値に依存します。

requesttrace-filepath=リクエストトレース出力先パス 〜<文字列(2バイト文字含む)および空白><<<Cosminexusログ出力ディレクトリ>\csc>>

リクエストトレースの出力先パスを絶対パスで指定します。ディレクトリ区切りは「/」または「\\」を使用します。存在しないディレクトリを指定した場合は,省略値が使用されます。省略値はCosminexusの設定値に依存します。

methodtrace-filenum=メソッドトレース面数 〜<数字>((1−16))<<8>>

メソッドトレースの最大面数を指定します。

requesttrace-filenum=リクエストトレース面数 〜<数字>((1−16))<<4>>

リクエストトレースの最大面数を指定します。

methodtrace-filesize=メソッドトレースファイルサイズ 〜<数字>((4096−2147483647))<<2097152>>

メソッドトレースファイルの1面当たりの最大サイズをバイト単位で指定します。

requesttrace-filesize=リクエストトレースファイルサイズ 〜<数字>((4096−2147483647))<<2097152>>

リクエストトレースファイルの1面当たりの最大サイズをバイト単位で指定します。

methodtrace-level={1|2|3|4|5} 〜<<3>>

メソッドトレースの出力レベルを指定します。出力情報と出力レベルを次の表に示します。

出力情報 出力レベル
1 2 3 4 5
エラー情報(例外発生原因)
標準受付メソッドの入口/出口情報(クラス名,メソッド名,引数,戻り値) ×
外部(BPなど)のインターフェースの入口/出口情報(クラス名,メソッド名,引数,戻り値) × ×
コンポ内インターフェースの入口/出口情報(クラス名,メソッド名,引数,戻り値) × × ×
デバッグ情報(処理の分岐などの情報) × × × ×

(凡例)
○:出力されます。
×:出力されません。

注※ DBアダプタの場合は該当しません。

requesttrace={ON|OFF} 〜<<ON>>

リクエストトレースを採取するかどうかを指定します。

bptrace-level={0|10|20|30} 〜<<10>>

ビジネスプロセス基盤のメソッドトレースの出力レベルを指定します。

bptrace-filenum=BPトレースの面数 〜<数字>((1−16))<<16>>

ビジネスプロセス基盤のメソッドトレースの面数を指定します。

bptrace-filesize=BPトレースのサイズ 〜<数字>((4096−2147483647))<<2097152>>

ビジネスプロセス基盤のメソッドトレースのサイズをバイト単位で指定します。

(3)DB情報

dab-bufsize=DABrokerからの受信データのバッファ長 〜<数字>((10−16000))

HCSCサーバのオフライン時,データベースに格納されている電文の実行履歴情報を表示する場合に,Cosminexus DABroker Libraryからの受信データを格納するためのバッファ長をキロバイト単位で指定します。HCSCサーバセットアップ定義ファイルのjdbc-typeプロパティにDBPSVを指定した場合にだけ有効になります。

次の場合は,表示データ長に10を加えた値を指定します。

次の場合は,このプロパティに16000を指定し,さらにjdbc-longvarbinaryプロパティにLOCATORを指定します。

次の場合は,このプロパティの指定を省略できます。省略時は,DABrokerの省略時の動作に依存します(Driver.connectメソッドに指定するBUF_SIZEの値)。

jdbc-bufsize=JDBCで取り扱うバッファ長 〜<数字>((16−512))

HCSCサーバのオフライン時に,データベースに格納されている電文の実行履歴情報を表示するときのJDBCで取り扱うバッファ長をメガバイト単位で指定します。実行履歴情報を表示する際の電文データ長オプションで0(上限値なし)を指定している場合は,採取データ長に合わせて指定します。HCSCサーバセットアップ定義ファイルのjdbc-typeプロパティにDBPSVを指定し,かつdbc-longvarbinaryプロパティでLOCATORを指定した場合にだけ,有効になります。

次の場合は,このプロパティの指定を省略できます。省略時は,DABrokerの省略時の動作に依存します(Driver.connectメソッドに指定するROW_SIZEの値)。

jdbc-longvarbinary={REAL|LOCATOR} 〜<<REAL>>

HCSCサーバのオフライン時に,データベースに格納されている電文の実行履歴情報を表示するときに指定します。HCSCサーバセットアップ定義ファイルのjdbc-typeプロパティにDBPSVまたはHIRDB-TYPE4を指定した場合にだけ,有効になります。

jdbc-longvarbinary-access-size=HiRDBに一度に要求するデータの長さ 〜<数字>((0−2097151))

HCSCサーバのオフライン時,データベースに格納されている電文の実行履歴情報を表示する場合に,HiRDBに一度に要求するデータの長さをキロバイト単位で指定します。jdbc-typeプロパティにHIRDB-TYPE4を指定し,jdbc-longvarbinaryプロパティにLOCATORを指定した場合にだけ,有効になります。省略時は,HiRDB Type4 JDBC Driverの省略時の動作に依存します(DriverManager#getConnectionメソッドに指定するHiRDB_for_Java_LONGVARBINARY_ACCESS_SIZEの値)。

指定するデータの長さは,データベースに格納されている電文の実行履歴情報で,表示するユーザ電文の長さに応じて指定します。ユーザ電文は,次に示すデータ長でデータを分割して取得できます。

jdbc-longvarbinary-access-sizeプロパティで指定した値×1024(単位:バイト)

0を指定した場合は,データ全体を一度に要求します。ただし,定義長とメモリの設定によってメモリ不足が発生するおそれがあるため,注意する必要があります。

jdbc-maxbinarysize=取得するデータの最大長 〜<数字>((1−2147483647))<<64000>>

HCSCサーバのオフライン時,データベースに格納されている電文の実行履歴情報を表示する場合に,取得するデータの最大長をバイト単位で指定します。jdbc-typeプロパティにHIRDB-TYPE4を指定し,jdbc-longvarbinaryプロパティにREALを指定した場合にだけ,有効になります。

取得するデータの最大長は,電文の実行履歴で採取するユーザ電文の長さ(historyrecord-binarylengthプロパティで指定)に応じて指定します。なお,取得対象のデータがjdbc-maxbinarysizeプロパティで指定した値より大きい場合は,指定した値までのデータしか取得できません。

jdbc-longvarbinary-truncerror={TRUE|FALSE}

HCSCサーバのオフライン時,データベースに格納されている電文の実行履歴情報を表示する場合に,取得対象のデータが取得データの最大長を超えてしまい,すべてのデータを取得できないとき,エラーにするかどうかを指定できます。jdbc-typeプロパティにHIRDB-TYPE4を指定した場合にだけ,有効になります。省略時は,HiRDB Type4 JDBC Driverの省略時の動作に依存します(DriverManager#getConnectionメソッドに指定するHiRDB_for_Java_LONGVARBINARY_TRUNCERRORの値)。

(4)標準受付関連

request-ejb.instance.minimum=標準の同期受付(SessionBean)インスタンス最小数 〜<数字>((0,または1−request-ejb.instance.maximumプロパティでの設定値))<<request-ejb.instance.maximumプロパティでの設定値>>

プール内の標準の同期受付(SessionBean)のインスタンス最小数を指定します。HCSCサーバセットアップ定義ファイルのrequest-ejbプロパティでONを指定している場合だけ有効になります。

request-ejb.instance.maximum=標準の同期受付(SessionBean)インスタンス最大数 〜<数字>((1−1024))<<10>>

プール内の標準の同期受付(SessionBean)のインスタンス最大数を指定します。HCSCサーバセットアップ定義ファイルのrequest-ejbプロパティでONを指定している場合だけ有効になります。

CTMを使用している場合でCTMの同時実行数を動的に変更するときは,127以上を指定してください。

request-ejb.ctm={true|false} 〜<<false>>

CTM連携をするかどうかを指定します。HCSCサーバセットアップ定義ファイルのrequest-ejbプロパティでONを指定している場合だけ有効になります。

request-ejb.parallel.count=CTMがアプリケーションを呼び出すために用意するスレッド数 〜<数字>((1−127))<<1>>

CTMがアプリケーションを呼び出すために用意するスレッド数を指定します。request-ejb.ctmプロパティでtrueを指定している場合だけ有効になります。なお,request-ejb.instance.maximumプロパティで指定した値以下の値を指定してください。

request-ejb.optional.name=標準の同期受付(SessionBean)の別名 〜<英数字,アンダーライン(_),ピリオド(.),およびスラッシュ(/)>((1≦文字列長≦255))

標準の同期受付(SessionBean)の別名を指定します。このプロパティは,JavaVMのシステムプロパティでejbserver.cui.optionalname.enabledがtrueに設定されている場合だけ有効になります。ejbserver.cui.optionalname.enabledについては,マニュアル「Cosminexus リファレンス 定義編」を参照してください。なお,次の名前を指定した場合,リクエスト受付の起動に失敗します。

また,文字列の前後に空白または改行がある場合は,取り除かれて設定されます。文字列の途中に空白,改行がある場合はエラーになります。

request-soap.instance.minimum=標準の同期受付(Webサービス)最小同時実行数 〜<数字>((0,または1−request-soap.instance.maximumプロパティでの設定値))<<request-soap.instance.maximumプロパティでの設定値>>

プール内の標準の同期受付(Webサービス)の最小同時実行数を指定します。HCSCサーバセットアップ定義ファイルのrequest-soapプロパティでONを指定している場合だけ有効になります。

request-soap.instance.maximum=標準の同期受付(Webサービス)最大同時実行数 〜<数字>((1−1024))<<10>>

プール内の標準の同期受付(Webサービス)の最大同時実行数を指定します。HCSCサーバセットアップ定義ファイルのrequest-soapプロパティでONを指定している場合だけ有効になります。

request-soap.exclusive.threads=標準の同期受付(Webサービス)占有スレッド数 〜<数字>((0−1024))<<0>>

プール内の標準の同期受付(Webサービス)の占有スレッド数を指定します。最大同時実行数(request-soap.instance.maximum)を超えない範囲で値を指定してください。0を指定した場合,スレッドは占有されません。

なお,この指定値はWARの属性thread-control-exclusive-threadsに設定されます。このため,Webコンテナ全体の最大同時実行スレッド数や最大接続数などの値を考慮して指定する必要があります。

request-soap.queue-size=標準の同期受付(Webサービス)実行待ちキューのサイズ 〜<数字>((0−2147483647))<<8192>>

プール内の標準の同期受付(Webサービス)の実行待ちキューのサイズを指定します。

request-jms.instance.maximum=標準の非同期受付(MDB(WS-R))インスタンス最大数 〜<数字>((1−1024))<<10>>

プール内の標準の非同期受付(MDB(WS-R))のインスタンス最大数を指定します。HCSCサーバセットアップ定義ファイルのrequest-jmsプロパティでONを指定している場合だけ有効になります。

receptionstop-monitor-timer=受付終了タイムアウト時間 〜<数字>((0−600))<<0>>

標準受付,およびHCSCサーバ転送用受付サービス停止処理のタイムアウト時間を秒単位で指定します。0を指定した場合は,タイムアウトしません。

(5)サービスアダプタ関連

soapfault-targetnamespace-filepath=SOAP Fault動作定義ファイルの絶対パス〜<文字列>

SOAP Fault動作定義ファイルを絶対パスで指定します。ディレクトリ区切りは「/」または「\\」を使用します。このプロパティは,Webサービスのサービスアダプタで,WebサービスからのSOAP Faultをすべてユーザ定義例外として扱う場合に指定します。

(6)データ変換関連

xmltelegram-maxcache-num=XML電文をキャッシュできる数 〜<数字>((0−2147483647))<<0>>

XML電文オブジェクトをキャッシュできる数を指定します。キャッシュされたXML電文オブジェクトが再利用されることによって,同じ形式のXML電文の処理時間を短縮できます。XML電文が再利用されるためには,次に示す値以上の数を指定します。

 
(アダプタ・ビジネスプロセスのデータ変換設定数)+(ビジネスプロセスのパス操作設定数)
 

0を指定した場合は,キャッシュされません。

なお,要素数の少ないXML電文の場合,処理時間が遅くなることがあります。

telegram-validation={ON|OFF} 〜<<OFF>>

指定した電文フォーマットに対して,送受信する電文が適切かどうかを検証します(データ検証機能)。ONを指定した場合,HCSCサーバの処理性能に影響があるため,テスト環境やデバック環境で指定することをお勧めします。

データ検証機能については,マニュアル「Cosminexusサービスプラットフォーム 概説」を参照してください。

(7)実行タイマ監視

cscserver-connect-timeout=タイムアウト値 〜<数字>((0−86400))<<600>>

サーバ間連携の呼び出しを監視するためのタイムアウト値を秒単位で指定します。サービス実行監視タイマより大きな値を設定します。0を指定した場合は,タイムアウトしません。

記述例

サンプルファイルを次に示します。

 
historyrecord=ON
historyrecord-data=ON
historyrecord-binarylength=FULL
methodtrace-filepath=c:\\TMP
requesttrace-filepath=c:\\TMP
methodtrace-filenum=8
requesttrace-filenum=4
methodtrace-filesize=2097152
requesttrace-filesize=2097152
methodtrace-level=3
requesttrace=ON
bptrace-level=10
bptrace-filenum=16
bptrace-filesize=2097152
dab-bufsize=64
jdbc-bufsize=16
jdbc-longvarbinary=REAL
jdbc-maxbinarysize=64000
jdbc-longvarbinary-truncerror=TRUE
request-ejb.instance.minimum=10
request-ejb.instance.maximum=10
request-ejb.ctm=false
request-ejb.parallel.count=1
request-soap.instance.minimum=10
request-soap.instance.maximum=10
request-jms.instance.maximum=10
receptionstop-monitor-timer=0
cscserver-connect-timeout=600
 

使用方法

cscsvconfigコマンドの-propfileオプションの引数にHCSCサーバランタイム定義ファイルを指定します。詳細については,「3.1.4 HCSCサーバの定義情報を設定する」を参照してください。