Cosminexus V9 BPM/ESB基盤 サービスプラットフォーム リファレンス

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

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

形式

 
[methodtrace-filepath=メソッドトレース・例外ログ出力先パス]
[requesttrace-filepath=リクエストトレース出力先パス]
[telegramtrace-filepath=ユーザ電文トレース出力先パス]
[methodtrace-filenum=メソッドトレース面数]
[requesttrace-filenum=リクエストトレース面数]
[telegramtrace-filenum=ユーザ電文トレース面数]
[methodtrace-filesize=メソッドトレースファイルサイズ]
[requesttrace-filesize=リクエストトレースファイルサイズ]
[telegramtrace-filesize=ユーザ電文トレースファイルサイズ]
[telegramtrace-trigger={NORMAL|SYSERR|FAULT|DTERR}]
[telegramtrace-component-type-filepath=ユーザ電文トレースのコンポーネント種別設定ファイルのパス]
[telegramtrace-component-id-filepath=ユーザ電文トレースのコンポーネントID設定ファイルのパス]
 
[methodtrace-level={1|2|3|4|5}]
[requesttrace={ON|OFF}]
[telegramtrace={ON|OFF}]
[bptrace-level={0|10|20|30}]
[bptrace-filenum=BPトレースの面数]
[bptrace-filesize=BPトレースのサイズ]
[bpexptrace-filenum=ビジネスプロセス基盤の例外ログ面数]
[bpexptrace-filesize=ビジネスプロセス基盤の例外ログファイルサイズ]
[cscexptrace-filenum=メッセージング基盤の例外ログ面数]
[cscexptrace-filesize=メッセージング基盤の例外ログファイルサイズ]
 
[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サービス・SOAP1.1)の最小同時実行数]
[request-soap.instance.maximum=標準の同期受付(Webサービス・SOAP1.1)の最大同時実行数]
[request-soap.exclusive.threads=標準の同期受付(Webサービス・SOAP1.1)の占有スレッド数]
[request-soap.queue-size=標準の同期受付(Webサービス・SOAP1.1)の実行待ちキューのサイズ]
[request-soap1_2.instance.minimum=標準の同期受付(Webサービス・SOAP1.2)の最小同時実行数]
[request-soap1_2.instance.maximum=標準の同期受付(Webサービス・SOAP1.2)の最大同時実行数]
[request-soap1_2.exclusive.threads=標準の同期受付(Webサービス・SOAP1.2)の占有スレッド数]
[request-soap1_2.queue-size=標準の同期受付(Webサービス・SOAP1.2)の実行待ちキューのサイズ]
[request-jms.instance.maximum=標準の非同期受付(MDB(WS-R))のインスタンス最大数]
[request-jms.rollback-count=標準の非同期受付(MDB(WS-R))ロールバック警告メッセージ出力回数]
[receptionstop-monitor-timer=受付キュー監視タイムアウト時間]
[csc-receptionstop-timeout=受付終了待ち通信タイムアウト時間]
 
[soapfault-targetnamespace-filepath=SOAP Fault動作定義ファイルの絶対パス]
[soapfault-handling-mode={DETAIL|FAULTCODE}]
[oa-adapter-character-code=Object Accessアダプタがサービス部品と送受信する電文の文字コード]
 
[formatdef-maxcache-num=フォーマット定義をキャッシュできる数]
[transformdef-maxcache-num=サーバ単位にデータ変換定義をキャッシュできる数]
[xmltelegram-maxcache-num=XML電文をキャッシュできる数]
[telegram-validation={ON|OFF}]
[xmltelegram-namespace-complement={ON|OFF}]
[telegram-undefined-character-code={ERROR|REPLACE}]
[telegram-notfound-soapheader={ERROR|IGNORE}]
[validation-activity={ON|OFF}]
[transform-binary-error-check={ON|OFF}]
[code-table-root-path=コード変換テーブル格納パスのルートパスの絶対パス]
 
[syserr-to-fault-convert={ON|OFF}]
[validate-fault-compatible={ON|OFF}]
[bp-reply-after-min-thread-pool-size=応答アクティビティ後のアクティビティを実行するために使用するスレッドの最小数]
[bp-reply-after-max-thread-pool-size=応答アクティビティ後のアクティビティを実行するために使用するスレッドの最大数]
[bp-reply-after-thread-pool-keep-alive=応答アクティビティ後のアクティビティを実行するために使用するスレッドの保持時間]
 
[j2ee-stopapp-timeout=J2EEアプリケーション停止監視時間]
[startcsc-timeout=J2EEサーバ起動監視時間]
[stopcsc-timeout=J2EEサーバ停止監視時間]
 
[csc-command-timeout=コマンドタイムアウト時間]
[csc-precache-timeout=事前キャッシュ処理のためのビジネスプロセスへのEJB通信のタイムアウト時間]
 
[cookie-parsing={ON|OFF}]
 
[work-folder=作業フォルダルートの絶対パス]
[common-folder-<共通フォルダ定義名>=共通フォルダの絶対パス]
 
[dba-separate-transaction={true|false}]
 
[common-uoc-prop-path=コンポーネント共通UOC用プロパティファイル格納フォルダ]
 
[short-processid-servername=プロセスインスタンスの識別子で使用するHCSCサーバ名の識別子]
[short-processid={ON|OFF}]
 
[xml-pooled-instance-minimum=XML処理に使用するクラスのインスタンスプールの最小数]
[xml-pooled-instance-maximum=XML処理に使用するクラスのインスタンスプールの最大数]
 
[request-id-separate-key={slash|atsign|period}]
[fileevent-reception.monitored-file.enabled={true|false}]
[fileevent-reception.monitored-folder=監視フォルダのパス]
[fileevent-reception.monitor-interval=ファイル監視の間隔]
[fileevent-reception.monitor-starting.delay=ファイル監視の開始待ち時間]
 

機能

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

ファイルの格納先

 
<サービスプラットフォームのインストールディレクトリ>\CSC\config\manager\templates\cscsvconfig.properties
 

設定できるプロパティ

(1)ログトレース

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

メッセージング基盤およびビジネスプロセス基盤の,メソッドトレースと例外ログの出力先パスを絶対パスで指定します。

ディレクトリ区切りは「/」または「\\」を使用します。存在しないディレクトリを指定した場合は,省略値が使用されます。省略値はサービスプラットフォームの設定値に依存します。

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

リクエストトレースの出力先パスを絶対パスで指定します。requesttraceプロパティでONを設定した場合だけ有効になります。

ディレクトリ区切りは「/」または「\\」を使用します。存在しないディレクトリを指定した場合は,省略値が使用されます。省略値はサービスプラットフォームの設定値に依存します。

telegramtrace-filepath=ユーザ電文トレース出力先パス 〜<文字列(2バイト文字含む)および空白><<<J2EEサーバのログ出力先ディレクトリ>\csc>>

ユーザ電文トレースの出力先パスを絶対パスで指定します。telegramtraceプロパティでONを設定した場合だけ有効になります。

ディレクトリ区切りは「/」または「\\」を使用します。存在しないディレクトリを指定した場合は,省略値が使用されます。省略値はサービスプラットフォームの設定値に依存します。

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

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

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

リクエストトレースの最大面数を指定します。requesttraceプロパティでONを設定した場合だけ有効になります。

telegramtrace-filenum=ユーザ電文トレース面数 〜<数字>((1−16))<<4>>

ユーザ電文トレースの最大面数を指定します。telegramtraceプロパティでONを設定した場合だけ有効になります。

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

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

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

リクエストトレースファイルの1面当たりの最大サイズをバイト単位で指定します。requesttraceプロパティでONを設定した場合だけ有効になります。

telegramtrace-filesize=ユーザ電文トレースファイルサイズ 〜<数字>((4096−2147483647))<<2097152>>

ユーザ電文トレースファイルの1面当たりの最大サイズをバイト単位で指定します。telegramtraceプロパティでONを設定した場合だけ有効になります。

telegramtrace-trigger={NORMAL|SYSERR|FAULT|DTERR} 〜<<NORMAL>>

ユーザ電文トレースの出力契機を指定します。telegramtraceプロパティでONを設定した場合だけ有効になります。

NORMAL,SYSERR,FAULTの出力契機と,出力される電文との組み合わせは次のとおりです。

出力契機 タイミング 電文の種類
要求電文 応答電文 フォルト電文
NORMAL 正常処理時 ×
システム例外検出時 × × ×
フォルト検出時(catchなし) × × ×
フォルト検出時(catchあり) × × ×
SYSERR 正常処理時 × × ×
システム例外検出時 × ×
フォルト検出時(catchなし) × ×
フォルト検出時(catchあり) × × ×
FAULT 正常処理時 × × ×
システム例外検出時 × × ×
フォルト検出時(catchなし) ×
フォルト検出時(catchあり) ×

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

DTERRの出力契機と,出力される情報との組み合わせは次のとおりです。

出力契機 タイミング 出力される情報
DTERR バイナリデータの読込処理(バイナリ→DOMの変換)時 エラー発生時までに処理できた電文(バイナリ,DOM)の情報
バイナリデータの生成処理(DOM→バイナリの変換)時 エラー発生時までに処理できた電文(DOM)の情報

設定値はコンマ区切りで複数指定できます。複数の契機を指定した場合も,同じ情報は繰り返し出力されません。例えば,正常処理時に要求電文が出力済みであった場合,システム例外時またはフォルト検出時には出力されません。

telegramtrace-component-type-filepath=ユーザ電文トレースのコンポーネント種別設定ファイルのパス 〜<文字列(2バイト文字含む)および空白>

ユーザ電文トレースに特定のコンポーネント種別の情報だけを出力したい場合,コンポーネント種別が記述されたコンポーネント種別設定ファイルを絶対パスで指定します。ディレクトリ区切りは「/」または「\\」を使用します。存在しないファイルを指定した場合は,エラーになります。

telegramtraceプロパティでON,telegramtrace-triggerプロパティでNORMALを設定した場合だけ有効になります。

コンポーネント種別設定ファイルの定義方法については,「コンポーネント種別設定ファイル」を参照してください。

なお,正常処理時のユーザ電文トレースの出力対象とするHCSCコンポーネントは,次の2とおりの方法で指定できます。同じHCSCコンポーネントに対して,コンポーネントID設定ファイルとコンポーネント種別設定ファイルの両方で設定した場合,コンポーネントID設定ファイルの設定が適用されます。

HCSCコンポーネントを指定したユーザ電文トレースの出力内容については,マニュアル「サービスプラットフォーム システム構築・運用ガイド」の「7.4.4 ユーザ電文トレース」を参照してください。

telegramtrace-component-id-filepath=ユーザ電文トレースのコンポーネントID設定ファイルのパス 〜<文字列(2バイト文字含む)および空白>

ユーザ電文トレースに特定のHCSCコンポーネントの情報だけを出力したい場合,HCSCコンポーネントのIDと出力要否を記述したコンポーネントID設定ファイルを絶対パスで指定します。ディレクトリ区切りは「/」または「\\」を使用します。存在しないファイルを指定した場合は,エラーになります。

telegramtraceプロパティでON,telegramtrace-triggerプロパティでNORMALを設定した場合だけ有効になります。

コンポーネントID設定ファイルの定義方法については,「コンポーネントID設定ファイル」を参照してください。

なお,正常処理時のユーザ電文トレースの出力対象とするHCSCコンポーネントは,次の2とおりの方法で指定できます。同じHCSCコンポーネントに対して,コンポーネントID設定ファイルとコンポーネント種別設定ファイルの両方で設定した場合,コンポーネントID設定ファイルの設定が適用されます。

HCSCコンポーネントを指定したユーザ電文トレースの出力内容については,マニュアル「サービスプラットフォーム システム構築・運用ガイド」の「7.4.4 ユーザ電文トレース」を参照してください。

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

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

出力情報 出力レベル
1 2 3 4 5
入力ファイルおよび出力ファイルの情報(ファイルパス,ファイルの形式,ファイルサイズ,レコード数)※1 ※1 ※1 ※1 ※1 ※1
標準受付メソッドの入口/出口情報(クラス名,メソッド名,引数,戻り値)※2 ×※2 ※2 ※2 ※2 ※2
外部(BPなど)のインターフェースの入口/出口情報(クラス名,メソッド名,引数,戻り値) × ×
コンポーネント内インターフェースの入口/出口情報(クラス名,メソッド名,引数,戻り値) × × ×
デバッグ情報(処理の分岐などの情報) × × × ×

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

注※1
ファイル変換オペレーションの場合だけ出力します。

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

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

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

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

ユーザ電文トレースを採取するかどうかを指定します。デバッグ情報を出力する場合はONを指定してください。

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

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

出力レベル 出力内容
0 エラー情報
10 エラー情報,他プログラムとの入出力/データ
主要な関数の入出力/データ
ビジネスプロセスのデバッグ実行機能が実行する通信の開始/終了,デバッグ処理の開始/終了
20 エラー情報,他プログラムとの入出力/データ
関数の入出力/データ
30 エラー情報,他プログラムとの入出力情報
関数の入出力/データ
主要な個所のポイント情報

注※
メッセージング基盤,データ変換基盤も含みます。

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

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

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

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

bpexptrace-filenum=ビジネスプロセス基盤の例外ログ面数 〜<数字>((1−16))<<16>>

ビジネスプロセス基盤の例外ログの最大面数を指定します。

bpexptrace-filesize=ビジネスプロセス基盤の例外ログファイルサイズ 〜<数字>((4096−2147483647))<<2097152>>

ビジネスプロセス基盤の例外ログファイルの1面当たりの最大サイズをバイト単位で指定します。

cscexptrace-filenum=メッセージング基盤の例外ログ面数 〜<数字>((1−16))<<16>>

メッセージング基盤の例外ログの最大面数を指定します。

cscexptrace-filesize=メッセージング基盤の例外ログファイルサイズ 〜<数字>((4096−2147483647))<<2097152>>

メッセージング基盤の例外ログファイルの1面当たりの最大サイズをバイト単位で指定します。

 

(2)標準受付関連

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)の別名を指定します。標準受付を利用する場合はすべてのHCSCサーバで同じ別名を設定してください。

このプロパティは,JavaVMのシステムプロパティでejbserver.cui.optionalname.enabledがtrueに設定されている場合だけ有効になります。ejbserver.cui.optionalname.enabledについては,マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「5.4 usrconf.properties(サーバ管理コマンド用システムプロパティファイル)」を参照してください。

なお,次の名前を指定した場合,リクエスト受付の起動に失敗します。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

request-jms.rollback-count=標準の非同期受付(MDB(WS-R))ロールバック警告メッセージ出力回数 〜<数字>((1−2147483647))<<0>>

MDB(WS-R)受付で,キューから同一メッセージの抜き出しとロールバックが指定した回数以上実行された場合に,警告メッセージ(KDEC00049-W)を出力します。0を指定した場合は,警告メッセージを出力しません。

receptionstop-monitor-timer=受付キュー監視タイムアウト時間 〜<数字>((0−600))<<0>>

非同期標準受付(MDB(WS-R),MDB(DBキュー))のメッセージ処理のタイムアウト時間を秒単位で指定します。

キューの最大メッセージ数とメッセージ1件当たりの処理時間から,キューの中に仕掛かり中のメッセージが残る最大時間を算出して,それより大きな秒数を指定してください。0以外を指定する場合は,csc-receptionstop-timeoutプロパティにも値を指定する必要があります。

なお,次のどちらかに該当する場合は,デフォルト値(タイムアウトしない)のままでかまいません。

0を指定した場合はタイムアウトしません。なお,Reliable Messagingにデッドメッセージキューを設定しない場合,ロールバックによって無限ループになるおそれがあるため,0は指定しないでください。

csc-receptionstop-timeout=受付終了待ち通信タイムアウト時間 〜<数字>((0−86400))<<csc-command-timeoutプロパティの設定値>>

非同期標準受付(MDB(WS-R),MDB(DBキュー))の通信処理のタイムアウト時間を秒単位で指定します。receptionstop-monitor-timerプロパティの設定値より長いタイムアウト時間を指定してください。

なお,次のどちらかに該当する場合は,デフォルト値(csc-command-timeoutプロパティの設定値)のままでかまいません。

0を指定した場合はタイムアウトしません。

 

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

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

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

SOAP Fault動作定義ファイルの詳細については,「6.6 SOAP連携で利用するファイル」の「SOAP Fault動作定義ファイル」を参照してください。

soapfault-handling-mode={DETAIL|FAULTCODE} 〜<<FAULTCODE>>

SOAPアダプタでWebサービスからのSOAP Faultをフォルトとして扱うかどうか判別する処理の動作モードを指定します。このプロパティには「DETAIL」を指定することを推奨します。09-70以前との互換性を重視する場合は,「FAULTCODE」を指定してください。

oa-adapter-character-code={SJIS|MS932} 〜<<SJIS>>

Object Accessアダプタがサービス部品と送受信する電文の文字コードを指定するプロパティです。

すべてのObject Accessアダプタで,指定した文字コードが使用されます。

 

(4)データ変換関連

formatdef-maxcache-num=フォーマット定義をキャッシュできる数 〜<数字>((1−2147483647))<<2147483647>>

フォーマット定義をキャッシュできる数を指定します。HCSCサーバで使用するフォーマット定義は,次に示す数の総和です。

総和を超えた値を設定した場合でも,必要なメモリ以上メモリを使用することはありません。リポジトリ中の全フォーマット定義をキャッシュさせたい場合は,大きい値を設定してください。

transformdef-maxcache-num=サーバ単位にデータ変換定義をキャッシュできる数 〜<数字>((1−2147483647))<<2147483647>>

データ変換定義をキャッシュできる数を指定します。データ変換定義が再利用されるためには,定義したデータ変換の数以上の数を指定します。

定義したデータ変換の数以上の数を指定した場合でも,必要なメモリ以上メモリを使用することはありません。リポジトリ中の全データ変換定義をキャッシュさせたい場合は,大きい値を設定してください。

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

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

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

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

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

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

指定した電文フォーマットに対して,送受信する電文が適切かどうかを検証します(データ検証機能)。

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

xmltelegram-namespace-complement={ON|OFF} 〜<<OFF>>

HCSCサーバ内を流れるXML電文に対して,XML電文内に存在する属性値に指定した名前空間接頭辞に対応する名前空間宣言を補完するかどうかを指定します。

HCSCサーバ内を流れるユーザ電文で,XMLスキーマの属性値の型にQName型を使用する場合は,ONを指定してください。ただし,ONを指定すると,OFFを指定した場合よりも電文サイズが大きくなるため注意してください。

詳細については,マニュアル「サービスプラットフォーム 解説」の「4.5 XML電文内の属性値に指定した名前空間接頭辞の補完」を参照してください。

telegram-undefined-character-code={ERROR|REPLACE} 〜<<ERROR>>

バイナリデータの文字コード変換処理で,未定義の文字コードが検出された場合の動作を指定します。

telegram-notfound-soapheader={ERROR|IGNORE} 〜<<IGNORE>>

受付定義ファイル,サービスアダプタ定義ファイル,またはビジネスプロセス定義ファイルに対して,送受信する電文に指定されたヘッダが存在しない場合に処理を継続するかどうかを指定します。

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

検証アクティビティでメッセージ型変数(XML)を検証するかどうかを定義します。HCSCサーバ内すべてのビジネスプロセスの検証アクティビティが対象となります。

transform-binary-error-check={ON|OFF} 〜<<ON>>

バイナリデータ変換時のエラーチェックの実施有無を定義します。データ変換アクティビティの延長で,生成したバイナリデータがバイナリフォーマット定義に沿っているかをチェックできます。

code-table-root-path=コード変換テーブル格納パスのルートパスの絶対パス 〜<文字列(2バイト文字含む)および空白><<<サービスプラットフォームのインストールディレクトリ>\\CSC\\userlib\\codetables>>

コード変換テーブル格納パスのルートパスを絶対パスで指定します。ディレクトリ区切りは「/」または「\\」を使用します。存在しないディレクトリを指定した場合は,HCSCサーバの起動に失敗します。

 

(5)ビジネスプロセス関連

syserr-to-fault-convert={ON|OFF} 〜<<OFF>>

データ変換アクティビティ,代入アクティビティ,分岐アクティビティでシステム例外が発生した場合に,汎用フォルトを発生させるかどうかを定義します。

validate-fault-compatible={ON|OFF} 〜<<ON>>

検証フォルトで送られるフォルト電文のフォーマットを09-00以前まで使用していたフォーマットとするかどうかを定義します。

bp-reply-after-min-thread-pool-size=応答アクティビティ後のアクティビティを実行するために使用するスレッドの最小数 〜<数字>((1−2147483647))<<16>>

応答アクティビティ後のアクティビティを実行するために使用するスレッドの,スレッドプール内で使用していないスレッドを保存する最小数を定義します。

定義内容はHCSCサーバ単位で有効となるため,HCSCサーバ内で応答後にアクティビティを定義したビジネスプロセスの同時実行数を考慮した値を設定してください。

bp-reply-after-max-thread-pool-sizeより大きい値を設定した場合は,cscsvconfigコマンド実行時にエラーとなります。

bp-reply-after-max-thread-pool-size=応答アクティビティ後のアクティビティを実行するために使用するスレッドの最大数 〜<数字>((1−2147483647))<<32>>

応答アクティビティ後のアクティビティを実行するために使用するスレッドの,スレッドプール内に生成できる最大数を定義します。

定義内容はHCSCサーバ単位で有効となるため,HCSCサーバ内で応答後にアクティビティを定義したビジネスプロセスの同時実行数を考慮した値を設定してください。

bp-reply-after-thread-pool-keep-alive=応答アクティビティ後のアクティビティを実行するために使用するスレッドの保持時間 〜<数字>((1−2147483647))<<60>>

応答アクティビティ後のアクティビティの実行で使用していないスレッド数が,bp-reply-after-min-thread-pool-sizeで指定した数を超えている場合,スレッドの終了までに保存しておく時間(単位:秒)を定義します。

定義内容はHCSCサーバ単位で有効となるため,HCSCサーバ内で応答後にアクティビティを定義したビジネスプロセスの同時実行数を考慮した値を設定してください。

 

(6)J2EE関連

j2ee-stopapp-timeout=J2EEアプリケーション停止監視時間 〜<数字>((0−2147483647))<<60>>

リクエスト受付停止,ビジネスプロセスまたはサービスアダプタの停止コマンドで発行するJ2EEアプリケーションが停止した際の監視時間を秒単位で指定します。リクエスト処理中の場合,指定された時間だけ待機します。

タイムアウト発生後,リクエスト受付,ビジネスプロセス,サービスアダプタを強制停止します。

startcsc-timeout=J2EEサーバ起動監視時間 〜<数字>((1−2147483647))<<180>>

HCSCサーバ起動コマンドで,J2EEサーバ起動を監視する監視値を秒単位で指定します。HCSCサーバ起動コマンドでタイムアウトが発生しても,J2EEサーバの起動処理は継続されます。

なお,09-50以降でこのプロパティを設定しても無効になるため,設定は不要です。

stopcsc-timeout=J2EEサーバ停止監視時間 〜<数字>((1−2147483647))<<180>>

HCSCサーバ停止コマンドで,J2EEサーバ停止を監視する監視時間を秒単位で指定します。HCSCサーバ停止コマンドでタイムアウトが発生しても,J2EEサーバの停止処理は継続されます。

なお,09-50以降でこのプロパティを設定しても無効になるため,設定は不要です。

 

(7)コマンドの通信のタイムアウト時間の監視

csc-command-timeout=コマンドタイムアウト時間 〜<数字>((0−86400))<<300>>

次に示す機能で,J2EEサーバのスローダウンや,J2EEサーバとデータベースの間で通信障害が発生した場合に,クライアント側に通知するためのタイムアウト時間を秒単位で指定します。

0を指定した場合は,タイムアウトしません。

csc-precache-timeout=事前キャッシュ処理のためのビジネスプロセスへのEJB通信のタイムアウト時間 〜<数字>((0−86400))<<0>>

各ビジネスプロセスでの事前キャッシュ処理のタイムアウト時間を秒単位で指定します。

0を指定した場合は,タイムアウトしません。

 

(8)Cookie情報の引き継ぎ

cookie-parsing={ON|OFF} 〜<<OFF>>

Cookie情報を引き継ぐかどうかを指定します。

 

(9)フォルダ関連

work-folder=作業フォルダルートの絶対パス 〜<文字列(2バイト文字含む)および空白><<<サービスプラットフォームのインストールディレクトリ>\\CSC\\spool\\ftp\\work>>

作業フォルダルートを絶対パスで指定します。ディレクトリ区切りは「/」または「\\」を使用します。存在しないディレクトリを指定した場合は,HCSCサーバの起動に失敗します。

指定した作業フォルダの配下には,製品として153バイトのパスが必要です。任意の作業フォルダルートを指定する場合は,OSの最大パス長を超えないようにしてください。

common-folder-<共通フォルダ定義名>=共通フォルダの絶対パス 〜<文字列(2バイト文字含む)および空白>((1≦文字列長≦64))<<<サービスプラットフォームのインストールディレクトリ>\\CSC\\spool\\ftp\\com>>

共通フォルダの絶対パスを指定します。異なる共通フォルダ定義名を指定すると,同じディレクトリを指定できます。

<共通フォルダ定義名>
共通フォルダ定義名に指定できる値は,半角英数字とアンダーバー(_)です。
指定を省略した場合の共通フォルダ定義名は「default」になります。
 

共通フォルダの絶対パス
ディレクトリ区切りは「/」または「\\」を使用します。存在しないディレクトリを指定した場合は,HCSCサーバの起動に失敗します。
なお,共通フォルダの使用時は,共通フォルダの配下に次に示す長さのパスが作成されます。これを考慮して,パス全体の長さがOSの最大パス長を超えないよう共通フォルダを指定してください。
 
ユーザ指定ファイル名の長さ+106バイト
 
なお,HTTPアダプタとメールアダプタの場合は,機能に応じて使用するパスの長さが異なります。機能ごとに必要なパス長を次に示します。
サービスアダプタの種類 使用する機能 パス全体の長さ※1
HTTPアダプタ HTTPリクエストでファイルを送信する場合 以下を合計したバイト数
  • 共通フォルダルートのパスのバイト数
  • 共通フォルダの配下のパスのバイト数(106バイト※2
  • 使用するファイル名のバイト数
HTTPレスポンスでファイルをダウンロードする場合 以下を合計したバイト数
  • 共通フォルダルートのパスのバイト数
  • 共通フォルダの配下のパスのバイト数(156バイト※2
メールアダプタ メール本文として使用するファイルを送信する場合 以下を合計したバイト数
  • 共通フォルダルートのパス
  • 共通フォルダの配下のパスのバイト数(106バイト※2
  • 使用するファイル名のバイト数
メールの添付ファイルを送信する場合

注※1
サブフォルダを使用する場合は,サブフォルダの相対パス長も加算されます。

注※2
サブフォルダを使用する場合は,さらにパス長が1バイト加算されます。

 

(10)DBアダプタ関連

dba-separate-transaction={true|false} 〜<<false>>

DBアダプタのトランザクションをビジネスプロセスとは別に開始するかどうかを指定します。

ビジネスプロセスとは別にDBアダプタのトランザクションを開始する場合,「true」を指定するか,SQLオペレーション定義ファイルのdba_separate_transaction属性に「Y」を指定したうえで,DBアダプタのアプリケーション統合属性ファイルのtrans-attribute要素指定値をRequiredからRequiresNewに変更してください。

 

(11)コンポーネント共通UOC関連

common-uoc-prop-path=コンポーネント共通UOC用プロパティファイル格納フォルダ 〜<文字列(2バイト文字含む)>

コンポーネント共通UOC用プロパティファイルの格納フォルダを絶対パスで指定します。フォルダ区切りは「/」または「\\」を使用してください。なお,プロパティ名だけ指定して格納フォルダを指定しないと,HCSCサーバランタイム定義ファイルの読み込み時に例外が発生します。

コンポーネント共通UOC用プロパティファイルを指定すると,コンポーネント共通UOC機能が使用され,UOCクラスの呼び出しの前後で性能解析トレースが出力されます。

コンポーネント共通UOC用プロパティファイルの指定方法については,マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「付録G コンポーネント共通UOC」を参照してください。また,コンポーネント共通UOC機能で出力される性能解析トレースについては,マニュアル「サービスプラットフォーム システム構築・運用ガイド」の「7.4.3 性能解析トレース」を参照してください。

 

(12)HCSCサーバ関連

short-processid-servername=プロセスインスタンスの識別子で使用するHCSCサーバ名の識別子 〜<半角英数字,アンダーバー(_)>((1−8文字))<<HCSCサーバ名>>

プロセスインスタンスの識別子で使用するHCSCサーバ名の識別子を指定します。クラスタ内で一意となる識別子を設定してください。一意でない値を設定した場合は動作を保障しません。

このプロパティは,short-processidプロパティでONを指定した場合だけ有効です。

short-processid={ON|OFF} 〜<<OFF>>

プロセスインスタンスの識別子を短縮するかどうかを設定します。ローカルマシンにIPv6アドレスを使用し,かつJ2EEサーバ名が111バイト以上である場合は,プロセスインスタンスの生成でエラーが発生する可能性があります。その場合はONを指定してください。

 

(13)インスタンスのプール

xml-pooled-instance-minimum=XML処理に使用するクラスのインスタンスプールの最小数 〜<数字>((0−2147483647))<<0>>

要求電文・応答電文の処理に使用するクラスのインスタンスをキャッシュする最小数を指定します。xml-pooled-instance-maximumプロパティの設定値以下の値を設定してください。xml-pooled-instance-maximumプロパティより大きい値を設定すると,cscsvconfigコマンドの実行時にエラーが発生します。

HCSCサーバの起動時には,このプロパティに指定された数のインスタンスを生成してプールに設定します。0を指定すると,HCSCサーバの起動時にインスタンスはキャッシュされません。

usrconf.properties(J2EEサーバ用ユーザプロパティファイル)のcsc.dt.pool.DocumentBuilder.initialSizeプロパティが設定されている場合は,それと同じ値を設定してください。

xml-pooled-instance-maximum=XML処理に使用するクラスのインスタンスプールの最大数 〜<数字>((0−2147483647))<<64>>

要求電文・応答電文の処理に使用するクラスのインスタンスをキャッシュする最大数を指定します。

usrconf.properties(J2EEサーバ用ユーザプロパティファイル)のcsc.dt.pool.DocumentBuilder.maxSizeプロパティが設定されている場合は,それと同じ値を設定してください。csc.dt.pool.DocumentBuilder.maxSizeプロパティを設定していない場合は,HCSCサーバ内のすべてのリクエスト受付の,最大実行数の総和以上の値を指定してください。

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

設定した最大数を超えるリクエストが来た場合,リクエストの処理待ちが発生する場合があります。

(14)カスタム受付関連

request-id-separate-key={slash|atsign|period} 〜<<slash>>

FTP受付およびHTTP受付で生成するリクエストIDの分割キーを指定します。

fileevent-reception.monitored-file.enabled={true|false} 〜<<false>>

ファイル監視の可否を指定します。

fileevent-reception.monitored-folder=監視フォルダの絶対パス 〜<文字列(2バイト文字含む)および空白><<<サービスプラットフォームのインストールディレクトリ>\\CSC\\spool\\fileevent>>

監視フォルダのパスを絶対パスで指定します。ディレクトリ区切りは「/」または「\\」を使用します。共通フォルダと同じディレクトリは指定しないでください。

絶対パスで指定されていない場合や,存在しないディレクトリを設定した場合は,HCSCサーバの起動に失敗します。

取得対象ファイルを監視する場合はこのプロパティの指定は不要です。指定しても無効となります。

fileevent-reception.monitor-interval=ファイル監視の間隔 〜<数字>((1−44640))<<10>>

ファイル監視の間隔を分単位で指定します。

fileevent-reception.monitor-starting.delay=ファイル監視の開始待ち時間 〜<数字>((1−44640))<<10>>

HCSCサーバの起動の何分後にファイル監視を開始するかを指定します。

ファイル監視は,HCSCサーバの起動コマンドを実行した時点から,ここで指定した時間が経過したのちに開始されるようになります。

記述例

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

 
methodtrace-filepath=c:\\TMP
requesttrace-filepath=c:\\TMP
telegramtrace-filepath=c:\\TMP
methodtrace-filenum=8
requesttrace-filenum=4
telegramtrace-filenum=4
methodtrace-filesize=2097152
requesttrace-filesize=2097152
telegramtrace-filesize=2097152
telegramtrace-trigger=NORMAL
methodtrace-level=3
requesttrace=ON
telegramtrace=ON
bptrace-level=10
bptrace-filenum=16
bptrace-filesize=2097152
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
 

使用方法

cscsvconfigコマンドの-propfileオプションの引数にHCSCサーバランタイム定義ファイルを指定します。詳細については,マニュアル「サービスプラットフォーム システム構築・運用ガイド」の「3.1.4 HCSCサーバの定義情報を設定する」を参照してください。

注意事項

パスを指定する場合の注意事項を次に示します。