Cosminexus リファレンス 定義編

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

2.4 usrconf.propertiesJ2EEサーバ用ユーザプロパティファイル

<この節の構成>
(1) 形式
(2) ファイルの格納先
(3) 機能
(4) J2EEサーバの予約済みキー
(5) J2EEサーバのカスタマイズ用キー
(6) 記述例

(1) 形式

J2SEのプロパティファイル形式です。

次のようにキーを指定します。

 
<キー名称> = <値>
 

指定方法
  • 改行までが値になります。
  • #で始まる行はコメントとみなされます。
  • 値が存在しない行を定義した場合,その行は無視されます。
  • 値の後ろには,空白やコメントなどの文字列は追加できません。追加した場合,不正な値と解釈されます。
(例) <キー名称> = <値> #<コメント>
  • 記載する文字はJavaの仕様に従って,ISO 8859-1 文字エンコーディングを使用してください。

(2) ファイルの格納先

(3) 機能

J2EEサーバを実行するJavaVMのシステムプロパティを指定します。

usrconf.propertiesとusrconf.cfgのadd.jvm.argの-Dに同じキーが指定されている場合は,usrconf.propertiesの値が優先されます。

J2EEサーバの稼働中に,このファイルの内容を変更した場合,変更した内容は次にJ2EEサーバを起動したときに反映されます。

なお,日立のJavaVMは,J2SE 5.0に準拠しています。対応するSun Microsystems社製のJDKのバージョンはJDK 5.0です。JDK 5.0で使用できるプロパティについては,Sun Microsystems社が提供しているJDK 5.0のドキュメントを参照してください。

(4) J2EEサーバの予約済みキー

J2EEサーバでは,次に示す接頭子で始まるキーを内部的に利用します。このため,アプリケーションでこれらの接頭子で始まるキーを利用してはいけません。

(5) J2EEサーバのカスタマイズ用キー

J2EEサーバでは,次に示すシステムプロパティのキーに値を設定することで,J2EEサーバの動作をカスタマイズできます。なお,Webコンテナ機能のサーブレットエンジンモードを使用している場合のカスタマイズ用キーについては,「15.4 usrconf.properties(Webコンテナサーバ用ユーザプロパティファイル)」を参照してください。

ここでは,キーを次の分類に分けて説明します。

(a) ejbserver.applicationから始まるキー
キー名称 内容 デフォルト値
ejbserver.application.InitTermProcessClasses コンテナ拡張ライブラリを使用する場合に,サーバ起動・停止フックのクラス名を指定します。複数のクラスを指定する場合は,","で区切って指定してください。なお,","とクラス名の間には,空白を入れないでください。J2EEサーバ起動時には,指定した順で,サーバ起動・停止フック機能のサーバ起動フックメソッドが呼び出されます。J2EEサーバ終了時には,指定した逆順にサーバ起動・停止フック機能のサーバ停止フックメソッドが呼び出されます。 なし
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.appname AppNameのフィールドに出力するデフォルトのアプリケーション名を0〜16バイトの半角文字セットで指定します。プログラム上で,AppNameのフィールドの値が指定されていない場合,このプロパティの値がAppNameのフィールドに出力されます。
使用できる文字セットの定義を満たしているが,値の長さが制限を超えている場合,警告メッセージが出力されて,制限の長さより大きい部分のデータが切り捨てられ,制限の長さまでのデータが使用されます。
"null"という文字列が指定された場合は,空文字列""の指定として扱われ,appnameフィールドには何も表示されません。また,このプロパティからappnameに"null"という文字列の出力指定はできません。
user_app
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.count ログファイルの面数を次の範囲の整数で指定します。

CJMessageFileHandlerを使用した場合:
2〜16

CJMPMessageFileHandlerを使用した場合:
2〜64
ここで指定した面数まで増加し,指定した面数に到達すると,次の番号は初めの"1"に戻ります。
同名の旧ログファイル,または同名のユーザファイルがあった場合は上書きされます。
2
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.encoding 出力する文字列のエンコーディングを0〜1024バイトで指定します。省略した場合は,デフォルトのエンコーディングが使用されます。
指定された値が範囲を超えた場合,および"null"という文字列が指定された場合は,encodingの指定なし(encodingにはデフォルト値を使用する)と扱われます。nullという名称のエンコーダは使用できません。
JavaVM上でjava.nio.charset.Charset.isSupported(String charsetName)がtrueとなる文字セットで指定してください。エンコーディングに指定できる文字セットと指定する文字列については,Java標準APIのjava.nio.charset.Charsetなどの仕様に従ってください。次に指定値の例を示します。
  • US-ASCII:7ビットASCII(ISO646-US/Unicode charsetのBasic Latinブロック)
  • ISO-8859-1:ISO Latin Alphabet No. 1 (ISO-LATIN-1)
  • UTF-8:8ビットUCS変換形式
  • SJIS:Shift-JIS,日本語
  • EUC_JP:JIS X 0201,0208,0212,EUCエンコーディング,日本語
  • MS932:Windows 日本語(Windows用の指定値)
  • JIS0201:JIS X 0201,日本語
  • JIS0208:JIS X 0208,日本語
  • JIS0212:JIS X 0212,日本語
なお,性能劣化の原因となるため,不要なエンコーディング処理をしないでください。
null
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.filter 使用するフィルタを,パッケージ名を含むフルネームで指定します。値は0〜4096バイトのクラス文字セットで指定してください。
指定されたハンドラ名称のハンドラは,ここで指定されたフィルタをReflection機能で作成して利用します。
指定された値が範囲を超えた場合,フィルタの指定はなしとみなされます。また,"null"という文字列が指定された場合は,フィルタなし(フィルタは使わない)として扱われます。
"null"という名前のフィルタを作成しないでください。
null
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.formatter 使用するフォーマッタを,パッケージ名を含むフルネームで指定します。値は0〜4096バイトのクラス文字セットで指定してください。
指定できる値を次に示します。

CJMessageFileHandlerクラスに接続する場合:
com.hitachi.software.ejb.application.userlog.CJSimpleFormatterか,またはユーザ作成のFormatterクラスを指定します。
Java2-1.4標準のSimpleFormatterやXMLFormatterをCJMessageFileHandlerに指定しないでください(セパレータが改行であるため,メッセージレコードが1行で表示されません)。また,ユーザ作成のFormatterクラスを指定する場合は,改行などの制御コードを含まないメッセージを作成するフォーマッタを作成する必要があります。

Java2-1.4のHandlerクラスに接続する場合:
特に決まりはありません。
指定されたハンドラ名称のハンドラは,ここで指定されたフォーマッタをReflection機能で作成して利用します。
指定された値が範囲を超えた場合,フォーマッタの指定はなしとみなされます。また,"null"という文字列が指定された場合は,フォーマッタなし(フォーマッタは使わない)として扱われます。"null"という名前のフォーマッタを作成しないでください。
null
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.level ログの取得レベルの上限を半角英字で指定します。指定は,Javaの定数で定義されている値で指定します。大文字と小文字は区別されます。
ここで指定した値よりも低いレベルのメッセージだけがログへ出力されます。指定できるレベルを次に示します。
  • OFF:ロギングをオフにするために使われる特殊なレベル
  • SEVERE:重大な障害を示すメッセージレベル
  • WARNING:潜在的な問題を示すメッセージレベル
  • INFO:メッセージを情報として提供するメッセージレベル
  • CONFIG:静的な構成メッセージのメッセージレベル
  • FINE:トレース情報を提供するメッセージレベル
  • FINER:トレースレベル2(FINEより高い)
  • FINEST:トレースレベル3(FINERより高い)
  • ALL:すべてのメッセージのログを取得
OFFとALLは特殊なレベルです。例えば,ロガーとハンドラに対してOFFを指定すると,ログのレベルに関係なくログは一切取得されません。ALLを指定すると,すべてのレベルのログが出力されます。
SEVERE
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.limit ログファイルの容量(単位:バイト)を次の範囲の整数で指定します。

CJMessageFileHandlerを使用した場合:
8192〜2147483647

CJMPMessageFileHandlerを使用した場合:
8192〜16777216
ここで指定した容量まで増加し,指定した容量に到達すると次のログファイルに切り替わります。
日立トレース共通ライブラリの場合,容量チェックがメッセージの書き込み前であるため,実際の最大容量が設定値より,最大で約4200バイト超えることがあります(1バイトでも指定した容量に満たなければ,メッセージが書き込まれてしまうため)。
例えば,このキーに8192を指定した場合でout1.logの現在使用中の領域が8000バイト,空き容量が192バイトのときに4000バイトのメッセージが出力されると,メッセージはout1.logに出力されます。このため,out1.logは上限値を超えたサイズになります。
1048576
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.msgid MsgIDのフィールドに出力するデフォルトのメッセージIDを0〜21バイトの半角文字セットで指定します。プログラム上で,MsgIDの値が指定されていない場合,このプロパティの値がMsgIDのフィールドに出力されます。
使用できる文字セットの定義を満たしているが,値の長さが制限を超えている場合,警告メッセージが出力されて,制限の長さより大きい部分のデータが切り捨てられ,制限の長さまでのデータが使用されます。
"null"という文字列が指定された場合は,空文字列""の指定として扱われ,msgidフィールドには何も表示されません。また,このプロパティからmsgidに"null"という文字列の出力指定はできません。
0001
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.path ログファイル名のプリフィックスを1〜255バイトの範囲で指定します。パスは,相対パスで指定します※2。なお,パス名の終端に,半角数値を指定しないでください。
ここで指定したプリフィックスに"xx(1〜16の整数).log"が付加された値が,トレース情報ファイルの名称になります。
パスに指定された半角英文字の大文字と小文字は区別されません。また,パス値の長さは,次のA+B+C値の合計が値の範囲に収まるよう指定してください。
  • A(Windowsの場合):<ログ出力先ルート(ejb.server.log.directoryの値)>\user\(デフォルトは<Cosminexus作業ディレクトリ>\ejb\<J2EEサーバ名>\logs\user\)
  • A(UNIXの場合):<ログ出力先ルート(ejb.server.log.directoryの値)>/user/(デフォルトは<Cosminexus作業ディレクトリ>/ejb/<J2EEサーバ名>/logs/user/)
  • B:ユーザの指定したプリフィックスの長さ
  • C:"xx.log"の6文字
 
このほか,パスを指定するときには次の点に注意してください。
  • Propertiesファイルにはnativeの2バイトコードなどは使用できないため,native2asciiなどを利用してUnicodeの文字列を取得して指定してください。
  • 絶対パスで指定しないでください。また,相対パスの"..\"(UNIXの場合,"../")は使用しないでください。
  • パスに日本語文字などを含む場合は,その文字を処理できるロケール設定がされている環境下でJavaVMが動作している必要があります。
  • パスをほかのハンドラと同一に設定することはできません。そのような設定にした場合,そのハンドラは作成されません。
user_log
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.separator CJSimpleFormatterを利用して,1文でメッセージを出力するためのセパレータを0〜1024バイトの半角文字セットで指定します。セパレータは文字列で指定できます。
使用できる文字セットの定義を満たしているが,値の長さが制限を超えている場合,警告メッセージが出力されて,制限の長さより大きい部分のデータが切り捨てられ,制限の長さまでのデータが使用されます。
日立トレース共通ライブラリ形式の出力の場合,メッセージ内に次の制御文字を指定しないでください。
  • Windowsの場合:"\r","\n"など
  • UNIXの場合:"/r","/n"など
これらの文字を指定した場合,出力内容がずれたり,1レコードが1行で出力されなくなったりします。"null"という文字列が指定された場合は,空文字列""の指定として扱われます。そのため,セパレータに"null"という文字列は使用できません。また,このプロパティからセパレータに"null"という文字列の出力指定はできません。
|(ストローク)
ejbserver.application.userlog.loggers 使用するロガーの名称を宣言するプロパティです。0〜65535バイトで指定します。","で区切ることで,複数のロガー名称を指定できます。また,ロガー名称のすぐ後ろに,";"で区切ってそのロガーで使用する地域対応化用リソースバンドル名称を指定できます。
なお,ロガー名称には,java.netまたはjavax.swingのように"."で区切られ,サブシステムのパッケージ名またはクラス名に基づいた名前が推奨されています。※3また,ロガーの名称には","や";"を使用しないでください。
複数のクラス名を定義しており,指定された値の長さが範囲を超えた場合は,長さの範囲内に収まり,値の規則を満たしたクラス名だけが設定されます。
ここで宣言された名称のロガーは,CJLogManagerクラスのロガー構築対象として処理されます(J2EEサーバの起動時にロガーが構築されます)。
ここで指定しなかったロガーについては,自動生成されないため,コード上でロガーを作成してください。
なし
ejbserver.application.userlog.Logger.<ロガー名称>※3.filter ロガーで使用するフィルタを,パッケージ名を含むフルネームで指定するプロパティです。値は0〜4096バイトのクラス文字セットで指定してください。
指定されたロガー名称のロガーは,ここで指定されたフィルタをReflection機能で作成してメッセージの取捨選択に利用します。
指定された値が範囲を超えた場合,フィルタの指定はなしとみなされます。また,"null"という文字列が指定された場合は,フィルタなし(フィルタを使わない)として扱われます。"null"という名前のフィルタを作成しないでください。
null
ejbserver.application.userlog.Logger.<ロガー名称>※3.handlers 指定のロガー名称に対して,ハンドラクラスを接続(addHandler(Handler))するためのプロパティです。ハンドラクラスは,Reflection機能で作成するため,0〜65535バイトのパッケージ名を含むフルネームで指定してください。","で区切ることで複数のハンドラクラスを指定できます。
指定できるハンドラクラスを次に示します。
  • com.hitachi.software.ejb.application.userlog.CJMessageFileHandler
  • com.hitachi.software.ejb.application.userlog.CJMPMessageFileHandler
  • java.util.logging.ConsoleHandler
  • java.util.logging.FileHandler
  • java.util.logging.SocketHandler
  • java.util.logging.StreamHandler
  • java.util.logging.MemoryHandler
  • ユーザが独自に作成したHandlerクラスのパッケージ名を含むフルネーム
CJLogHandler系の場合は,ハンドラクラス名の後ろに";"で区切ってハンドラ名称を指定することで,指定のハンドラ名称の設定で初期化してハンドラクラスを作成し,ロガーに接続します。Java2-1.4標準のLoggingクラスについては,";"で区切ってハンドラ名称を指定しても無効になります。Java2-1.4標準のLoggingクラスの設定方法については,該当するクラスの仕様に従ってください。
ハンドラ名称は,半角英数字で始まる1〜1024バイトのクラス文字セットで指定してください。
複数のクラス名を定義しており,指定された値の長さが範囲を超えた場合は,長さの範囲内に収まり,値の規則を満たしたクラス名だけが設定されます。
ejbserver.application.userlog.loggersでロガー名称が指定されていない場合,ロガーは作成されません。
なし
ejbserver.application.userlog.Logger.<ロガー名称>※3.level ロガーのログ出力レベルまたは"null"を半角英字で指定します。大文字と小文字は区別されます。ログメッセージを出力するためには,ロガーのログ出力レベルと出力に利用するハンドラの出力レベルをクリアしている必要があります。指定できる値を次に示します。
  • ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.levelに指定できる値
  • "null"
"null"という名称が指定された場合,ロガーのレベルをnullで初期化します。ロガーのレベルが"null"で初期化された場合,そのロガーは親ロガーのレベルを継承します。
SEVERE
ejbserver.application.userlog.Logger.<ロガー名称>※3.useParentHandlers ログレコードを受け取ったロガーから,親ロガーの接続しているハンドラへログレコードを伝播させるかどうかを半角英字で指定します。伝播させる場合はtrueを,伝播させない場合はfalseを指定してください。
このロガーを通過したログの出力レベルは,親ロガーの接続しているハンドラのレベルにだけ影響されます(親ロガーのレベルがOFF,親ロガーが接続しているハンドラのレベルがALLの場合,すべてのメッセージは表示されます)。
true

ユーザログ機能についてのプロパティ定義(ejbserver.application.InitTermProcessClassesキー以外)で使用するそれぞれの文字セットで指定できる値は,次のとおりです。
  • クラス文字セット(クラス名の定義に使用する文字セット)
    半角英数字(a〜z,A〜Z,0〜9),ピリオド(.),ドル記号($)およびアンダースコア(_)
  • 半角文字セット
    半角英数字(a〜z,A〜Z,0〜9),ピリオド(.),ドル記号($),アンダースコア(_),ハイフン(-),ストローク(|),コロン(:),アンパサンド(&),単価記号(@),シャープ(#)およびパーセント(%)
指定した値が,使用できる文字セットの条件を満たさない,または指定できる値の範囲を満たさない不正な値の場合は,警告メッセージが出力され,その時点で有効なデフォルトの値が採用されます。その時点で有効なデフォルトの値とは,<ハンドラ名称>=defaultの場合のそのキーの値,または「デフォルト値」欄のデフォルト値を指します。

注※1
ハンドラ名称はプロパティの値を区別するために使用します。半角英数字で始まる1〜1024バイトのクラス文字セットで指定してください。"default"を指定した場合は,すべてのCJLogHandlerが共通のデフォルト値として認識するプロパティを示します。

注※2
出力先の起点は,次の規則に従ってください。
<ejb.server.log.directoryの値>\user,または<ejb.server.log.directoryの値>/user
ejb.server.log.directoryの値は,ejb.server.log.directoryの仕様に従ってください。J2EEサーバのejb.server.log.directoryのデフォルトの値を次に示します。
  • Windowsの場合
    <Cosminexus作業ディレクトリ>\ejb\<J2EEサーバ名>\user\<ユーザ指定値>
  • UNIXの場合
    <Cosminexus作業ディレクトリ>/ejb/<J2EEサーバ名>/user/<ユーザ指定値>

注※3
ロガー名称は,Logger.getLogger(<ロガー名称>)でロガーのインスタンスを取得するときに指定する"."付きの名称で,あらかじめ,ejbserver.application.userlog.loggersプロパティで宣言する必要があります。ロガー名称については,java.util.logging.Loggerの仕様に従ってください。
半角英数字で始まる1〜1024バイトのクラス文字セットで指定してください。"default"を指定した場合は,すべてのCJLogHandlerが共通のデフォルト値として認識するプロパティを示します。
なお,ロガー名称で識別されるプロパティは,ユーザログ機能のロガークラスの初期化で使用されます。
ロガー名称の最後を.handlersで終了させた場合,ejbserver.application.userlog.Logger.<ロガー名称>.handlersのプロパティ指定時に紛らわしくなるため,ロガー名称は".handlers"で終了させないことを推奨します。
(b) ejbserver.clientから始まるキー
キー名称 内容 デフォルト値
ejbserver.client.ctm.RequestPriority CTM内のキューに滞留したリクエストを引き出す時のプライオリティ(優先順位)を1〜8の整数で指定します。指定値が小さいほどプライオリティは高くなります。指定値が誤っている場合,または省略した場合は,4が設定されます。 4
(c) ejbserver.compilerから始まるキー
キー名称 内容 デフォルト値
ejbserver.compiler.jvm.maxHeapSize J2EEアプリケーション開始時に起動されるjavacコマンドのヒープサイズの最大値を指定します。
指定する値は,javaコマンドの-Xmx,-Xmsオプションが受け付ける形式で指定してください。それ以外の形式で指定された場合の動作は保証されません。
次のように指定してください。
  • 2048〜4294966272の値を指定してください。ただし,ejbserver.compiler.jvm.minHeapSizeに指定した以上の値にしてください。
  • キロバイト単位で指定する場合は,文字「k」または「K」を付けて指定してください。
  • メガバイト単位で指定する場合は,文字「m」または「M」を付けて指定してください。
256m
ejbserver.compiler.jvm.minHeapSize J2EEアプリケーション開始時に起動されるjavacコマンドのヒープサイズの初期値を指定します。
指定する値は,javaコマンドの-Xmx,-Xmsオプションが受け付ける形式で指定してください。それ以外の形式で指定された場合の動作は保証されません。
次のように指定してください。
  • 1024〜-Xmx指定値の値を指定してください。
  • キロバイト単位で指定するには,文字「k」または「K」を付けて指定してください。
  • メガバイト単位で指定するには,文字「m」または「M」を付けて指定してください。
32m
(d) ejbserver.connectionpoolから始まるキー
キー名称 内容 デフォルト値
ejbserver.connectionpool.applicationAuthentication.disabled コンテナ管理のサインオンの最適化機能を有効にするかどうかを指定します。

trueを指定した場合:
コンテナ管理のサインオンが最適化された動作となります。ただし,これを指定した場合,アプリケーション管理によるサインオンは使用できません。

falseを指定した場合:
コンテナ管理のサインオンは最適化されません。コンテナ管理によるサインオン,およびアプリケーション管理によるサインオンを使用できます。
なお,DB Connector以外のリソースアダプタを使用する場合には,このプロパティにtrueを指定することはできません。
false
ejbserver.connectionpool.association.enabled 1.4モードの場合に,コネクションアソシエーション機能を有効にするかどうかを指定します。

trueを指定した場合:
コネクションアソシエーション機能を有効にします。

falseを指定した場合:
コネクションアソシエーション機能を無効にします。
false
ejbserver.connectionpool.association.enabledDespiteUnshareableSetting サーブレットやEnterprise Beanの標準DDの<res-sharing-scope>にUnshareableを指定している場合に,コネクションアソシエーションを行うかどうかを指定します。

trueを指定した場合:
サーブレットやEnterprise Beanの標準DDの<res-sharing-scope>にUnshareableを指定している場合でも,コネクションアソシエーションを行います。ただし,ejbserver.connectionpool.association.enabled=trueが指定されている必要があります。

falseを指定した場合:
サーブレットやEnterprise Beanの標準DDの<res-sharing-scope>にUnshareableを指定している場合,コネクションアソシエーションを行いません。
Cosminexus 06-50より前のバージョンで動作実績のあるアプリケーションを,Cosminexus 06-50以降で動作させる場合,次のことに注意してください。
アプリケーションが,<res-sharing-scope>にUnshareableを指定している場合でも,コネクションアソシエーション機能が動作することを期待している場合(具体的には,ローカルトランザクション内でコネクションを2本以上取得する場合など)には,trueを指定する必要があります。
なお,アプリケーションを新規に開発する場合には,このキーは指定しないでください。
false
ejbserver.connectionpool.sharingOutsideTransactionScope.enabled 1.4モードの場合に,アプリケーションサーバが管理するトランザクションの外で複数回コネクションの取得を行ったときのコネクションシェアリングの動作を指定します。なお,リソースアダプタのトランザクションサポートレベルにNoTransactionを指定した場合は,コネクションシェアリングは行われません。

trueを指定した場合:
コネクションシェアリングを行います。なお,trueを指定した場合でも,サーブレットやEnterprise Beanの標準DDの<res-sharing-scope>にUnshareableを指定している場合には,コネクションシェアリングは行いません。

falseを指定した場合:
アプリケーションサーバが管理するトランザクションの外ではコネクションシェアリングを行いません。
false
(e) ejbserver.connectorから始まるキー
キー名称 内容 デフォルト値
ejbserver.connector.logwriter.filenum リソースアダプタ用ログファイルの面数を1〜16の整数で指定します。 4
ejbserver.connector.logwriter.filesize リソースアダプタ用ログファイルのサイズ(単位:バイト)を4096〜2147483647の整数で指定します。 2097152
(f) ejbserver.containerから始まるキー
キー名称 内容 デフォルト値
ejbserver.container.audit_trail.enabled データベース監査証跡連携機能を有効にするかどうかを指定します。

trueを指定した場合:
データベース監査証跡連携機能を有効にします。

falseを指定した場合:
データベース監査証跡連携機能を無効にします。
false
ejbserver.container.bmp.backcompatible Entity Bean(BMP)のロック制御の動作を指定します。

trueを指定した場合:
EJBコンテナでロックを制御します。

falseを指定した場合:
EJBコンテナでロックを制御しません。
なお,このプロパティの変更を有効にするには,開始中のJ2EEアプリケーションをいったん削除し,再作成または再インポートしてください。
false
ejbserver.container.ejbhome.sessionbean.reconnect.enabled EJBホームオブジェクトへの再接続機能を有効にするかどうかを指定します。

trueを指定した場合:
EJBホームオブジェクトへの再接続機能を有効にします。
trueを指定した場合は,必ずvbroker.se.iiop_tp.scm.iiop_tp.listener.portプロパティにポート番号を指定してください。

falseを指定した場合:
EJBホームオブジェクトへの再接続機能を無効にします。
false
ejbserver.container.passivate.scan.interval Enterprise Beanのタイムアウトやプールの状態を監視するスレッドの起動間隔を,0〜2147483の整数(単位:秒)で指定します。
0を指定した場合は監視しません。
0
ejbserver.container.rebindpolicy EJBメソッドの呼び出し時に通信障害が発生した場合の,EJBクライアント側でのコネクションの再接続動作とリクエストの再送動作を指定します。

VB_TRANSPARENT:
コネクションを再接続してリクエストを再送します。

NO_RECONNECT:
コネクションを再接続しないで,リクエストを再送しません。
この場合,通信障害によってコネクションが切断されると,再接続されないため,そのオブジェクトリファレンスは再利用できなくなります。
VB_TRANSPARENT
ejbserver.container.security.disabled Enterprise Beanのアクセス制御機能を有効にするかどうかを指定します。Enterprise Beanのアクセス制御機能の詳細についてはマニュアル「Cosminexus 機能解説」のEnterprise Beanへのアクセス制御に関する説明を参照してください。
このプロパティはserver.policy(J2EEサーバ用セキュリティポリシーファイル)で指定するセキュリティポリシーとは関係ありません。

trueを指定した場合:
Enterprise Beanのアクセス制御機能が無効になります。この場合,EJBレベルおよびアプリケーションレベルでのセキュリティ定義が無効となり,EJB実行時のメソッド実行権限のチェックが一切行われません。

falseを指定した場合:
Enterprise Beanのアクセス制御機能が有効になります。
false
ejbserver.container.remove.scan.interval 活性化状態のStateful Session Beanのタイムアウトを監視するスレッドの起動間隔を,0〜153722867280912の整数(単位:分)で指定します。
0を指定した場合または0未満を指定した場合,監視しません。
153722867280912より大きい値を指定した場合,153722867280912が設定されます。
数値以外を指定した場合,デフォルト値が設定されます。
5
(g) ejbserver.ctmから始まるキー
キー名称 内容 デフォルト値
ejbserver.ctm.ActivateTimeOut CTM機能を使用する場合に必要なプロパティです。CTM機能を使用するJ2EEアプリケーションのデプロイ時,J2EEサーバはスケジュールキューを活性化します。このときの待ち時間(単位:秒)を0〜2147483647で指定します。0を指定した場合,無限に待ち続け,省略した場合は,180(秒)が設定されます。 180
ejbserver.ctm.CTMDomain CTM機能を使用する場合に必要なプロパティです。J2EEサーバが属するCTMドメイン名称を1〜31文字の英数字またはアンダースコア(_)で指定します。"CTM"または"ctm"で始まるCTMドメイン名称は指定できません。省略した場合,"CTMDOMAIN"が設定されます。 CTMDOMAIN
ejbserver.ctm.CTMID CTM機能を使用する場合に必要なプロパティです。J2EEサーバを制御するCTMデーモンのCTM識別子を1〜31文字の英数字,アンダースコア(_)またはピリオド(.)で指定します。ただし,IPアドレスで識別子を指定する場合にだけピリオドが使用できます。
"CTM"または"ctm"で始まるCTM識別子は指定できません。またCTMドメイン名称と同じ名称を指定できません。省略した場合,IPアドレスが設定されます。
<IPアドレス>
ejbserver.ctm.CTMMyHost CTM機能を使用する場合に必要なプロパティです。マルチホームまたはIPアドレスを引き継ぐ系切り替え環境でCTMが使用するホスト名称またはIPアドレスを1〜64文字の文字列で指定します。
省略した場合は,hostnameコマンドで取得できるホスト名称が設定されます。
ejbserver.ctm.CTMIDプロパティを省略してこのプロパティを指定した場合,デフォルトのCTM識別子は,このプロパティで指定したIPアドレスになります。
<hostnameコマンドで取得されるホスト名称>
ejbserver.ctm.DeactivateTimeOut CTM機能を使用するJ2EEアプリケーションのアンデプロイ時,J2EEサーバはスケジュールキューを非活性化します。このときの待ち時間(実行中のリクエストの完了待ち)を0〜2147483647(単位:秒)で指定します。0を指定した場合,無限に待ち続け,省略した場合は,180(秒)が設定されます。
CTM経由で仕掛かり中のリクエストがある状態でアプリケーションを停止しようとした場合に,強制停止できなくなるため,0は指定しないでください。
180
ejbserver.ctm.enabled CTM機能の使用の有無を指定します。

trueを指定した場合:
CTM機能を使用します。CTMは,構成ソフトウェアにCosminexus Component Transaction Monitorを含む製品だけで利用できます。利用できる製品については,マニュアル「Cosminexus 概説」を参照してください。
J2EEサーバ起動時CTMとの接続の確立および初期化をします。これに成功するとCTM機能が使用できる状態でJ2EEサーバが起動します。
CTMとの接続および初期化に失敗した場合,J2EEサーバの起動に失敗します。

falseを指定した場合:
CTM機能を使用しません。
J2EEサーバ起動時に,CTMとの接続の確立および初期化をしないため,J2EEサーバはCTMを使用できる状態で起動しません。この状態でCTMを使用するアプリケーションのデプロイはできません。CTM機能が使用できない状態でもJ2EEサーバを起動したい場合は,falseを指定します。
true
ejbserver.ctm.QueueLength CTM機能を使用するJ2EEアプリケーションのデプロイ時,J2EEサーバはCTMキューを生成します。このときのCTMキューの長さを,1〜32767で指定します。省略した場合,CTMデーモンで保持しているCTMキューの生成時の長さ(-CTMMaxRequestCountオプションで指定した長さ)が有効となります。CTMキューを共有する場合,CTMキューはすでに作成されているため,指定された値ではなく作成済みの長さが有効となります。 なし
(h) ejbserver.deployから始まるキー
キー名称 内容 デフォルト値
ejbserver.deploy.app.stopforcibly.disabled J2EEアプリケーションの強制停止を無効にするかどうかを指定します。

trueを指定した場合:
J2EEアプリケーションの強制停止を無効にします。

falseを指定した場合:
J2EEアプリケーションの強制停止を有効にします。
false
ejbserver.deploy.applications.metadata_complete アノテーションを記述できるアプリケーションのうち,次のアプリケーションでアノテーション参照抑止機能を有効にするかどうかを指定します。
  • EJB 2.1
  • Servlet 2.4
 

trueを指定した場合:
アノテーションを参照しません。

falseを指定した場合:
アノテーションを参照します。
false
ejbserver.deploy.context.check_interval アプリケーション構成ファイルの更新を検知する間隔を,0〜2147483647の整数(単位:秒)で指定します。
0や1〜2147483647以外の数字を指定した場合は,自動リロードしません。コマンドリロードだけ受け付けます。
0
ejbserver.deploy.context.reload_scope J2EEアプリケーションに含まれるEJB-JAR,サーブレット,JSPの単位でリロード機能の適用範囲を指定します。
指定できる値を次に示します。

none:
リロード機能を使用しません。

app:
EJBアプリケーション,サーブレット,JSPでリロード機能を使用します。

web:
サーブレット,JSPでリロード機能を使用します。

jsp:
JSPでリロード機能を使用します。

上記以外:
デフォルト値が設定されます。
app
ejbserver.deploy.context.update.interval アプリケーション構成ファイルの更新を待つ時間を,0〜2147483647の整数(単位:秒)で指定します。
0や1〜2147483647以外の数字を指定した場合は,待ち時間なしとなります。
0
ejbserver.deploy.exclusive.lockAliveInterval サーバ処理終了後,コマンドから送信された次のレスポンスを受け取るまでの最大待ち時間を,1〜2147483647の整数(単位:秒)で指定します。
このプロパティの影響を受けるコマンドは,J2EEサーバで使用するコマンドのうち,更新,参照,特権に分類されているコマンドです。更新,参照,特権に分類されるコマンドは,J2EEサーバで使用するコマンドの一覧で確認できます。J2EEサーバで使用するコマンドの一覧については,マニュアル「Cosminexus リファレンス コマンド編」を参照してください。
不正な値を指定した場合は,警告メッセージを出力して,デフォルト値が設定されます。
指定した時間以上コマンド側からの通信がない場合,サーバはコマンドが不正終了したとみなし,コマンド排他を強制解除します。
待ち時間とは,コマンドがサーバ間を往復する時間とコマンドの処理時間の合計時間です。
60
ejbserver.deploy.resourcefile.scramble.enabled 作業ディレクトリ以下に展開されるDataSource,JavaMail,ResourceAdapterに関するDDファイルをスクランブルするかどうかを設定します。なお,このプロパティの値を切り替えてJ2EEサーバを起動してもすでにインポート・デプロイされているリソースのDDファイルは定義情報の更新を行わないかぎり状態は変化しません。

trueを指定した場合:
スクランブル化します。

falseを指定した場合:
スクランブル化しません。
false
ejbserver.deploy.session.work.directory Webアプリケーションのセッション情報ファイルを設定した<ejbserver.deploy.session.work.directoryプロパティ値>\web\<コンテキストルート名>配下ディレクトリに出力します。
  • Windowsの場合
    <Cosminexusインストールディレクトリ>\CC\server\repository\<サーバ名称>
  • UNIXの場合
    <Cosminexusインストールディレクトリ>/CC/server/repository<サーバ名称>
ejbserver.deploy.stub.generation.scope スタブなどの通信に必要なクラスを生成する対象範囲を指定します。新規インストール時はejb,アップグレードインストール時はappを指定します。

ejb:
EJB-JARのDDに指定されているホームインタフェース,コンポーネントインタフェースからスタブなどの通信に必要なクラスを生成します。

app:
EJB-JAR,WAR内のjava.rmi.Remoteを継承したクラスからスタブなどの通信に必要なクラスを生成します。

上記以外:
サーバを起動時にKDJE42257-Wのメッセージが出力され,デフォルト値が設定されます。
ejb
(i) ejbserver.distributedtxから始まるキー
キー名称 内容 デフォルト値
ejbserver.distributedtx.enableXidReuseOptimization 1.4モードの場合に,XIDを再利用する最適化を行うかどうかを指定します。

trueを指定した場合:
XIDを再利用して最適化します。
トランザクション内から同じリソースマネジャのコネクションを二つ以上使用しない場合には,trueを設定することでトランザクション管理パフォーマンスを向上できます。

falseを指定した場合,プロパティを指定しなかった場合または無効な値を指定した場合:
XIDを再利用しません。
false
ejbserver.distributedtx.ots.status.directory1 インプロセストランザクションサービスのステータスファイルおよび保守資料としてのステータスファイルのバックアップを格納するディレクトリを指定します。パス区切り文字は”/”を使用してください。相対パスを指定した場合は,次のディレクトリからのパスとなります。
  • Windowsの場合
    <Cosminexus作業ディレクトリ>\ejb\<サーバ名称>
  • UNIXの場合
    <Cosminexus作業ディレクトリ>/ejb/<サーバ名称>
otsstatus
ejbserver.distributedtx.ots.status.directory2 インプロセストランザクションサービスのステータスファイルを二重化する場合,予備ステータスファイルおよび保守資料としての予備ステータスファイルのバックアップを格納するディレクトリを指定します。パス区切り文字は”/”を使用してください。
相対パスを指定した場合,J2EEアプリケーションの実行ディレクトリからのパスとなります。
同一マシン内で稼働するほかのJ2EEサーバやJ2EEアプリケーションのプロセスと重ならないように,別のディレクトリを指定する必要があります。
このプロパティを指定しない場合,予備ステータスファイルは作成されないため,二重化されません。
なし
ejbserver.distributedtx.recovery.completionCheckOnStopping.timeout グローバルトランザクションを使用する場合に,J2EEサーバ停止時に行われるトランザクション仕掛かり完了確認のタイムアウトを,-1〜2147483647の数値(単位:秒)で指定します。ただし,次の場合はタイムアウトしません。
  • -1を指定した場合
  • 無効な文字列を指定した場合
  • このキーを指定しない場合
この場合,J2EEサーバまたはリソースマネジャが認識する未決着トランザクションが存在しないことが確認できるまで,J2EEサーバの停止は無限に保留されます。
0以上2147483647までの整数が指定された場合には,指定された時間(秒)が経過した時点でトランザクション仕掛かり完了確認をタイムアウトし,未決着トランザクションが存在しないことが確認できていなくても,J2EEサーバを停止します。
アプリケーションの運用時には,トランザクションのACIDを保証するために,タイムアウトしない設定にする必要があります。また,アプリケーションの開発時の,トランザクションのACIDよりも利便性を優先する場合には,タイムアウトする設定にできます。
-1(タイムアウトしません)
ejbserver.distributedtx.recovery.port 1.4モードの場合に,グローバルトランザクションを使用するとき,トランザクションリカバリで使用する固定ポート番号を1〜65535の整数で指定します。無効な値を指定した場合や,指定したポートがすでに使用されていた場合には,起動が中断されます。なお,ライトトランザクションを有効として起動した場合は,このプロパティは無視されます。 20302
ejbserver.distributedtx.rollbackClientTxOnSystemException システム例外が発生した場合に,呼び出したクライアントトランザクションをロールバックにマークするかどうかを指定します。

trueを指定した場合:
クライアントトランザクションをロールバックにマークします。

falseを指定した場合:
クライアントトランザクションをロールバックにマークしません。
プロパティが指定されていない場合や,無効な値を指定した場合は,falseが設定されます。
J2EEサーバが1.4モードで稼働時に,クライアントのトランザクションを開始してJ2EEサーバにあるリモートインタフェースを実装したEJBを,ローカル呼び出し最適化で呼び出し,呼ばれたEJBで新たなトランザクションを開始するかトランザクションを開始しない場合にだけ,このプロパティが有効になります。
false(1.4モードからの上書きインストールの場合はtrue)
ejbserver.distributedtx.XATransaction.enabled 1.4モードの場合に,グローバルトランザクションを使用するかどうかを指定します。

trueを指定した場合:
ライトトランザクション機能が無効となり,グローバルトランザクションを利用できます。

falseを指定した場合:
ライトトランザクション機能が有効となり,ローカルトランザクションに最適化された環境となります。ただし,グローバルトランザクションは利用できません。
false

注※
インプロセストランザクションサービスのステータスファイルには,J2EEサーバの識別情報としてホスト名またはIPアドレスを取り込んでいます。このため,ホスト名またはIPアドレスを変更する場合には,J2EEサーバの停止などの作業が必要です。ステータスファイルの格納ディレクトリに関するホスト名またはIPアドレスの変更は,J2EEサーバの動作設定のカスタマイズ時に実行します。J2EEサーバの動作設定のカスタマイズについては,マニュアル「Cosminexus システム構築ガイド」を参照してください。

(j) ejbserver.DynamicStubLoadingから始まるキー
キー名称 内容 デフォルト値
ejbserver.DynamicStubLoading.Enabled ダイナミッククラスローディングを使用するかどうかを指定します。

falseを指定した場合:
ダイナミッククラスローディングは機能しません。EJBオブジェクトのスタブ,EJBHomeオブジェクトのスタブ,またはビジネスインタフェースのリファレンスのスタブをダウンロードして,EJBクライアントのユーザクラスパスに指定してください。

trueを指定した場合:
ダイナミッククラスローディングが機能します。EJBオブジェクトのスタブ,EJBHomeオブジェクトのスタブ,またはビジネスインタフェースのリファレンスのスタブをEJBクライアントのユーザクラスパスに指定する必要はありません。
false
(k) ejbserver.ejbから始まるキー
キー名称 内容 デフォルト値
ejbserver.ejb.cmp20.cmr.use.existing_table デプロイ時に既存のCMR表を使用するオプションです。通常はデプロイ時にCMR表を生成するので既存のCMR表を使用する必要はありませんが,障害から回復する場合に一時的に指定します。

falseを指定した場合:
デプロイ時にすでにCMR表がある場合はエラーになります。

trueを指定した場合:
デプロイ時にすでにあるCMR表を使用します。
false
ejbserver.ejb.timerservice.maxCallbackThreads J2EEサーバ全体で,TimerServiceでのタイムアウトメソッドをコールバックする最大スレッド数を,1〜100の整数で指定します。 1
ejbserver.ejb.timerservice.retryCount TimerServiceでの,タイムアウトメソッドのコールバックをリトライする最大回数を,0〜2147483646の整数で指定します。 1
ejbserver.ejb.timerservice.retryInterval TimerServiceでの,タイムアウトメソッドのコールバックをリトライする間隔を,1〜604800の整数(単位:秒)で指定します。 5
(l) ejbserver.extから始まるキー
キー名称 内容 デフォルト値
ejbserver.ext.method_observation.interval このプロパティの設定には,次の二つの意味があります。
  • J2EEアプリケーション実行時間監視機能を使用するかどうかを指定します。
  • 動作中のリクエスト処理がタイムアウトしていないかを監視する時間間隔,タイムアウトしたリクエスト(メソッド)をキャンセルする時間間隔として,0〜86400の整数(単位:秒)を指定します。

0を指定した場合:
J2EEアプリケーション実行時間監視機能を使用しません。また,タイムアウトを監視しません

0以外の有効値を指定した場合:
J2EEアプリケーション実行時間監視機能を使用します。また,指定された時間間隔で,タイムアウトとメソッドキャンセルを異なるスレッドで実行します。

上記以外の無効な値を指定した場合:
デフォルト値が設定されます。
0
(m) ejbserver.httpから始まるキー
キー名称 内容 デフォルト値
ejbserver.http.port 簡易Webサーバのポート番号を1〜65535の整数で指定します。
すでにほかのアプリケーションで使用または確保されているポート番号は指定できません。また,複数のJ2EEサーバでWebサーバとの通信に使用するポートのポート番号に同じ値を設定しないでください。同一のポート番号を指定したJ2EEサーバはcjstartsvコマンドで複数起動できません。
8080
(n) ejbserver.instrumentationから始まるキー
キー名称 内容 デフォルト値
ejbserver.instrumentation.enabled Management Serverと連携するかどうかを指定します。

trueを指定した場合:
Management Serverと連携できます。

falseを指定した場合:
Management Serverと連携できません。
true
(o) ejbserver.jdbcから始まるキー
キー名称 内容 デフォルト値
ejbserver.jdbc.propertyInfo.BUF_SIZE 該当キーに値が指定されている場合,J2EEサーバがJDBCコネクションを取得するとき,BUF_SIZEキーに該当値を設定したプロパティを作成して,構成ソフトウェアであるCosminexus DABroker Libraryのjava.sql.Driver.connectの引数に渡します。
なお,このプロパティは,ベーシックモードでだけ指定できます。
なし
ejbserver.jdbc.propertyInfo.ENCODELANG 該当キーに値が指定されている場合,J2EEサーバがJDBCコネクションを取得するとき,ENCODELANGキーに該当値を設定したプロパティを作成して,構成ソフトウェアであるCosminexus DABroker Libraryのjava.sql.Driver.connectの引数に渡します。
なお,このプロパティは,ベーシックモードでだけ指定できます。
なし
(p) ejbserver.jndiから始まるキー
キー名称 内容 デフォルト値
ejbserver.jndi.cache ネーミングでのキャッシングをするかどうかを指定します。
キャッシングをする場合はonを,キャッシングをしない場合はoffを指定します。
on
ejbserver.jndi.cache.interval ネーミングでのキャッシングをする場合,キャッシュをクリアする間隔(単位:秒)を指定します。
ただし,1〜2147483647以外の値を指定した場合,クリアしません。
0
ejbserver.jndi.cache.interval.clear.option インターバル経過後のネーミングでのキャッシュ領域に対する動作を決定します。

refreshを指定した場合:
キャッシュの全領域をクリアします。

checkを指定した場合:
無効なキャッシュをクリアします。CTMを使用している場合,キャッシュされたグローバルCORBAネーミングサービスのEJBホームオブジェクトのオブジェクトリファレンスは,アプリケーションが停止していても無効なキャッシュとしてクリアされません。詳細については,マニュアル「Cosminexus 機能解説」を参照してください。
refresh
ejbserver.jndi.cache.reference DataSourceオブジェクトのキャッシング機能を使用するかどうかを指定します。

onを指定した場合:
DataSourceオブジェクトのキャッシング機能が有効になり,検索の要求に対して同じインスタンスが返ります。

offまたは無効な文字列を指定した場合:
通常通りに動作し,検索ごとに異なるインスタンスが返ります。
off
ejbserver.jndi.namingservice.group.list ラウンドロビン検索をする場合に,検索対象になる論理ネーミングサービスのグループを定義します。指定するグループ名は,英数字(A〜Z,a〜z,0〜9)またはアンダースコア(_)で構成される,ejbserver.jndi.namingservice.group.list内で一意に識別できる名前にします。

指定形式:
<Specify group name>[;<Specify group name>]*
なお,*は繰り返しを示します。
なし
ejbserver.jndi.namingservice.group.<Specify group name>.providerurls 各グループに属するネーミングサービスのルート位置をプロバイダURLで指定します。
<Specify group name>には,ejbserver.jndi.namingservice.group.list内に指定したグループ名を指定します。
プロバイダURLは,URLスキーマ"corbaname"を使用して記述します。

指定形式:
<プロバイダURL>[;<プロバイダURL>]*
なし
ejbserver.jndi.request.timeout ネーミングサービスとの通信タイムアウト時間(単位:秒)を0〜86400の整数で指定します。0を指定した場合,またはこのプロパティを指定しない場合,タイムアウトしません。また,86400を超える値を設定した場合,警告メッセージを出力して,タイムアウトしません。 0

(凡例)*:[]部分の繰り返しを示します。


(q) ejbserver.jtaから始まるキー
キー名称 内容 デフォルト値
ejbserver.jta.TransactionManager.defaultTimeOut J2EEサーバ上で開始されるトランザクションのトランザクションタイムアウトのデフォルト値(単位:秒)を次の範囲で指定します。

1.4モードの場合:
1〜2147483647

ベーシックモードの場合:
1〜2000000
180
ejbserver.jta.TransactionManager.enlist.compatibleMode.enabled J2EEサーバモードがベーシックモードの場合のトランザクション処理に関する仕様を指定します。

トランザクション中に,複数回データベースコネクションを取得した場合(コネクションシェアリング機能が有効になる条件を満たしているとき):
該当キーの値による動作の違いはありません。トランザクション中に2回目以降に取得したコネクションも,トランザクションに参加して動作します。

トランザクション中に,複数回DBコネクションを取得した場合(コネクションシェアリング機能が有効になる条件を満たしていないとき):
  • trueを指定したとき
    トランザクション中に2回目以降に取得したコネクションは,トランザクションに参加しないで動作します。
  • falseを指定したとき
    トランザクション中に2回目にコネクションを取得した場合に,java.sql.SQLExceptionが発生します。

複数回データベースコネクションを取得したあとで,トランザクションを開始した場合
  • trueを指定したとき
    トランザクション開始前に取得したコネクションは,トランザクションに参加しないで動作します。
  • falseを指定したとき
    トランザクション開始時に,javax.transaction.SystemExceptionが発生します。
true
(r) ejbserver.loggerから始まるキー
キー名称 内容 デフォルト値
ejbserver.logger.channels.define.<チャネル名>.filenum J2EEサーバのログファイルの面数を,1〜16の整数で指定します。
  • チャネル名がWebAccessLogFileの場合
    16
  • チャネル名がMaintenanceLogFileまたはWebServletLogFileの場合
    4
  • チャネル名が上記以外の場合
    2
ejbserver.logger.channels.define.<チャネル名>.filesize J2EEサーバのログファイルのサイズ(単位:バイト)を,4096〜2147483647の整数で指定します。
  • チャネル名がWebAccessLogFileの場合
    2097152
  • チャネル名がMaintenanceLogFileの場合
    16777216
  • チャネル名がWebServletLogFileの場合
    4194304
  • チャネル名が上記以外の場合
    1048576
ejbserver.logger.enabled.* J2EEサーバのログレベルを指定します。Error,Warning,Information,Debugのうち,一つまたは複数を指定します。一つだけ指定した場合は,該当するログレベルのログだけが出力されます。複数指定する場合は,レベル名の文字列の間をコンマ(,)で区切ります。通常はデフォルトのまま利用してください。 Error,Warning
ejbserver.logger.systemlog.enabled J2EEサーバの起動,停止および異常終了に関するメッセージを,イベントログ(UNIXの場合は,syslog)へログを出力するかどうかを指定します。

trueを指定した場合:
イベントログ(UNIXの場合は,syslog)へログを出力します。

falseを指定した場合:
イベントログ(UNIXの場合は,syslog)へログを出力しません。
True

注※
チャネル名称として次に示す名称を設定できます。

資料の取得については,マニュアル「Cosminexus システム運用ガイド」を参照してください。


(s) ejbserver.managementから始まるキー
キー名称 内容 デフォルト値
ejbserver.management.JVM.stats_monitor.FullGCCount.enabled フルガーベージコレクション回数の監視を有効にするかどうかを指定します。

true:
有効にします。

false:
無効にします。
true
ejbserver.management.JVM.stats_monitor.FullGCCount.threshold フルガーベージコレクション回数の監視でのしきい値となる回数を,1〜2147483647の整数で指定します。 10
ejbserver.management.JVM.stats_monitor.FullGCCount.interval フルガーベージコレクション回数の監視でのしきい値監視間隔を,1〜2147483647の整数(単位:秒)で指定します。 600
ejbserver.management.statistics.interval 稼働情報収集間隔を,1〜86400の整数(単位:秒)で指定します。 60
ejbserver.management.stats_file.base_time 稼働情報ファイルの時間切り替え運用での基点時刻を,ローカルタイムの1970年1月1日0時0分0秒からの増分として0〜1439の整数(単位:分)で指定します。
ローカルタイムの1970年1月1日h時m分を基点にする場合には,h×60+mを指定します。
0
ejbserver.management.stats_file.dir 稼働情報ファイルの出力先ディレクトリを指定します。出力先ディレクトリを変更する場合は,J2EEサーバごとに別々のディレクトリを指定してください。
  • Windowsの場合<Cosminexus作業ディレクトリ>\ejb\<サーバ名称>\stats
  • UNIXの場合<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/stats
ejbserver.management.stats_file.enabled 稼働情報ファイル出力機能を有効にするかどうかを指定します。

true:
有効にします。

false:
無効にします。
true
ejbserver.management.stats_file.num 稼働情報ファイルの面数を,2〜168の整数で指定します。 7
ejbserver.management.stats_file.period 稼働情報ファイルの時間切り替え運用での切り替え時間を,1〜744の整数(単位:時)で指定します。 24
(t) ejbserver.managerから始まるキー
キー名称 内容 デフォルト値
ejbserver.manager.agent.Agent.conf Management Serverとの連携に必要な設定をします。なお,この内容はManagement ServerがJ2EEサーバに自動で設定します。Management ServerがJ2EEサーバに自動で設定する内容については,マニュアル「Cosminexus 運用管理操作ガイド」を参照してください。 なし
ejbserver.manager.agent.Agent.enabled Management Serverとの連携に必要な設定をします。なお,この内容はManagement ServerがJ2EEサーバに自動で設定します。Management ServerがJ2EEサーバに自動で設定する内容については,マニュアル「Cosminexus 運用管理操作ガイド」を参照してください。 false
ejbserver.manager.agent.JP1EventAgent.conf JP1連携に関する設定ファイルのパスを指定します。 なし
ejbserver.manager.agent.JP1EventAgent.enabled JP1と連携するかどうかを指定します。 false
ejbserver.manager.agent.MEventAgent.conf Managementイベント発行用プロパティファイルを絶対パスで指定します。指定がない場合,または指定したファイルが存在しない場合はManagementイベントを発行しません。
Managementイベント発行用プロパティファイルの詳細は,「8.11 Managementイベント発行用プロパティファイル」を参照してください。
なし
ejbserver.manager.agent.MEventAgent.enabled Managementイベント発行機能を有効にするかどうかを指定します。

trueを指定した場合:
Managementイベント発行機能を有効にします。

falseを指定した場合:
Managementイベント発行機能を無効にします。
不正な値が指定された場合は,デフォルト値が設定されます。
false
ejbserver.manager.jp1event.event_server_name 使用するJP1/Baseのイベントサービスのイベントサーバ設定ファイル(conf)に指定した,portsパラメタのアドレスと同じ値を指定します。portsパラメタに複数のアドレスを指定している場合は,指定したアドレスのうちのどれか一つを指定します。なお,portsパラメタのアドレスに「0.0.0.0」(デフォルト値)を指定したイベントサービスを使用する場合は,このキーを省略するか,自マシンのホスト名またはlocalhostを指定します。 localhost
(u) ejbserver.namingから始まるキー
キー名称 内容 デフォルト値
ejbserver.naming.exec.args CORBAネーミングサービスを自動起動モード(ejbserver.naming.startupMode=automaticまたはinprocess)で使用する場合に,起動させるCORBAネーミングサービスに付加する実行時オプションを指定します。通常はこのプロパティに値を設定する必要はありません。CORBAネーミングサービス自動起動モード使用時にCORBAネーミングサービスで障害などが発生した場合に,その調査,対策および回避をするために使用します。
実行時オプションは,nameservのコマンドライン引数に指定する形式と同じ文字列を指定します(各プロパティの先頭に"-J"を付加して,スペース区切りで指定します。なお,実際は一行で指定します)。
(指定例)
 
ejbserver.naming.exec.args=-J-Dvbroker.se.iiop_tp.scm.iiop_tp.listener.port=900 
-J-Dvbroker.agent.enableLocator=false
 
ただし,inprocessモードでCORBAネーミングサービスを使用する場合は,次のプロパティを指定できません。
  • javax.rmi.CORBA.StubClass
  • javax.rmi.CORBA.UtilClass
  • javax.rmi.CORBA.PortableRemoteObjectClass
  • vbroker.serverManager.name
  • vbroker.orb.enableServerManager
  • vbroker.agent.enableLocator
  • vbroker.se.iiop_tp.host
このプロパティ値は,ejbserver.naming.portやvbroker.agent.enableLocatorプロパティで指定された値よりも優先されます。ただし,inprocessモードでCORBAネーミングサービスを起動する場合,ejbserver.naming.exec.argsで指定されたプロパティと同一のプロパティがシステムプロパティで設定されているときは,システムプロパティに設定されている情報が優先されます。
CORBAネーミングサービスの実行時に指定できるプロパティについては,マニュアル「Borland(R) Enterprise Server VisiBroker(R) デベロッパーズガイド」,およびマニュアル「Borland(R) Enterprise Server VisiBroker(R) プログラマーズリファレンス」を参照してください。
なし
ejbserver.naming.host J2EEサーバがネーミングサービスとして利用するCORBAネーミングサービスが起動しているホスト名称またはIPアドレスを指定します。
ネーミングの切り替え機能を使用する場合,ホスト名称として"localhost"は使用しないでください。CORBAネーミングサービスが起動しているホスト名称またはIPアドレスを指定してください。
CORBAネーミングサービスを自動起動モード(ejbserver.naming.startupMode=automaticまたはinprocess)で使用する場合,デフォルト値("localhost"),またはJ2EEサーバを起動させるホスト名称もしくはIPアドレスを指定してください。
localhost
ejbserver.naming.nameroot CORBAネーミングサービスを自動起動モード(ejbserver.naming.startupMode=automaticまたはinprocess)で使用する場合に,起動させるCORBAネーミングサービスに名称を付加するときに指定します。英数字(A〜Z,a〜z,0〜9)またはアンダースコア(_)で構成される文字列で指定します。この名称は,VisiBrokerのnsutilコマンドのパラメタなどに使用されます。
省略した場合,VisiBrokerで自動的に"NameService"という名称が設定されます。
なお,nsutilコマンドの使用方法,使用条件などについては,マニュアル「Borland(R) Enterprise Server VisiBroker(R) デベロッパーズガイド」を参照してください。
なし
ejbserver.naming.port J2EEサーバがネーミングサービスとして利用するCORBAネーミングサービスのポート番号を1〜65535の整数で指定します。ポート番号には,すでにほかのアプリケーションで使用されているポート番号は指定できません。ほかのアプリケーションで使用されているポート番号を指定してJ2EEサーバを起動した場合,起動処理が完了しないことがあります。 900
ejbserver.naming.protocol J2EEサーバがネーミングサービスとして利用するCORBAネーミングサービスへのアクセスプロトコルを指定します。現状,corbanameだけサポートしています。ただし,旧バージョンで使用されていたプロトコル(iioplocまたはiiopname)でも動作できます。 corbaname
ejbserver.naming.startupMode CORBAネーミングサービスの起動モードを指定します。

manualを指定した場合:
CORBAネーミングサービスを手動起動モードで使用する場合に指定します。
J2EEサーバを開始する前にCORBAネーミングサービスを手動で開始する必要があります。
J2EEサーバ開始時にejbserver.naming.host,ejbserver.naming.portで指定したCORBAネーミングサービスを手動で指定します。このプロパティ値が指定された場合には,J2EEサーバ起動処理からはCORBAネーミングサービスの自動起動をしません。

automaticを指定した場合:
CORBAネーミングサービスを自動起動モードで使用する場合に指定します。
J2EEサーバ開始時に自動で,CORBAネーミングサービスをアウトプロセスで開始します。
このモードでは,J2EEサーバ終了時に自動でCORBAネーミングサービスも停止します。ただし,J2EEサーバ開始時にejbserver.naming.portで指定したCORBAネーミングサービスが自ホスト上ですでに開始されている場合には自動開始処理をしないで,そのCORBAネーミングサービスを利用します。また,この場合,J2EEサーバ終了時のCORBAネーミングサービスの自動停止はしません。

inprocessを指定した場合:
CORBAネーミングサービスを自動起動モードで使用する場合に指定します。
J2EEサーバ開始時に自動で,CORBAネーミングサービスをインプロセスで開始するモードです。J2EEサーバ開始時にejbserver.naming.portで指定したCORBAネーミングサービスが自ホスト上ですでに開始されている場合には,エラーメッセージを出力してJ2EEサーバの起動処理が失敗します。

  • 06-00以降での新規インストールの場合:
    inprocess
  • バージョンアップの場合:
    既存の指定値が設定されます。省略していた場合は,manualが設定されます。
ejbserver.naming.startupRetryCount ejbserver.naming.startupWaitTimeで指定したCORBAネーミングサービスの起動待ち時間経過後,CORBAネーミングサービスがまだ起動していない場合に,ejbserver.naming.startupWaitTimeで指定された秒数だけ起動待ちを繰り返す回数を0〜2147483647の整数で指定します。
0が指定された場合はCORBAネーミングサービス起動状態チェック処理のリトライをしません。
なお,ejbserver.naming.startupWaitTimeに0が指定されている場合は,このプロパティ値は無効です。

  • 06-00以降での新規インストールの場合:
    9
  • バージョンアップの場合:
    0
ejbserver.naming.startupWaitTime J2EEサーバ起動時にCORBAネーミングサービスが利用可能になるまで待つ時間(単位:秒)を0〜2147483647の整数で指定します。0を指定した場合は,CORBAネーミングサービスの起動待ちをしません。
  • 06-00以降での新規インストールの場合:1
  • バージョンアップの場合:manualモードで使用していた場合には0が設定されます。
    automaticモードを使用し,このプロパティ値を設定していた場合は,既存の指定値がデフォルト値となります。省略していた場合10となります。

注※
Management Serverを利用してJ2EEサーバを起動する場合,automatic以外を指定してください。automaticを指定した場合,CORBA Naming ServiceプロセスがTPBroker運用支援機能のプロセス監視対象外となり,プロセスがダウンしても再起動されなくなります。

(v) ejbserver.rmiから始まるキー
キー名称 内容 デフォルト値
ejbserver.rmi.localinvocation.scope ローカル呼び出し最適化機能の適用範囲を指定します。

noneを指定した場合:
適用範囲はありません。バージョンアップインストール時は互換性のため,これが指定されます。

appを指定した場合:
同一アプリケーション内が適用範囲になります。

allを指定した場合:
同一J2EEサーバ内が適用範囲になります。
app
ejbserver.rmi.naming.host マルチホームドホスト環境で,J2EEサーバがサービスプロバイダとして使用するRMIレジストリのホスト名称,またはIPアドレスを指定します。指定した半角英文字の大文字,小文字の区別はしません。 なし
ejbserver.rmi.naming.port J2EEサーバが利用するRMIレジストリのポート番号を,1〜65535の整数で指定します。ポート番号には,すでにほかのアプリケーションで使用されているポート番号は指定できません。ほかのアプリケーションで使用されているポート番号を指定してJ2EEサーバを起動した場合,起動処理が完了しないことがあります。 23152
ejbserver.rmi.passbyreference trueを指定した場合,リモートインタフェースを持つEJBのメソッド呼び出しで,引数および戻り値を値渡し(pass by value)ではなく参照渡し(pass by reference)にします。ただし,ejbserver.rmi.localinvocation.scopeで設定された範囲を超えた呼び出しをした場合,参照渡しの機能は無効になります。
参照渡しでは,値をコピーして生成するコストを削減できますが,渡された参照を用いて元の値を変更できるため注意が必要です。
false
ejbserver.rmi.remote.listener.port 任意の値を指定して,JMXクライアント(運用管理エージェント,JP1/Performance Management - Agent Option for uCosminexus Application Serverなど)による稼働情報取得時のリクエスト受付ポートを固定できます。0〜65535の整数を指定します。
ポート番号には,すでにほかのアプリケーションで使用されているポート番号は指定できません。ほかのアプリケーションで使用されているポート番号を指定してJ2EEサーバを起動した場合,起動処理が完了しないことがあります。
このプロパティを設定しない場合,または値に0を指定した場合,ランダムな値が設定されます。
0
ejbserver.rmi.request.timeout クライアントとサーバ間の通信タイムアウト時間(単位:秒)を0〜86400の整数で指定します。
0を指定した場合,またはこのプロパティを指定しない場合,タイムアウトしません。なお,86400を超える値を設定した場合,警告メッセージを出力して,タイムアウトしません。
0(秒)
ejbserver.rmi.stateless.unique_id.enabled Stateless Session Beanのremoveメソッドの呼び出しに対して,呼び出しを不要とするか,必要とするかを指定します。

trueを指定した場合:
Stateless Session BeanのEJBObjectに対してremoveメソッドの呼び出しを不要とします。
removeメソッドの呼び出し後にビジネスメソッドを呼び出した場合には,java.rmi.NoSuchObjectException例外は発生しないで,ビジネスメソッドが実行されます。

falseを指定した場合:
Stateless Session BeanのEJBObjectに対してremoveメソッドの呼び出しを必要とします。
removeメソッドの呼び出し後にビジネスメソッドを呼び出した場合には,java.rmi.NoSuchObjectException例外が発生します。
false

注※
サーバ管理コマンドからEJB単位での参照渡し(Pass-by-reference)の設定をすることもできます。

(w) ejbserver.serverから始まるキー
キー名称 内容 デフォルト値
ejbserver.server.j2ee.feature Component Containerの動作モードを指定します。
  • 1.3basic
    ベーシックモード(単一DBだけのリソースをトランザクションで使用するシステムに適用)
  • 1.4
    J2EE1.4の先進機能が付加されたモード(DBを含む各種リソースをトランザクションで使用するシステムに適用)
    J2EE1.4の先進機能が付加されたモードを使用するには,トランザクション管理サーバなどが必要なため,ベーシックモードに比べ,多量のCPU/メモリリソースが必要です。
1.4
ejbserver.server.mutex.invocation.timeout 同時に同一プライマリキーのEntity Beanにアクセスした場合に掛かる排他のタイムアウト時間(単位:秒)を,45〜92233720368547758の整数で指定します。タイムアウト時間は,デフォルト値(45秒)以上java.lang.Long.MAX_VALUE/1000(秒)以下の範囲で指定してください。デフォルト値未満の値を指定した場合,タイムアウト時間は45(秒)で動作します。
java.lang.Long.MAX_VALUE/1000(秒)を超える値を指定した場合,タイムアウト時間はjava.lang.Long.MAX_VALUE(ミリ秒)で動作します。さらに,java.lang.Long.MAX_VALUEを超える値を指定した場合は,デフォルト値になります。
45
ejbserver.server.prf.PRFID PRF識別子を指定します。
PRFデーモン起動時にPRF識別子を指定した場合に,同じPRF識別子を指定します。
PRFデーモン起動時にPRF識別子を省略した場合は,指定しないでください。PRF識別子が一致しないと,性能解析トレースが取得されません。
なし
ejbserver.server.threaddump.filenum J2EEサーバが障害を検知して自発的にスレッドダンプを出力する場合のスレッドダンプのファイル数の上限を,1〜2147483647の整数で指定します。
範囲外の値を指定した場合は,デフォルト値が設定されます。
また,次に示す外部からのスレッドダンプ出力要求に対しては,このオプションの設定に関係なくスレッドダンプのファイルが出力されます。
  • cjdumpsvコマンド
  • cjstopsvコマンドの-fd指定
  • J2EEサーバ実行コンソールでのCtrl+Break(Windowsの場合)
  • J2EEサーバプロセスへのkillコマンド -3(SIGTERM)指定(UNIXの場合)
256
(x) ejbserver.statefulから始まるキー
キー名称 内容 デフォルト値
ejbserver.stateful.passivate.switch Stateful Session Beanの非活性化,活性化の機能を使用するかどうかを指定します。

trueを指定した場合:
Stateful Session Beanの非活性化,活性化の機能が動作します。

falseを指定した場合:
Stateful Session Beanの非活性化,活性化の機能が動作しません。
false
(y) ejbserver.watchから始まるキー
キー名称 内容 デフォルト値
ejbserver.watch.enabled すべてのリソース枯渇監視を有効にするかどうかを指定します。

trueを指定した場合:
すべてのリソース枯渇監視を有効にします。

falseを指定した場合:
すべてのリソース枯渇監視を無効にします。この場合,各リソース枯渇監視が有効に設定されていても,すべてのリソース枯渇監視が無効になります。
true(06-00以前からのバージョンアップの場合は,false)
ejbserver.watch.memory.enabled メモリ監視のアラート出力を有効にするかどうかを指定します。

trueを指定した場合:
メモリ監視のアラート出力を有効にします。

falseを指定した場合:
メモリ監視のアラート出力を無効にします。
trueを指定する場合,次のJavaVMオプションを同じ値で設定することをお勧めします。
  • -XX:PermSize
  • -XX:MaxPermSize
異なる値を設定した場合,Permanent領域の領域拡張でもアラートが出力される場合があります。
true
ejbserver.watch.memory.interval メモリ監視間隔を1〜2147483647の整数(単位:秒)で指定します。 60
ejbserver.watch.memory.threshold メモリの使用状態を監視するしきい値を,1〜100の整数(単位:%)で指定します。次の条件のどれかで,フルガーベージコレクションの予兆を検知した場合に,アラートを出力します。
  • Tenured領域消費サイズのTenured領域合計サイズに対する割合(リソース枯渇監視情報のRate1に出力される値)がしきい値以上
  • New領域合計サイズのTenured領域最大空きサイズに対する割合(リソース枯渇監視情報のRate2に出力される値)がしきい値以上
  • Permanent領域消費サイズのPermanent領域合計サイズ(リソース枯渇監視情報のRate3に出力される値)に対する割合がしきい値以上
80
ejbserver.watch.memory.writefile.enabled メモリ監視結果をファイル出力するかどうかを指定します。

trueを指定した場合:
メモリ監視結果をファイル出力します。

falseを指定した場合:
メモリ監視結果をファイル出力しません。
true
ejbserver.watch.fileDescriptor.enabled ファイルディスクリプタ監視のアラート出力を有効にするかどうかを指定します。

trueを指定した場合:
ファイルディスクリプタ監視のアラート出力を有効にします。

falseを指定した場合:
ファイルディスクリプタ監視のアラート出力を無効にします。
true
ejbserver.watch.fileDescriptor.interval ファイルディスクリプタ監視間隔を1〜2147483647の整数(単位:秒)で指定します。 60
ejbserver.watch.fileDescriptor.threshold ファイルディスクリプタの使用状態を監視するしきい値を,1〜2147483647の整数で指定します。使用中のファイルディスクリプタ数がしきい値以上になった場合にアラートを出力します。指定するしきい値は次のように設定してください。
OSのプロセスに割り当て可能なファイルディスクリプタ数>ファイルディスクリプタ見積もり式から求めた値>ファイルディスクリプタしきい値
注※
プラットフォームによってシステムの上限が存在しない場合があります。
2147483647
ejbserver.watch.fileDescriptor.writefile.enabled ファイルディスクリプタ監視結果をファイル出力するかどうかを指定します。

trueを指定した場合:
ファイルディスクリプタ監視結果をファイル出力します。

falseを指定した場合:
ファイルディスクリプタ監視結果をファイル出力しません。
true
ejbserver.watch.thread.enabled スレッド監視のアラート出力を有効にするかどうかを指定します。

trueを指定した場合:
スレッド監視のアラート出力を有効にします。

falseを指定した場合:
スレッド監視のアラート出力を無効にします。
true
ejbserver.watch.thread.interval スレッド監視間隔を,1〜2147483647の整数(単位:秒)で指定します。 60
ejbserver.watch.thread.threshold スレッドの使用状態を監視するしきい値を,1〜2147483647の整数で指定します。生成済みのスレッド数がしきい値以上になった場合にアラートを出力します。指定するしきい値は次のように設定してください。
OSのプロセスに割り当て可能なスレッド数>スレッド見積もり式より求めた値>スレッドしきい値
注※
プラットフォームによってシステムの上限が存在しない場合があります。
2147483647
ejbserver.watch.thread.writefile.enabled スレッド監視結果をファイル出力するかどうかを指定します。

trueを指定した場合:
スレッド監視結果をファイル出力します。

falseを指定した場合:
スレッド監視結果をファイル出力しません。
true
ejbserver.watch.threaddump.enabled スレッドダンプ監視のアラート出力を有効にするかどうかを指定します。

trueを指定した場合:
スレッドダンプ監視のアラート出力を有効にします。

falseを指定した場合:
スレッドダンプ監視のアラート出力を無効にします。
true
ejbserver.watch.threaddump.interval スレッドダンプ監視時間間隔を,1〜2147483647の整数(単位:秒)で指定します。 30
ejbserver.watch.threaddump.threshold スレッドダンプ監視のしきい値を,最大値に対する割合1〜100の整数(単位:%)で指定します。スレッドダンプのファイル数の最大値に対する現在値の割合がしきい値以上になった場合にアラートを出力します。 80
ejbserver.watch.threaddump.writefile.enabled スレッドダンプ監視結果をファイル出力するかどうかを指定します。

trueを指定した場合:
スレッドダンプ監視結果をファイル出力します。

falseを指定した場合:
スレッドダンプ監視結果をファイル出力しません。
true
ejbserver.watch.defaultRequestQueue.enabled HTTPリクエスト実行待ちキュー監視のアラート出力を有効にするかどうかを指定します。

trueを指定した場合:
HTTPリクエスト実行待ちキュー監視のアラート出力を有効にします。

falseを指定した場合:
HTTPリクエスト実行待ちキュー監視のアラート出力を無効にします。
true
ejbserver.watch.defaultRequestQueue.interval HTTPリクエスト実行待ちキュー監視間隔を,1〜2147483647の整数(単位:秒)で指定します。 30
ejbserver.watch.defaultRequestQueue.threshold アラートメッセージを出力するしきい値を,1〜100の整数(単位:%)で指定します。監視対象のリクエストの実行待ちキューの格納率が,このキーで指定された値以上になるとアラートメッセージを出力します。 80
ejbserver.watch.defaultRequestQueue.writefile.enabled HTTPリクエスト実行待ちキュー監視結果をファイル出力するかどうかを指定します。

trueを指定した場合:
HTTPリクエスト実行待ちキュー監視結果をファイル出力します。

falseを指定した場合:
HTTPリクエスト実行待ちキュー監視結果をファイル出力しません。
true
(z) ejbserver.webj2eeから始まるキー
キー名称 内容 デフォルト値
ejbserver.webj2ee.connectionAutoClose.enabled J2EEサーバの動作モードが1.4モードの場合に,自動クローズ機能を使用するかどうかを指定します。動作モードがベーシックモードの場合,このプロパティは無視され,自動クローズ機能は無効となります。

trueを指定した場合:
自動クローズ機能を有効にします。

falseを指定した場合:
自動クローズ機能を無効にします。
不正な値を指定した場合は,デフォルト値が設定されます。
true
(aa) javaから始まるキー
キー名称 内容 デフォルト値
java.naming.factory.initial JNDIのInitialContextがデレゲートするコンテキストの実装クラスのファクトリクラスを指定します。各設定値での動作を次に示します。

com.hitachi.software.ejb.jndi.InsContextFactory :
JNDIラウンドロビン検索機能を使用しないで,通常の検索機能を使用する場合に指定するコンテキストです。

com.hitachi.software.ejb.jndi.GroupContextFactory :
J2EEサーバ内アプリケーション(EJB)の実行時に,JNDIラウンドロビン検索機能を使用する場合に指定するコンテキストです。
com.hitachi.software.ejb.jndi.InsContextFactory
(ab) vbjから始まるキー
キー名称 内容 デフォルト値
vbj.java2iiop.jvm.maxHeapSize J2EEアプリケーション開始時に起動されるjava2iiopコマンドのヒープサイズの最大値を指定します。
指定する値は,javaコマンドの-Xmx,-Xmsオプションが受け付ける形式で指定してください。それ以外の形式で指定された場合の動作は保証されません。
次のように指定してください。
  • 2048〜4294966272の値を指定してください。ただし,vbj.java2iiop.jvm.minHeapSizeに指定した以上の値を指定してください。
  • キロバイト単位で指定する場合は,文字「k」または「K」を付けて指定してください。
  • メガバイト単位で指定する場合は,文字「m」または「M」を付けて指定してください。
128m
vbj.java2iiop.jvm.minHeapSize J2EEアプリケーション開始時に起動されるjava2iiopコマンドのヒープサイズの初期値を指定します。
指定する値は,javaコマンドの-Xmx,-Xmsオプションが受け付ける形式で指定してください。それ以外の形式で指定された場合の動作は保証されません。
次のように指定してください。
  • 1024〜-Xmx指定値の値を指定してください。
  • キロバイト単位で指定する場合は文字「k」または「K」を付けて指定してください。
  • メガバイト単位で指定する場合は,文字「m」または「M」を付けて指定してください。
16m
(ac) vbrokerから始まるキー
キー名称 内容 デフォルト値
vbroker.agent.enableLocator スマートエージェントを使用するかどうかを指定します。
通常は設定不要のプロパティです。デフォルトのままご使用ください。
また,CTM連携機能を有効(ejbserver.ctm.enabledキーにtrueを指定)にした場合は,J2EEサーバの起動時に自動的にtrueが設定されます。
この目的以外でスマートエージェントが必要な場合は,trueを設定してください。
なお,このプロパティにtrueを指定した場合は,スマートエージェントを先に起動する必要があります。
スマートエージェントの詳細については,マニュアル「Borland(R) Enterprise Server VisiBroker(R) プログラマーズリファレンス」を参照してください。
false
vbroker.agent.port スマートエージェントのポート番号を指定します。詳細については,マニュアル「Borland(R) Enterprise Server VisiBroker(R) プログラマーズリファレンス」を参照してください。 14000
vbroker.orb.htc.comt.entryCount Cosminexus TPBroker通信トレースファイル1個当たりのエントリ数の上限値を100〜30000000の範囲で指定します。 120000
vbroker.orb.htc.comt.fileCount Cosminexus TPBroker通信トレースファイルの個数の上限値を1〜256の範囲で指定します。 3
vbroker.orb.htc.tracePath Cosminexus TPBrokerのトレースファイル出力先のパスを1〜210バイトの範囲で指定します。指定したパスのサブディレクトリとしてcomtrcとmdltrcをあらかじめ作成しておく必要があります。デフォルトの出力先の場合,サブディレクトリcomtrcとmdltrcはサーバ初回起動時に自動作成されます。ディレクトリのパスの区切り記号には,"/"を使用してください。
例えば,Windowsの場合,workディレクトリとしてC:\temp\workを設定するときは,次のように指定します。
(指定例)
vbroker.orb.htc.tracePath=c:/temp/work

  • Windowsの場合
    <Cosminexus作業ディレクトリ>\ejb\<サーバ名称>\logs\TPB\logj
  • UNIXの場合
    <Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/logs/TPB/logj
vbroker.se.iiop_tp.host 任意の値を指定して,J2EEサーバ単位でEJBコンテナのIPアドレスを固定します。 なし
vbroker.se.iiop_tp.scm.iiop_tp.listener.port 任意の値を指定して,J2EEサーバ単位で通信ポートを固定できます。ポート番号は,ほかのプログラムなどと重複しないようにしてください。
このプロパティを設定しない場合は,Cosminexus TPBrokerによってランダムな値が設定されます。
また,ejbserver.container.ejbhome.sessionbean.reconnect.enabledにtrueを指定した場合は,必ず値を指定して,ポート番号を固定にしてください。
0
(ad) webserver.connectorから始まるキー
キー名称 内容 デフォルト値
webserver.connector.ajp12.backlog 旧バージョンとの互換性を保つためのキーです。
webserver.connector.ajp13.backlogとして使用されます。指定できる値については,webserver.connector.ajp13.backlogキーの説明を参照してください。
このキーとwebserver.connector.ajp13.backlogの両方が指定されていた場合,このキーの値が使用されます。
なし
webserver.connector.ajp12.max_threads 旧バージョンとの互換性を保つためのキーです。
webserver.connector.ajp13.max_threadsとして使用されます。指定できる値については,webserver.connector.ajp13.max_threadsキーの説明を参照してください。
このキーとwebserver.connector.ajp13.max_threadsの両方が指定されていた場合,このキーの値が使用されます。
1025以上の値が設定されていた場合,webserver.connector.ajp13.max_threadsのデフォルト値の100が使用されます。
なし
webserver.connector.ajp12.port 旧バージョンとの互換性を保つためのキーです。
webserver.connector.ajp13.portとして使用されます。指定できる値については,webserver.connector.ajp13.portキーの説明を参照してください。
このキーとwebserver.connector.ajp13.portの両方が指定されていた場合,このキーの値が使用されます。
なし
webserver.connector.ajp13.backlog リダイレクタからの接続要求の最大の待ち行列数を指定します。1〜2147483647の整数で指定します。
有効な最大値は実行するプラットフォームで指定できるSocketのListenキューの最大値となります。実際のListenキューの最大値はOSによって異なるため,詳細は各OSのlisten関数についてのマニュアルを参照してください。
このキーに指定した値は,java.net.ServerSocketクラスのコンストラクタのbacklog引数に設定されます。ただし,この指定値がOSの制限値を超えた場合は,OSの制限値が設定されたものと解釈され,エラーにはなりません。制限値はOSによって異なります。制限値を拡張する方法については,OSのマニュアルを参照してください。
100
webserver.connector.ajp13.bind_host Webサーバ連携で使用するIPアドレスまたはホスト名称を指定します。
IPアドレス,またはホスト名称の前後の半角スペースは無視されます。値を指定しない場合は,ワイルドカードアドレスが使用されます。
このプロパティを指定するときは,ワーカホスト名称にもローカルホスト名称またはIPアドレスを指定する必要があります。
同一ホストで実行しているWebサーバとWebサーバ連携をしている構成の場合に,このプロパティにローカルホスト名称,またはIPアドレスを指定し,リダイレクタのワーカホスト名称にlocalhostなどのループバックアドレスを指定したとき,WebコンテナはWebサーバからのリクエストを受信できません。
なし
webserver.connector.ajp13.max_threads Webコンテナがリクエストを処理する同時実行数を指定します。※1
1〜1024の整数で指定します。
指定されたリクエストの同時実行数分のスレッドがサーバ起動時に生成されます。
10
webserver.connector.ajp13.port Webサーバとの通信に使用するポート番号を指定します。
1〜65535の整数で指定します。
すでにほかのアプリケーションで使用または確保されているポート番号は指定できません。また,複数のJ2EEサーバでWebサーバとの通信に使用するポートのポート番号に同じ値を設定しないでください。同一のポート番号を指定したJ2EEサーバはcjstartsvコマンドで複数起動できません。
8007
webserver.connector.ajp13.receive_timeout リクエスト受信処理のリダイレクタへのデータ要求処理で,リダイレクタからの応答を待つ時間(通信タイムアウト値)を0〜3600の整数(単位:秒)で指定します。
0を指定した場合は,リダイレクタからの応答を受け取るまで待ち続け,タイムアウトは発生しません。
600(秒)
webserver.connector.ajp13.send_timeout レスポンス送信処理のタイムアウト値を0〜3600の整数(単位:秒)で指定します。
数値以外の文字列や範囲外の数値を指定した場合は,メッセージを出力し,デフォルト値を使用します。
タイムアウト値に0,またはTCPの持つデータ送信の再送タイマより長い時間を設定した場合,タイムアウト値はTCPの持つタイムアウト値になります。その場合,不正なタイムアウト値が指定されたことを示すメッセージは出力されません。
600
webserver.connector.http.bind_host 簡易Webサーバで使用するローカルIPアドレス,または解決できるローカルホスト名称を指定します。
IPアドレスまたはホスト名称の前後の半角スペースは無視されます。値を指定しない場合は,ワイルドカードアドレスが使用されます。
なし
webserver.connector.http.permitted.hosts 簡易Webサーバへのアクセスを許可するホストのIPアドレス(10進表記)またはホスト名を指定します。
なお,ローカルホストは明記しなくても常にアクセスできます。したがって,このキーの指定を省略した場合,アクセスできるのはローカルホストだけになります。
複数指定する場合にはIPアドレスまたはホスト名の間をコンマ(,)で区切ります。アクセス制限をしない場合はアスタリスク(*)だけを指定します。IPアドレスまたはホスト名の前後の半角スペースは無視されます。
なし
webserver.connector.inprocess_http.backlog Webクライアントからの接続要求を格納するTCPリスンキューの長さを1〜2147483647の整数で指定します。
有効な指定値の最大値や実際に設定されるTCPリスンキューの長さはOSによって異なります。
数値以外の文字列,範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
511
webserver.connector.inprocess_http.bind_host インプロセスHTTPサーバで使用するIPアドレスまたはホスト名を指定します。
IPアドレスまたはホスト名の前後の半角スペースは無視されます。値を指定しない場合は,ワイルドカードアドレスが使用されます。
指定されたホスト名またはIPアドレスが解決できない場合,ローカルではないホストのホスト名またはIPアドレスを指定した場合はメッセージが出力され,ワイルドカードアドレスが使用されます。
なし
webserver.connector.inprocess_http.enabled インプロセスHTTPサーバ機能を有効にするかどうかを指定します。

trueを指定した場合:
インプロセスHTTPサーバ機能を有効にします。

falseを指定した場合:
インプロセスHTTPサーバ機能を無効にします。
trueまたはfalse以外の文字列を指定した場合,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
なお,インプロセスHTTPサーバ機能が有効の場合は,Webサーバ連携は使用できません。
false
webserver.connector.inprocess_http.enabled_methods アクセスを許可するHTTPメソッドを指定します。
複数のメソッドを指定する場合は,コンマ(,)で区切ります。メソッド名にはHTTP/1.1で定義されたメソッドを指定します。
また,アスタリスク(*)を指定した場合は,すべてのメソッドが許可されます。
HTTPメソッドでは大文字,小文字が区別されるため,このプロパティに指定する値も区別されます。
メソッド名にはRFC2616で規定されている値を使用する必要があります。ただし,文字列"*"をメソッド名として指定できません。
各メソッド名の前後の空白文字※2は無視されます。不正な値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
GET,HEAD,POST,PUT,DELETE,OPTIONS
webserver.connector.inprocess_http.error_custom.list エラーページカスタマイズ機能で使用するエラーページカスタマイズ定義名を指定します。
指定できる値の最大長は1024文字で,英数字(A〜Z,a〜z,0〜9)またはアンダースコア(_)で構成される文字列で指定します。定義名一つの文字列長は1〜32文字です。
定義名を複数指定する場合は,コンマ(,)で区切ります。コンマの前後の空白文字※2は無視されます。また,同じエラーページカスタマイズ定義名を複数回指定できません。
不正な値を指定した場合,メッセージが出力され,すべてのエラーページカスタマイズ定義は無効となります。
なし
webserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.file エラーページカスタマイズ機能で,エラーページカスタマイズ時のレスポンスボディとして使用するファイルを絶対パスで指定します。
パスの区切り記号には”/”を使用します。
webserver.connector.inprocess_http.error_custom.listで設定されていないエラーページカスタマイズ定義名を使用してこのプロパティを設定した場合,プロパティは無効になります。
webserver.connector.inprocess_http.error_custom.listで指定したエラーページカスタマイズ定義名について,このプロパティ,またはwebserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.redirect_urlのどちらか一方だけを必ず指定してください。両方のプロパティを指定した場合,どちらも指定しなかった場合,絶対パスで指定しなかった場合,または存在しないファイルや読み取り権限のないファイルを指定した場合は,メッセージが出力され,このエラーページカスタマイズ定義は無効となります。
空文字列または空白文字※2を指定した場合,プロパティは無効になります。
なし
webserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.file.content_type エラーページカスタマイズ機能で,エラーページカスタマイズ時のレスポンスのContent-Typeヘッダの値を指定します。
webserver.connector.inprocess_http.error_custom.listで設定されていないエラーページカスタマイズ定義名を使用してこのプロパティを設定した場合,プロパティは無効となります。
webserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.fileが設定されていない場合,プロパティは無効になります。
text/html
webserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.redirect_url エラーページカスタマイズ機能で,リダイレクトURLを絶対URLで指定します。
webserver.connector.inprocess_http.error_custom.listで設定されていないエラーページカスタマイズ定義名を使用してこのプロパティを設定した場合,プロパティは無効となります。
webserver.connector.inprocess_http.error_custom.listで指定したエラーページカスタマイズ定義名について,このプロパティ,またはwebserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.fileのどちらか一方だけを必ず指定してください。
値が正しいかどうかのチェックは行われないため,実際に動作させて確認する必要があります。
なし
webserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.request_url エラーページカスタマイズ機能で,エラーページカスタマイズを適用するリクエストURLをスラッシュ(/)で始まる絶対パスで指定します。ワイルドカード(*)はスラッシュの直後に1回だけ指定できます。"*"は必ずワイルドカードと解釈されるため,通常の文字としては使用できません。
また,このプロパティで指定した値とwebserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.statusで指定した値は,ほかのエラーページカスタマイズ定義と完全に一致してはいけません。
webserver.connector.inprocess_http.error_custom.listで設定されていないエラーページカスタマイズ定義名を使用してこのプロパティを設定した場合,プロパティは無効となります。
不正な値を指定した場合,メッセージが出力され,このエラーページカスタマイズ定義は無効となります。
/*
webserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.status エラーページカスタマイズ機能で,エラーページのカスタマイズを行うレスポンスのステータスコードを400〜599の整数で指定します。
このプロパティで指定した値,およびwebserver.connector.inprocess_http.error_custom.<エラーページカスタマイズ定義名>.request_urlで指定した値は,ほかのエラーページカスタマイズ定義と完全に一致してはいけません。
webserver.connector.inprocess_http.error_custom.listで設定されていないエラーページカスタマイズ定義名を使用してこのプロパティを設定した場合,プロパティは無効となります。
webserver.connector.inprocess_http.error_custom.listで指定したエラーページカスタマイズ定義名について,このプロパティは必ず指定してください。指定しなかった場合,または不正な値を指定した場合,メッセージが出力され,このエラーページカスタマイズ定義は無効となります。
なし
webserver.connector.inprocess_http.gateway.host ゲートウェイのホスト名またはIPアドレスを指定します。Hostヘッダのないリクエストに対してwelcomeファイルなどにリダイレクトするとき,Locationヘッダに指定するURLのホスト名部分が指定値となります。 なし
webserver.connector.inprocess_http.gateway.port ゲートウェイのポート番号を1〜65535の整数で指定します。
Hostヘッダのないリクエストに対してwelcomeファイルなどにリダイレクトするとき,Locationヘッダに指定するURLのポート番号部分が指定値となります。
webserver.connector.inprocess_http.gateway.hostが指定されていない場合は,このプロパティの指定は無視されます。
また,webserver.connector.inprocess_http.gateway.hostを指定し,このプロパティを省略した場合は下記の値が設定されます。
  • webserver.connector.inprocess_http.gateway.https_schemeにtrueを指定している場合:443
  • webserver.connector.inprocess_http.gateway.https_schemeにfalseを指定している場合,または未指定の場合:80
数値以外の文字列,または範囲外の数値を指定した場合は,メッセージが出力され,指定されなかったものとみなされます。
なし
webserver.connector.inprocess_http.gateway.https_scheme クライアントからのリクエストのスキームはhttpsで,SSLアクセラレータなどによってWebサーバへのスキームがhttpとなる場合にtrueを指定します。

trueを指定した場合:
Webサーバへのリクエストのスキームがhttpsとみなされます。

falseを指定した場合:
何もしません。
trueまたはfalse以外の文字列を指定した場合,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
false
webserver.connector.inprocess_http.hostname_lookups インプロセスHTTPサーバで受信したリクエストに対して,Webコンテナがホスト名のルックアップの逆引きをしてクライアントのIPアドレスをホスト名に変換するかどうかを指定します。
ただし,ホスト名の逆引きをすると,スループットが低下します。
ホスト名を解決しなかった場合,javax.servlet.ServletRequestインタフェースのgetRemoteHost()メソッドの結果や,ログファイルに出力するクライアントのIPアドレスは,ドット(.)で区切られた書式のIPアドレスとなります。

trueを指定した場合:
IPアドレスをホスト名に変換します。

falseを指定した場合:
IPアドレスをホスト名に変換しません。
trueまたはfalse以外の文字列を指定した場合,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
false
webserver.connector.inprocess_http.init_threads サーバ起動時に生成するインプロセスHTTPサーバのリクエスト処理スレッド数を1〜1024の整数で指定します。
指定する値は,Webクライアントとの最大接続数(webserver.connector.inprocess_http.max_connectionsに指定した値)以下である必要があります。これを超える値を指定した場合,メッセージが出力され,Webクライアントとの最大接続数が値として設定されます。
また,有効な最大値は実行するOSによって異なります。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
10
webserver.connector.inprocess_http.keep_start_threads サーバ起動時に作成したスレッド数を維持するかどうかを指定します。

trueを指定した場合:
サーバ起動時に作成したスレッド数を維持します。プールに保持された予備スレッド数が,予備スレッド数の最大数(webserver.connector.inprocess_http.max_spare_threadsに指定した値)を超えた状態でも,サーバ起動時に作成したスレッド数を下回りません。

falseを指定した場合:
サーバ起動時に作成したスレッド数を維持しません。予備スレッドとして保持する最大数,最小数に従って調節します。
また,サーバ起動時に作成したスレッド数が予備スレッド数の最小数(webserver.connector.inprocess_http.min_spare_threadsに指定した値)よりも小さい場合,このプロパティの設定に関係なく予備スレッドの最小数に指定した値でスレッド数が維持されます。
このプロパティにfalseを指定した場合,サーバ起動時に作成したスレッドは予備スレッド数の最大数以下になるように調整されます。サーバ起動時に予備スレッドの最大数より大きい数のリクエスト処理スレッドを作成した場合,予備スレッドの最大数を超えたスレッドは,サーバ起動後に1秒間隔で一つずつ破棄されます。
trueまたはfalse以外の文字列を指定した場合,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
false
webserver.connector.inprocess_http.limit.max_headers HTTPリクエストに含まれるHTTPヘッダの個数の上限を0〜32767の整数で指定します。上限値を設定しない場合は,0を指定してください。
このプロパティで指定したHTTPヘッダの個数に満たない場合でも,webserver.connector.inprocess_http.limit.max_request_headerで指定したサイズを超えた場合はエラーとなります。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
100
webserver.connector.inprocess_http.limit.max_request_body HTTPリクエストのリクエストボディの最大サイズ(単位:バイト)を-1〜2147483647の整数で指定します。上限値を設定しない場合は,-1を指定してください。また,リクエストボディがチャンク形式で送信された場合,チャンクヘッダのサイズも指定するサイズに含める必要があります。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
-1
webserver.connector.inprocess_http.limit.max_request_header HTTPリクエストのリクエストヘッダの最大サイズ(単位:バイト)を7〜65536の整数で指定します。
このプロパティで設定したリクエストヘッダの最大サイズに満たない場合でも,webserver.connector.inprocess_http.limit.max_headersで指定したHTTPヘッダを超えた場合はエラーとなります。
また,HTTPヘッダの終わりを示す改行文字(CR(0x0d)+LF(0x0a)の2バイト)も指定するサイズに含める必要があります。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
16384
webserver.connector.inprocess_http.limit.max_request_line リクエストラインの最大長(単位:バイト)を-1または7〜8190の整数で指定します。上限値を指定しない場合は,-1を指定してください。リクエストラインは,HTTPメソッドやクエリ文字列を含む,URIおよびHTTPバージョンを含みます。
指定する値は,リクエストヘッダの最大サイズ(webserver.connector.inprocess_http.limit.max_request_headerに指定した値)以下である必要があります。これを超える値を指定した場合は,メッセージが出力され,リクエストヘッダの最大サイズがリクエストラインの最大長として設定されます。
また,リクエストラインの終わりを示す改行文字(CR(0x0d)+LF(0x0a)の2バイト)も指定するサイズに含める必要があります。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
8190
webserver.connector.inprocess_http.max_connections Webクライアントとの最大接続数を1〜1024の整数で指定します。有効な最大値は実行するOSによって異なります。
このパラメタに指定した値がリクエスト処理スレッドの最大値になります。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
100
webserver.connector.inprocess_http.max_execute_threads Webコンテナがリクエストを処理する同時実行数を1〜1024の整数で指定します。
指定する値は,Webクライアントとの最大接続数(webserver.connector.inprocess_http.max_connectionsに指定した値)以下である必要があります。これを超える値を指定した場合は,メッセージが出力され,Webクライアントとの最大接続数が値に設定されます。
数値以外の文字列や範囲外の数値,空文字列または,空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
10
webserver.connector.inprocess_http.max_spare_threads プールに保存する予備スレッドの最大数を1〜1024の整数で指定します。
指定する値は,Webクライアントとの最大接続数(webserver.connector.inprocess_http.max_connectionsに指定した値)以下である必要があります。これを超える値を指定した場合は,メッセージが出力され,Webクライアントとの最大接続数が値に設定されます。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
20
webserver.connector.inprocess_http.min_spare_threads プールに保持する予備スレッドの最小数を1〜1024の整数で指定します。
設定する値はプールに保持する予備スレッドの最大数(webserver.connector.inprocess_http.max_spare_threadsに指定した値)以下である必要があります。プールに保持する予備スレッドの最大数を超える値を設定した場合は,メッセージが出力され,プールに保持する予備スレッドの最大数がプールに保持する予備スレッドの最小数として設定されます。
数値以外の文字列や範囲外の数値,空文字列,または空白文字※2を指定した場合は,メッセージが出力されデフォルト値が設定されます。
5
webserver.connector.inprocess_http.permitted.hosts インプロセスHTTPサーバへのアクセスを許可するホストのIPアドレス(10進表記),またはホスト名を指定します。複数指定する場合は,IPアドレスまたはホスト名の間をコンマ(,)で区切ります。アクセス制限をしない場合はアスタリスク(*)だけを指定します。
なお,ローカルホストは明記しなくても常にアクセスが許可されます。
空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
指定されたホスト名が解決できない場合は,メッセージが出力され,ローカルホストからのアクセスだけが許可されます。
なお,IPアドレスまたはホスト名の前後の半角スペースは無視されます。
*
webserver.connector.inprocess_http.persistent_connection.max_connections Persistent Connectionで保持するTCPコネクションの最大数を0〜1024の整数で指定します。
設定する値はWebクライアントとの最大接続数(webserver.connector.inprocess_http.max_connectionsに指定した値)以下である必要があります。Webクライアントとの最大接続数を超える値を設定した場合は,メッセージが出力され,Webクライアントとの最大接続数がPersistent Connectionで保持するTCPコネクションの最大数として設定されます。
数値以外の文字列や範囲外の数値を指定した場合は,メッセージが出力され,webserver.connector.inprocess_http.max_connectionsに指定した値がデフォルト値として設定されます。また,空文字列または空白文字※2を指定した場合は,webserver.connector.inprocess_http.max_connectionsに指定した値がデフォルト値として設定されます。
webserver.connector.inprocess_http.max_connectionsに指定した値
webserver.connector.inprocess_http.persistent_connection.max_requests Persistent ConnectionによるTCPコネクションを持続したままの連続接続回数の上限を0〜2147483647の整数で指定します。上限値を設定しない場合は,0を指定してください。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
100
webserver.connector.inprocess_http.persistent_connection.timeout Persistent ConnectionでTCPコネクションを持続した状態での,リクエスト待ち時間(単位:秒)を0〜3600の整数で指定します。0を指定した場合,タイムアウトしません。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
3
webserver.connector.inprocess_http.port インプロセスHTTPサーバが使用するポート番号を1〜65535の整数で指定します。すでにほかのアプリケーションで使用されているポート番号は指定できません。ほかのアプリケーションで使用されているポート番号や確保されているポート番号を指定した場合,メッセージが出力され,J2EEサーバが起動されません。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
80
webserver.connector.inprocess_http.receive_timeout Webクライアントからのリクエスト受信で,タイムアウトするまでの時間(単位:秒)を0〜3600の整数で指定します。0を指定した場合,タイムアウトしません。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
300
webserver.connector.inprocess_http.redirect.list リダイレクト機能で使用するリダイレクト定義名を指定します。
このプロパティに指定できる値の最大長は1024文字です。リダイレクト定義名は,英数字(A〜Z,a〜z,0〜9)またはアンダースコア(_)で構成される文字列で指定します。また,リダイレクト定義名一つの文字列長は1文字〜32文字です。
リダイレクト定義名を複数指定する場合は,コンマ(,)で区切ります。コンマの前後の空白文字※2は無視されます。同じリダイレクト定義名は複数回指定できません。
不正な値を指定した場合は,メッセージが出力され,すべてのリダイレクト定義は無効となります。
なし
webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.file リダイレクト機能で,リダイレクト時のレスポンスボディとして使用するファイルを絶対パスで指定します。パスの区切り記号には”/”を使用します。
webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.statusに200を指定した場合,必ずこのプロパティを指定します。webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.statusに200を指定し,このプロパティが指定されていない場合,メッセージが出力され,このリダイレクト定義は無効となります。
webserver.connector.inprocess_http.redirect.listで設定されていないリダイレクト定義名を使用してこのプロパティを設定した場合,空文字列または空白文字※2を指定した場合,プロパティは無効となります。
絶対パスでない値を指定した場合は,メッセージが出力され,このリダイレクト定義は無効となります。存在しないファイルや読み取り権限のないファイルを指定した場合は,J2EEサーバ起動時にメッセージが出力され,このリダイレクト定義は無効となります。
なし
webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.file.content_type リダイレクト機能で,リダイレクト時のレスポンスのContent-Typeヘッダの値を指定します。
webserver.connector.inprocess_http.redirect.listで設定されていないリダイレクト定義名を使用してこのプロパティを設定した場合,プロパティは無効となります。
webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.fileを設定していない場合,プロパティは無効となります。
text/html
webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.redirect_url リダイレクト機能で,リダイレクトURLを絶対URLで指定します。
webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.status に 200を指定した場合,このプロパティは設定できません。webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.statusに200を指定し,このプロパティを指定した場合,メッセージが出力され,リダイレクト定義は無効となります。
webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.statusに200以外を指定した場合,必ずこのプロパティを指定します。webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.status に 200以外を指定し,このプロパティを指定しなかった場合,メッセージが出力され,そのリダイレクト定義は無効となります。
webserver.connector.inprocess_http.redirect.listで設定されていないリダイレクト定義名を使用してこのプロパティを設定した場合,プロパティは無効となります。
値が正しいかどうかのチェックは行われないため,実際に動作させて確認する必要があります。
なし
webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.request_url リダイレクト機能で,リダイレクトを行うリクエストURLをスラッシュ(/)で始まる絶対パスで指定します。ワイルドカード(*)はスラッシュの直後に1回だけ指定できます。ワイルドカードは0文字以上の任意の文字列を表します。"*"は必ずワイルドカードと解釈されるため,通常の文字としては使用できません。また,ほかのリダイレクト定義で指定した値と同じ値は指定できません。
webserver.connector.inprocess_http.redirect.listで指定したリダイレクト定義名について,必ずこのプロパティを指定する必要があります。指定しなかった場合,メッセージが出力され,そのリダイレクト定義は無効となります。
webserver.connector.inprocess_http.redirect.listで設定されていないリダイレクト定義名を使用してこのプロパティを設定した場合,プロパティは無効となります。
不正な値を指定した場合は,メッセージが出力され,そのリダイレクト定義は無効となります。
なし
webserver.connector.inprocess_http.redirect.<リダイレクト定義名>.status リダイレクト機能で,リダイレクト時のレスポンスのステータスコード(200,300,301,302,303,305,307)を指定します。
webserver.connector.inprocess_http.redirect.listで設定されていないリダイレクト定義名を使用してこのプロパティを設定した場合,プロパティは無効となります。
不正な値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
302
webserver.connector.inprocess_http.rejection_threads アクセスを拒否するリクエスト処理スレッドの数を0〜1023の整数で指定します。指定する値は,リクエスト処理スレッドの最大数(webserver.connector.inprocess_http. max_connectionsに指定した値)よりも小さくする必要があります。Webクライアントとの最大接続数以上の値を設定した場合は,メッセージが出力され,Webクライアントとの最大接続数よりも1小さい値がアクセスを拒否するリクエスト処理スレッド数として設定されます。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
1
webserver.connector.inprocess_http.response.header.server レスポンスに自動的に付加するServerヘッダの値を指定します。
空文字列または空白文字※2を指定した場合,メッセージが出力され,デフォルト値が設定されます。
CosminexusComponentContainer
webserver.connector.inprocess_http.send_timeout Webクライアントへのレスポンス送信で,タイムアウトするまでの時間(単位:秒)を0〜3600の整数で指定します。0を指定した場合,タイムアウトは有効になりません。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
300
webserver.connector.redirect_https.port Webサーバが使用しているHTTPSのポート番号を指定します。
1〜65535の整数で指定します。
指定しない場合,HTTPSポートにリダイレクトしません。
すでにほかのアプリケーションで使用または確保されているポート番号は指定できません。また,複数のJ2EEサーバでWebサーバとの通信に使用するポートのポート番号に同じ値を設定しないでください。同一のポート番号を指定したJ2EEサーバはcjstartsvコマンドで複数起動できません。
なし

注※1
  • 有効な最大値は実行するプラットフォームに依存します。
  • Webサーバに到着するリクエストの一部がWebコンテナに転送されるため,Webサーバの最大同時接続数は,実行待ちキューサイズの総和+Webコンテナ単位の最大同時実行スレッド数より大きく設定する必要があります。
    また,データベース操作をするサーブレットやJSPについては,データベースコネクションの数よりも多くの多重度は得られないため,Webコンテナの同時実行数を増やす場合は,利用できるデータベースコネクションの数も増やす必要があります。
    性能のチューニング時には,次に示す関係を常に考慮して,各パラメタの値を調整してください。
    <Webサーバの最大同時接続数> > <実行待ちキューサイズの総和>+<Webコンテナ単位の最大同時実行スレッド数>
    <Webコンテナ単位の最大同時実行スレッド数> ≧ <データベースコネクションの数>
    Webコンテナでの同時実行スレッド数の制御については,マニュアル「Cosminexus 機能解説」を参照してください。
    Webサーバでの処理の同時接続数についてはWebサーバのマニュアルを参照してください。

注※2
空白文字とは,半角スペース,タブ,LF(0x0a),CR(0x0d)またはFF(0x0c)のことを指します。
(ae) webserver.containerから始まるキー
キー名称 内容 デフォルト値
webserver.container.ac.logEnabled Webコンテナの保守用のトレースログを出力するかどうかを指定します。

trueを指定した場合:
トレースログを出力します。

falseを指定した場合:
トレースログを出力しません。
false
webserver.container.server_id.enabled サーバIDのCookieをHTTPレスポンスに付加するかどうかを指定します。

trueを指定した場合:
サーバIDのCookieをHTTPレスポンスに付加します。webserver.container.server_id.valueで,サーバIDを指定してください。

falseを指定した場合:
サーバIDのCookieをHTTPレスポンスに付加しません。
trueまたはfalse以外の文字列を指定した場合,空文字列,または空白文字を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
false
webserver.container.server_id.name サーバIDのCookieをHTTPレスポンスに付加する場合に,Cookieの名前を指定します。1〜64文字の文字列で指定します。半角英数字(A〜Z,a〜z,0〜9)またはアンダースコア(_)が使用できます。ただし,次の名前はWebコンテナが使用するため,大文字・小文字の区別なく使用できません。
  • JSESSIONID
不正な値を指定した場合は,警告メッセージが出力されて,デフォルト値が設定されます。
ServerID
webserver.container.server_id.value サーバIDのCookieをHTTPレスポンスに付加する場合に,Cookieの値を指定します。1〜64文字の文字列で指定します。半角英数字(A〜Z,a〜z,0〜9)またはアンダースコア(_)が使用できます。
webserver.container.server_id.enabledにtrueを指定した場合に,このプロパティを省略したとき,または不正な値,空文字列,もしくは空白文字を指定したときは,メッセージが出力され,デフォルト値が設定されます。
また,プロパティのデフォルト値にはサーバ環境の情報が含まれています。この値はクライアントに送信されるため,サーバ環境の情報を含まない値を明示的に指定することを推奨します。

  • Webサーバ連携の場合:
    Webコンテナを実行するホストのIPアドレスとWebサーバとの通信に使用するポート番号から生成する文字列
  • インプロセスHTTPサーバの場合:
    Webコンテナを実行するホストのIPアドレスとインプロセスHTTPサーバが使用するポート番号から生成する文字列
webserver.container.thread_control.enabled Webアプリケーション単位の同時実行スレッド数の制御機能を使用するかどうかを指定します。J2EEサーバモードでだけ有効です。

trueを指定した場合:
Webアプリケーション単位の同時実行スレッド数の制御機能を有効にします。

falseを指定した場合:
Webアプリケーション単位の同時実行スレッド数の制御機能を無効にします。
true
webserver.container.thread_control.queue_size Webアプリケーション単位の同時実行スレッド数の制御機能を使用する場合に,デフォルトの実行待ちキューサイズを0〜2147483647の整数で指定します。J2EEサーバモードでだけ有効です。 8192

注※
空白文字とは,半角スペース,タブ,LF(0x0a),CR(0x0d)またはFF(0x0c)のことを指します。

(af) webserver.contextから始まるキー
キー名称 内容 デフォルト値
webserver.context.check_interval Webアプリケーションの更新検知インターバルを0〜2147483647の範囲(単位:秒)の整数で指定します。
0を指定した場合,更新の自動検知は行われません。
J2EEアプリケーションのリロード機能が無効の場合,このプロパティは設定できません。設定した場合無視されます。
数値以外の文字列,範囲外の数値または空文字列を指定した場合はメッセージを出力し,デフォルト値が設定されます。
ejbserver.deploy.context.check_intervalに設定した値(デフォルト値:0)
webserver.context.reload_delay_timeout Webアプリケーションのリロードの遅延実行機能の最大遅延期間を,負の整数または0〜2147483647(単位:秒)で指定します。
0を指定した場合は,リロードの遅延実行機能は使用されません。
J2EEアプリケーションのリロード機能が無効な場合,このプロパティは設定できません。設定した場合無視されます。
負の整数を指定した場合は,最大遅延期間を設定しないで,リロードの遅延実行機能が使用されます。
0
webserver.context.update.interval 更新するファイルのコピーに必要な時間のインターバルを0〜2147483647の範囲(単位:秒)の整数で指定します。なお,インターバルは余裕のある値にしてください。リソースの更新を検知してから指定したインターバルのあとに,処理中リクエストの監視が開始されます。
JSPのリロード機能が無効の場合,このプロパティは設定できません。設定した場合無視されます。
数値以外の文字列,範囲外の数値または空文字列を指定した場合はメッセージを出力し,デフォルト値が設定されます。
ejbserver.deploy.context.update.interval(デフォルト値:0)
(ag) webserver.errorpageから始まるキー
キー名称 内容 デフォルト値
webserver.errorpage.stack_trace.enabled 例外発生時,デフォルトのエラーページにスタックトレースを出力するかどうかを指定します。

trueを指定した場合:
スタックトレースを出力します。

falseを指定した場合:
スタックトレースを出力しません。
trueまたはfalse以外の文字列を指定した場合,空文字列または空白文字を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
false

注※
空白文字とは,半角スペース,タブ,LF(0x0a),CR(0x0d)またはFF(0x0c)のことを指します。

(ah) webserver.httpから始まるキー
キー名称 内容 デフォルト値
webserver.http.request.encoding リクエストボディおよびクエリのデコードに使用する文字エンコーディングを指定します。
デフォルトの文字エンコーディングとして設定できる文字は,JavaVMがサポートしている文字エンコーディングとなります。JavaVMがサポートしている文字エンコーディングについては,JDKのドキュメントのサポートされているエンコーディングに関する説明を参照してください。また,指定できる文字列は,java.nio API用の正準名とjava.lang API用の正準名に記載されている文字エンコーディング,およびそれらの別名になります。
なし
webserver.http.response.encoding レスポンスボディのエンコードに使用する文字エンコーディングを指定します。
デフォルトの文字エンコーディングとして設定できる文字は,JavaVMがサポートしている文字エンコーディングとなります。JavaVMがサポートしている文字エンコーディングについては,JDKのドキュメントのサポートされているエンコーディングに関する説明を参照してください。また,指定できる文字列は,java.nio API用の正準名とjava.lang API用の正準名に記載されている文字エンコーディング,およびそれらの別名になります。
なし
(ai) webserver.jspから始まるキー
キー名称 内容 デフォルト値
webserver.jsp.check_interval JSPの更新検知インターバルを0〜2147483647の範囲(単位:秒)の整数で指定します。
0を指定した場合,更新の自動検知は行われません。
JSPのリロード機能が無効の場合,このプロパティは設定できません。設定した場合無視されます。
数値以外の文字列,範囲外の数値または空文字列を指定した場合はメッセージを出力し,デフォルト値が設定されます。
ejbserver.deploy.context.check_intervalに設定した値(デフォルト値:0)
webserver.jsp.compile.backcompat JSPから生成されたサーブレットのjavaソースのコンパイル時に,javaソースコードのバージョンを指定します。このプロパティは,旧バージョンで生成されたJSP内のスクリプティングでJavaコードをJSP内に記述しているため,Cosminexusが提供するJavaVMのバージョンではコンパイルできない場合に指定します。Java VMのバージョンに依存しない場合,このプロパティを省略するか,falseを指定します。
指定できる値を次に示します。

1.4:
J2SE 1.4に従ったJavaソースを出力します。J2SE 5.0ではエラーとなるJ2SE 1.4に依存したソースコードをJSPファイルのスクリプティングに記述している場合に指定します。

1.3:
J2SE 1.3に従ったJavaソースを出力します。J2SE 5.0ではエラーとなるJ2SE 1.3に依存したソースコードをJSPファイルのスクリプティングに記述している場合に指定します。

1.2:
J2SE 1.2に従ったJavaソースを出力します。J2SE 5.0ではエラーとなるJ2SE 1.2に依存したソースコードをJSPファイルのスクリプティングに記述している場合に,指定します。

true:
J2SE 1.2に従ったJavaソースを出力します。J2SE 5.0ではエラーとなるJ2SE 1.2に依存したソースコードをJSPファイルのスクリプティングに記述している場合に,指定します。

false:
JSPファイル内にスクリプティングを記述していない場合,スクリプティングを記述している場合でもJ2SEのバージョンに依存しない場合に指定します。
指定可能なパラメタ値以外の文字列,空文字列または空白文字を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
false
webserver.jsp.keepgenerated JSPファイル,またはタグファイルのコンパイルで生成されたjavaファイルを保持するかどうかを指定します。
次の値を指定します。

trueを指定した場合:
javaファイルを保持します。

falseを指定した場合:
javaファイルを保持しません。
false
webserver.jsp.pageEncoding JSPの文字エンコーディングを指定します。デフォルトの文字エンコーディングとして設定できる文字は,JavaVMがサポートしている文字エンコーディングとなります。JavaVMがサポートしている文字エンコーディングについては,JDKのドキュメントのサポートされているエンコーディングに関する説明を参照してください。また,指定できる文字列は,java.nio API用の正準名とjava.lang API用の正準名に記載されている文字エンコーディング,およびそれらの別名になります。 なし
webserver.jsp.precompile.jsp_work_dir JSP事前コンパイル機能によって生成されたJSPファイルのコンパイル結果の格納先ディレクトリ名を指定します。
ディレクトリ名は,半角の英数字(A〜Z,a〜z,0〜9)またはアンダースコア(_)で構成される文字列で指定します。
不正な値を指定した場合は,メッセージが出力され,デフォルト値が設定されます。また,予約語である次の文字列を指定した場合は,メッセージが出力され,デフォルト値を使用します。
  • classes
  • lib
  • tags
cosminexus_jsp_work
webserver.jsp.translation.backcompat.customAction.declareVariable 複数のカスタムタグで,スクリプト変数名とスクリプト変数のスコープが重複する場合,JSPファイルから生成されたJavaコードで2回目のカスタムタグに対応するスクリプト変数の変数宣言を出力するかどうかを指定します。

true:
2回目以降のスクリプト変数を宣言します。

false:
2回目以降のスクリプト変数を宣言しません。(*)スクリプト変数のスコープは,javax.servlet.jsp.tagext.TagExtraInfoクラスのサブクラス,またはTLDファイルのvariable要素内のscope要素で指定できます。
false
webserver.jsp.translation.backcompat.taglib.noCheckPrefix taglibディレクティブの前に,taglibディレクティブで指定したprefixを使用したカスタムタグを記述しているかチェックするかどうかを指定します。

true:
チェックしない。

false:
チェックする。
false
webserver.jsp.translation.backcompat.tag.noCheckRtexprvalue Expressionが指定できないタグの属性値にExpressionが指定されているかどうか検証するかどうかを指定します。

true:
Expressionが指定されているかどうかを検証します。

false
Expressionが指定されているかどうかを検証しません。
false
webserver.jsp.translation.backcompat.tag.rtexprvalueTerminate タグの属性値が,「"<%=」または「'<%=」で開始しており,「%>"」(「'<%」で開始した場合は「%>'」)で終了していない属性値の「"」(または「'」)で囲まれた値を文字列として扱うかどうかを指定します。

true:
「"」までを文字列として扱います。

false:
「%>"」までを属性値とします。
false
webserver.jsp.translation.backcompat.useBean.noCheckClass JSPトランスレーション時に<jsp:useBean>タグのクラス属性値のチェック処理を実行するかどうかを指定します。

true:
クラス属性値をチェックしません。

false:
クラス属性値をチェックします。
false
webserver.jsp.update.interval JSPのリロード監視対象ファイルのコピーに必要な時間のインターバルを0〜2147483647の範囲(単位:秒)の整数で指定します。なお,インターバルは余裕のある値にしてください。JSPファイルの更新を検知してから指定したインターバルのあとに,JSPのリロードが実行されます。
JSPのリロード機能が無効の場合,このプロパティは設定できません。設定した場合無視されます。
数値以外の文字列,範囲外の数値または空文字列を指定した場合はメッセージを出力し,デフォルト値が設定されます。
ejbserver.deploy.context.update.intervalに設定した値(デフォルト値:0)

注※
空白文字とは,半角スペース,タブ,LF(0x0a),CR(0x0d)またはFF(0x0c)のことを指します。

(aj) webserver.loggerから始まるキー
キー名称 内容 デフォルト値
webserver.logger.access_log.inprocess_http.enabled インプロセスHTTPサーバのアクセスログ機能の有効・無効を設定します。

trueを指定した場合:
アクセスログ機能を有効にします。

falseを指定した場合:
アクセスログ機能を無効にします。
trueまたはfalse以外の文字列を指定した場合,空文字列または空白文字※1を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
true
webserver.logger.access_log.format_list インプロセスHTTPサーバのアクセスログ機能で使用するフォーマット名を指定します。
指定できる文字列の最大長は1024文字です。フォーマット名は,英数字(A〜Z,a〜z,0〜9)またはアンダースコア(_)で構成される文字列で指定します。また,一つ当たりのフォーマット名の文字列長は最大32文字です。format_listとmode_listは不正なフォーマット名として扱われるため,フォーマット名に指定できません。フォーマット名を複数指定する場合は,コンマ(,)で区切ります。一つ目に設定されたフォーマット名が指すフォーマット名はデフォルトのフォーマット名として扱われます。また,同じフォーマット名を複数回指定できません。commonとcombinedはアクセスログ機能での予約フォーマットのため指定できません。

(設定形式)
<フォーマット名>[,<フォーマット名>]*
([]*:[ ]部分の0回以上の繰り返しを示します)
次の場合はメッセージが出力され,デフォルト値が設定されます。
  • 文字列が何も指定されていない。
  • フォーマット名が32文字を超えた。
  • 不正なフォーマット名を指定した。
  • プロパティに指定できる値の最大長が1024文字を超えた。
  • 同じフォーマット名を複数回指定した。
  • 予約フォーマットのcommon,combinedのどちらか,または両方を削除した。
common,combined
webserver.logger.access_log.<フォーマット名> <フォーマット名>で定義されるアクセスログのフォーマットの形式※2をフォーマット引数で指定します。
指定できる値の最大長は1024文字です。使用できる文字は,アスキーコードの32(10進数)以上127(10進数)未満の文字です。
webserver.logger.access_log.format_listに定義されたすべてのフォーマット名について,webserver.logger.access_log.<フォーマット名>を設定する必要があります。webserver.logger.access_log.format_listに定義されていないフォーマット名でこのプロティを設定した場合,プロパティは無効となります。ただし,commonとcombinedのフォーマット名は指定する必要はありません。commonとcombinedのフォーマット名を指定した場合は,無効となります。
文字列が何も指定されていない場合,フォーマット形式が1024文字を超えた場合,または範囲外の文字を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
%h %l %u %t "%r" %>s %b
webserver.logger.access_log.inprocess_http.filename インプロセスHTTPサーバのアクセスログ機能で使用するログを出力するファイル名※3を絶対パスで指定します。指定できる値の最大長は210文字です。
210文字を超えた文字列を指定した場合,範囲外の数値や文字を指定した場合,または文字列が何も指定されていない場合は,メッセージが出力され,デフォルト値が設定されます。
指定したディレクトリが存在しない場合は,ディレクトリが作成されます。ディレクトリが作成されなかった場合は,J2EEサーバの起動に失敗します。

  • Windowsの場合
    <Cosminexus作業ディレクトリ>\ejb\<サーバ名称>\logs\http\cjhttp_access.inprocess_http
  • UNIXの場合
    <Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/logs/http/cjhttp_access.inprocess_http
webserver.logger.access_log.inprocess_http.filenum インプロセスHTTPサーバのWebコンテナのログファイルの面数を1〜256の整数で指定します。
数値以外の文字列や範囲外の数値を指定した場合,または文字列が何も指定されていない場合は,メッセージが出力され,デフォルト値が設定されます。
16
webserver.logger.access_log.inprocess_http.filesize インプロセスHTTPサーバのアクセスログファイルのサイズ(単位:バイト)を4096〜2147483647の整数で指定します。
数値以外の文字列や範囲外の数値を指定した場合,または文字列が何も指定されていない場合は,メッセージが出力され,デフォルト値が設定されます。
なお,アクセスログファイルのラップアラウンドの判定はログを書き込む前に行われるため,指定したファイルサイズを超える場合があります。
4194304
webserver.logger.access_log.inprocess_http.usage_format インプロセスHTTPサーバのアクセスログ機能で使用するフォーマットを選択します。
文字列が何も指定されていない場合,定義されていないフォーマット名を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
common
webserver.logger.communication_trace.inprocess_http.filenum インプロセスHTTPサーバの通信トレース機能のログファイルの面数を1〜256の整数で指定します。
数値以外の文字列や範囲外の数値を指定した場合,または文字列が何も指定されていない場合は,メッセージが出力され,デフォルト値が設定されます。
16
webserver.logger.thread_trace.inprocess_http.filenum インプロセスHTTPサーバのスレッドトレース機能のログファイルの面数を1〜256の整数で指定します。数値以外の文字列や範囲外の数値を指定した場合,または文字列が何も指定されていない場合は,メッセージが出力され,デフォルト値が設定されます。 16

注※1
空白文字とは,半角スペース,タブ,LF(0x0a),CR(0x0d)またはFF(0x0c)のことを指します。

注※2
指定できるフォーマット引数と出力例を次の表に示します。

フォーマット引数 出力内容 出力例
%% % 記号。 %
%a WebクライアントのIPアドレス。 10.20.30.40
%A J2EEサーバのIPアドレス。 10.20.30.100
%b HTTPヘッダを除く送信バイト数。0バイトのときは「-」となります。 2048
%B HTTPヘッダを除く送信バイト数。0バイトのときは「0」となります。 1024
%h Webクライアントのホスト名またはIPアドレス。ホスト名が得られない場合はIPアドレスとなります。 10.20.30.40
%H リクエストプロトコル。 HTTP/1.1
%l リモートログ名(RFC 1413で規定されているIdentificationプロトコルによって得られるWebクライアント側のユーザ名)。 -
%m リクエストメソッド。 GET
%p Webクライアントからのリクエストを受け付けたポート番号。 80
%q クエリ文字列。「?」から始まります。クエリ文字列がない場合は空文字となります。 ?id=100&page=15
%r リクエストライン。 GET /index.html HTTP/1.1
%>s 最終ステータスコード(内部リダイレクトされた値は出力しません)。 200
%S ユーザのセッションID。セッションIDがない場合は「-」となります。
%Sで表示されるセッションIDはクッキー名JSESSIONIDの値であり,セッションフェイルオーバ機能でのグローバルセッションIDとは異なります。グローバルセッションIDを出力する場合は,%{GSESSIONID}cを指定します。GIDCookieNameを変更した場合は,変更したGIDCookieNameの値を指定します。
00455AFE4DA4E7B7789F247B8FE5D605
%t Webクライアントのリクエストに応答した時刻[dd/MMM/YYYY:HH:mm:ss Z]。 [18/Jan/2005:13:06:10 +0900]
%T Webクライアントのリクエストの処理に要した時間(単位:秒)。 2
%d Webクライアントのリクエストに応答した時刻。次の形式で表示します。[dd/MMM/YYYY:HH:mm:ss.nnn Z](nnnはミリ秒) [18/Jan/2005:13:06:10.152 +0900]
%D Webクライアントのリクエストの処理に要した時間(単位:ミリ秒)。 2000
%u ベーシック認証ユーザ名,またはフォーム認証ユーザ名。認証ユーザ名がない場合は「-」となります。 user
%U リクエストファイルパス。 /index.html
%v J2EEサーバのローカルホスト名。 server
%{foo}i リクエストヘッダfooの内容。fooヘッダが存在しない場合は「-」になります。
一度のHTTPリクエストまたはHTTPレスポンスで同じヘッダ名が複数回送信された場合,最初に読み込んだヘッダの内容を出力します。
%{Host}iの場合
www.example.com:8888
%{foo}c Webクライアントが送信したCookie情報でCookieの名前がfooの内容。Cookieの名前にfooがない場合は「-」になります。 %{JSESSIONID}cの場合
00455AFE4DA4E7B7789F247B8FE5D605
%{foo}o レスポンスヘッダfooの内容。fooヘッダが存在しない場合は「-」になります。
一度のHTTPリクエストまたはHTTPレスポンスで同じヘッダ名が複数回送信された場合,最初に読み込んだヘッダの内容を出力します。
%{Server}oの場合
CosminexusComponentContainer

注※3
ファイル名の末尾に<連番>.logが追加されます。

(ak) webserver.sessionから始まるキー
キー名称 内容 デフォルト値
webserver.session.max.log_interval HttpSession数の上限値を超えてHttpSessionオブジェクトを生成しようとした場合に出力されるメッセージKDJE39225-Eのインターバルを,0〜2147483647の整数(単位:秒)で指定します。
メッセージKDJE39225-Eが出力されてからこのプロパティで指定したインターバルの間,メッセージKDJE39225-Eの出力を抑止します。なお,この設定はWebアプリケーション単位に適用されます。
数値以外の文字列や範囲外の数値を指定した場合は,警告メッセージが出力され,デフォルト値が設定されます。
60
webserver.session.server_id.enabled セッションIDにサーバIDを付加するかどうかを指定します。

trueを指定した場合:
セッションIDにサーバIDを付加します。

falseを指定した場合:
セッションIDにサーバIDを付加しません。
通常はtrueを指定し,webserver.session.server_id.valueで,サーバIDを指定してください。06-51以前から06-70以降に移行すると,このプロパティのデフォルト値がfalseからtrueに変更になります。trueの場合は,falseの場合に比べてセッションIDの文字列長がサーバIDの長さ分増加します。これによって問題が発生する場合,次の対処をしてください。

負荷分散機によって複数のWebコンテナでシステムを冗長構成にしていない場合:
falseを指定し,サーバIDをセッションIDに付加しないでください。

負荷分散機によって複数のWebコンテナでシステムを冗長構成にしている場合:
trueを指定し,セッションIDの文字列長が増加することで発生する問題を対策してください。falseを指定した場合,動作は保証できません。
trueまたはfalse以外の文字列を指定した場合,空文字列または空白文字を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
true
webserver.session.server_id.value セッションIDに付加するサーバIDを,1〜64文字の文字列で指定します。半角英数字(A〜Z,a〜z,0〜9)またはアンダースコア(_)が使用できます。
webserver.session.server_id.enabledにtrueを指定し,このプロパティを省略した場合,またはプロパティに不正な値,空文字列,もしくは空白文字を指定した場合,メッセージが出力され,デフォルト値が設定されます。
また,プロパティのデフォルト値にはサーバ環境の情報が含まれています。この値はクライアントに送信されるため,サーバ環境の情報を含まない値を明示的に指定することを推奨します。

  • Webサーバ連携の場合:
    Webコンテナを実行するホストのIPアドレスとWebサーバとの通信に使用するポート番号から生成する文字列
  • インプロセスHTTPサーバの場合:
    Webコンテナを実行するホストのIPアドレスとインプロセスHTTPサーバが使用するポート番号から生成する文字列

注※
空白文字とは,半角スペース,タブ,LF(0x0a),CR(0x0d)またはFF(0x0c)のことを指します。

(al) webserver.sfoから始まるキー
キー名称 内容 デフォルト値
webserver.sfo.negotiation.ignore_serverId ネゴシエーションで,J2EEサーバに設定されたHttpSessionのセッションIDに付加するサーバIDが,すでに接続済みのJ2EEサーバの設定と一致した場合に,エラーとするかどうかを指定します。

trueを指定した場合:
エラーとします。

falseを指定した場合:
エラーとしません。
false
webserver.sfo.sfo_servers J2EEサーバ上のWebアプリケーションが使用する,すべてのSFOサーバ名を指定します。1024文字までの文字列が指定できます。半角英数字(A〜Z,a〜z,0〜9)またはアンダースコア(_)が使用できます。
SFOサーバを複数指定する場合は,半角コンマ(,)で区切ります。ただし,一つのSFOサーバ名に指定できる文字列長は32文字までです。このとき,一つ目に指定されたSFOサーバ名がデフォルトとなります。

指定形式:
<SFOサーバ名>[,<SFOサーバ名>]
同じSFOサーバ名を複数回指定することはできません。
セッションフェイルオーバ機能を使用しない場合,このプロパティは無効です。
なし
webserver.sfo.sfo_server.<SFOサーバ名>.naming <SFOサーバ名>が指すSFOサーバのインプロセスで起動したCORBAネーミングサービスのIPアドレスまたはホスト名,およびポート番号を指定します。
IPアドレスは10進表記で,ポート番号は1〜65535の整数で指定します。区切り文字には半角コロン(:)を使用します。

指定形式:
<IPアドレス>:<ポート番号>
<ホスト名>:<ポート番号>
webserver.sfo.sfo_serversキーで指定した,すべてのSFOサーバについて設定が必要です。設定されていないSFOサーバが存在した場合,セッションフェイルオーバを使用するアプリケーションは開始できません。
なし
webserver.sfo.sfo_server.<SFOサーバ名>.connectionTimeout J2EEサーバからSFOサーバに通信した際のタイムアウト時間を,1〜3600の整数(単位:秒)で指定します。 30
webserver.sfo.check_size.mode グローバルセッション情報のサイズ見積もり機能を有効にするかどうかを指定します。

onを指定した場合:
グローバルセッション情報のサイズ見積もり機能が有効になります。

offを指定した場合
グローバルセッション情報のサイズ見積もり機能が無効になります。
off

注※
webserver.sfo.sfo_serversキーで指定したSFOサーバ名。webserver.sfo.sfo_serversキーに指定されていないSFOサーバ名を指定した場合,そのキーは無効になります。

(am) webserver.staticから始まるキー
キー名称 内容 デフォルト値
webserver.static_content.cache.enabled 静的コンテンツキャッシュ機能の有効/無効/強制的な無効を指定します。

trueを指定した場合:
静的コンテンツキャッシュ機能を有効にします。

falseを指定した場合:
静的コンテンツキャッシュ機能を無効にします。

forceoffを指定した場合:
DDファイル(web.xml)またはアプリケーション属性ファイルで静的コンテンツキャッシュが有効と設定されていても,キャッシュ機能を強制的に無効にします。
このプロパティがfalseおよびforceoffの場合,webserver.static_content.cache.size,webserver.static_content.cache.filesize.thresholdの設定は無効となります。
DDファイル(web.xml)またはアプリケーション属性ファイルで,静的コンテンツキャッシュ機能の有効/無効が設定されていないWebアプリケーションでは,このプロパティに指定した値が有効になります。また,静的コンテンツキャッシュ機能の有効/無効が設定されているWebアプリケーションではこのプロパティに指定した値は無効となります。ただし,forceoffを指定した場合は,DDファイル(web.xml)またはアプリケーション属性ファイルの設定に関係なく,このプロパティに指定した値が有効になります。
true,false,forceoff以外の文字列,空文字列または空白文字を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
false
webserver.static_content.cache.size 静的コンテンツキャッシュ機能が有効な場合,メモリにキャッシュできるサイズ(単位:バイト)の上限を0〜2147483647の整数で指定します。
Webアプリケーション単位で,キャッシュの合計サイズが指定した値を超えた場合は,アクセスされていない時間が最も長いキャッシュから削除していき,キャッシュの合計サイズが設定した値以下になるまでキャッシュの削除が繰り返されます。
0を指定した場合,キャッシュできるサイズに上限を設けません。
DD(web.xml)またはアプリケーション属性ファイルで,キャッシュできるメモリサイズが設定されていないWebアプリケーションでは,このプロパティに指定した値が有効となります。また,キャッシュできるメモリサイズが設定されているWebアプリケーションでは,このプロパティに指定した値は無効となります。
無効な値,webserver.static_content.cache.filesize.thresholdで指定した値よりも小さい値,空文字列または空白文字を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
10485760
webserver.static_content.cache.filesize.threshold 静的コンテンツキャッシュ機能が有効な場合,キャッシュできるファイルサイズ(単位:バイト)を0〜2147483647の整数で指定します。
指定した値を超えるサイズのファイルはキャッシュされません。
0を指定した場合,キャッシュできるファイルのサイズに上限を設けません。
DD(web.xml)またはアプリケーション属性ファイルで,キャッシュできるファイルサイズが設定されていないWebアプリケーションでは,このプロパティに指定した値が有効になります。また,キャッシュできるファイルサイズが設定されているWebアプリケーションでは,このプロパティに指定した値は無効となります。
無効な値,webserver.static_content.cache.sizeで指定した値より大きい値,空文字列または空白文字を設定した場合は,メッセージが出力され,デフォルト値が設定されます。
524288
webserver.static_content.encoding.extension 静的コンテンツに使用する文字エンコーディングを適用させる拡張子を指定します。webserver.http.response.encodingキーが指定されている場合に有効になります。
キーの値に何も設定しない場合,このキーは無効になります。
なし

注※
空白文字とは,半角スペース,タブ,LF(0x0a),CR(0x0d)またはFF(0x0c)のことを指します。

(an) webserver.workから始まるキー
キー名称 内容 デフォルト値
webserver.work.clean JSP用テンポラリディレクトリ下に生成したディレクトリをサーバ起動時,および終了時に削除するかどうかを指定します。

trueが指定された場合:
ディレクトリを削除します。

falseが指定された場合:
ディレクトリを削除しません。
false
webserver.work.directory JSP用テンポラリディレクトリを指定します。絶対パスによるディレクトリ名を指定します。
ディレクトリのパスの区切り記号には,"/"を使用してください。
例えば,Windowsの場合,workディレクトリとしてC:\temp\workを設定するときは,次のように指定します。
(指定例)
webserver.work.directory=c:/temp/work

  • Windowsの場合
    <Cosminexusのインストールディレクトリ>\CC\server\repository\<サーバ名称>\web
  • UNIXの場合
    /opt/Cosminexus/CC/server/repository/<サーバ名称>/web

注※
使用するOSによってファイル名長に制限があります。例えば,Windowsでは250バイト程度となっています。このため,ディレクトリ階層の深い場所でサーブレットやJSPを実行できません。特にJSPファイルから生成されるファイル名はWebアプリケーションで配置されたディレクトリ階層の深さに比例して長くなり,JSPファイルに対するJavaファイルを生成できないことがあります。これを回避するためにはWebアプリケーションの配置ディレクトリの階層を浅くしたり,プロパティwebserver.work.directoryに絶対パスで浅いディレクトリ階層を指定したりすることで回避してください。Cosminexusの作業ディレクトリについては,マニュアル「Cosminexus システム構築ガイド」を参照してください。

(ao) webserver.xmlから始まるキー
キー名称 内容 デフォルト値
webserver.xml.validate Servlet 2.3のWebアプリケーションについて,タグライブラリ・ディスクリプタ(TLDファイル)が,DTDで記述されたスキーマに沿って記述されているかチェックするかどうかを指定します。
J2EEサーバモードで起動した場合のweb.xml,およびServlet 2.4のWebアプリケーションのTLDファイルには,このプロパティの指定は無効となります。また,Servlet 2.4のWebアプリケーションに含まれるTLDファイルはTLDのバージョンにかかわらずすべてチェックされます。
次の値を指定します。

trueを指定した場合:
タグライブラリ・ディスクリプタだけをチェックします。

falseを指定した場合:
チェックしません。
true

(6) 記述例

 
ejbserver.server.j2ee.feature=1.4
 
ejbserver.deploy.stub.generation.scope=ejb
ejbserver.compiler.jvm.maxHeapSize=256m
ejbserver.compiler.jvm.minHeapSize=32m
 
ejbserver.naming.host=localhost
ejbserver.naming.port=900
ejbserver.naming.protocol=corbaname
ejbserver.naming.startupMode=inprocess
ejbserver.naming.startupWaitTime=1
ejbserver.naming.startupRetryCount=9
 
ejbserver.logger.enabled.*=Error,Warning,Information,Debug
ejbserver.logger.channels.define.MessageLogFile.filenum=2
ejbserver.logger.channels.define.MessageLogFile.filesize=1048576
 
ejbserver.application.InitTermProcessClasses=InitTermClass1,InitTermClass2
 
webserver.connector.http.permitted.hosts=host1,host2
webserver.work.directory=c:/work
webserver.sfo.sfo_servers=sfo_server1,sfo_server2
webserver.sfo.sfo_server.sfo_server1.naming=host1:910
webserver.sfo.sfo_server.sfo_server1.connectionTimeout=5
webserver.sfo.sfo_server.sfo_server2.naming=host2:911
webserver.sfo.sfo_server.sfo_server2.connectionTimeout=10