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およびJava SE 6に準拠しています。詳細については,マニュアル「Cosminexus アプリケーションサーバ 概説」を参照してください。また,JDK 5.0およびJDK 6で使用できるプロパティについては,Sun Microsystems社が提供しているJDK 5.0およびJDK 6のドキュメントを参照してください。

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

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

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

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

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

(a) cosminexus.jpaから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
cosminexus.jpa.logging.level.operation.<category>J2EEサーバのJPA機能を利用する場合に,JPAプロバイダ稼働ログのカテゴリごとのログレベルを指定します。カテゴリ名,およびログレベルは大文字と小文字を区別します。
未設定の場合,稼働ログには出力されません。セキュリティや性能面に対する影響があるため,出力レベルの設定には注意してください。
Offを指定した場合:
JPAプロバイダ稼働ログに対するログを出力しません。
Informationを指定した場合:
JPAプロバイダ稼働ログにJPAの稼働情報を出力します。
Detailを指定した場合:
JPAプロバイダ稼働ログにJPAの詳細な稼働情報および,Informationで出力される情報を出力します。
Off08-00
cosminexus.jpa.exception.logging.sqlJPAプロバイダがSQL文を実行してデータベースから例外を受け取った場合に,例外メッセージに例外が発生した原因となったSQL文を含むどうかを指定します。
Offを指定した場合:
JPAプロバイダが実行したSQL文と?パラメタ(プレースホルダ)への指定値を例外メッセージに含みません。
Informationを指定した場合:
JPAプロバイダが実行したSQL文を例外メッセージに含みます。
Detailを指定した場合:
JPAプロバイダが実行したSQL文と?パラメタ(プレースホルダ)への指定値を例外メッセージに含みます。
Off08-00
注※
このプロパティで指定した値は,例外ログの出力内容にも反映されます。
Information,およびDetailの場合は,SQL文や?パラメータ(プレースホルダ)の内容が例外ログにも出力されるため,セキュリティに注意してください。開発時や保守のために必要に応じて値を指定してください。
バイナリデータを扱う場合,?パラメータ(プレースホルダ)にはバイナリオブジェクトのハッシュ値が出力されます。
SQL発行の準備が完了する以前に通信異常によるコネクション取得エラーなどが発生した場合, ?パラメータ(プレースホルダ)値を取得できない場合があります。

(b) ejbserver.applicationから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.application.InitTermProcessClassesコンテナ拡張ライブラリを使用する場合に,サーバ起動・停止フックのクラス名を指定します。複数のクラスを指定する場合は,","で区切って指定してください。なお,","とクラス名の間には,空白を入れないでください。J2EEサーバ起動時には,指定した順で,サーバ起動・停止フック機能のサーバ起動フックメソッドが呼び出されます。J2EEサーバ終了時には,指定した逆順にサーバ起動・停止フック機能のサーバ停止フックメソッドが呼び出されます。なし
ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>※1.appnameAppNameのフィールドに出力するデフォルトのアプリケーション名を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.msgidMsgIDのフィールドに出力するデフォルトのメッセージ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.separatorCJSimpleFormatterを利用して,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
(凡例)
-:08-00より前のバージョンを示します。

ユーザログ機能についてのプロパティ定義(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"で終了させないことを推奨します。

(c) ejbserver.clientから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.client.ctm.RequestPriorityCTM内のキューに滞留したリクエストを引き出す時のプライオリティ(優先順位)を1~8の整数で指定します。指定値が小さいほどプライオリティは高くなります。指定値が誤っている場合,または省略した場合は,4が設定されます。4
(凡例)
-:08-00より前のバージョンを示します。

(d) ejbserver.commonjから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.commonj.WorkManager.non_daemon_work_threadsWorkManagerで短寿命Workの実行を行うスレッドプールの最大プールサイズを指定します1~65535の整数で指定します。1008-50
(e) ejbserver.compilerから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.compiler.jvm.maxHeapSizeJ2EEアプリケーション開始時に起動されるjavacコマンドのヒープサイズの最大値を指定します。
指定する値は,javaコマンドの-Xmx,-Xmsオプションが受け付ける形式で指定してください。それ以外の形式で指定された場合の動作は保証されません。
次のように指定してください。
  • 2048~4294966272の値を指定してください。ただし,ejbserver.compiler.jvm.minHeapSizeに指定した以上の値にしてください。
  • キロバイト単位で指定する場合は,文字「k」または「K」を付けて指定してください。
  • メガバイト単位で指定する場合は,文字「m」または「M」を付けて指定してください。
256m
ejbserver.compiler.jvm.minHeapSizeJ2EEアプリケーション開始時に起動されるjavacコマンドのヒープサイズの初期値を指定します。
指定する値は,javaコマンドの-Xmx,-Xmsオプションが受け付ける形式で指定してください。それ以外の形式で指定された場合の動作は保証されません。
次のように指定してください。
  • 1024~-Xmx指定値の値を指定してください。
  • キロバイト単位で指定するには,文字「k」または「K」を付けて指定してください。
  • メガバイト単位で指定するには,文字「m」または「M」を付けて指定してください。
32m
(凡例)
-:08-00より前のバージョンを示します。

(f) ejbserver.connectionpoolから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.connectionpool.applicationAuthentication.disabledコンテナ管理のサインオンの最適化機能を有効にするかどうかを指定します。
trueを指定した場合:
コンテナ管理のサインオンが最適化された動作となります。ただし,これを指定した場合,アプリケーション管理によるサインオンは使用できません。
falseを指定した場合:
コンテナ管理のサインオンは最適化されません。コンテナ管理によるサインオン,およびアプリケーション管理によるサインオンを使用できます。
なお,DB Connector以外のリソースアダプタを使用する場合には,このプロパティにtrueを指定することはできません。
false
ejbserver.connectionpool.association.enabled1.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を指定している場合,コネクションアソシエーションを行いません。
アプリケーションサーバのバージョンが06-50より前のバージョンで動作実績のあるアプリケーションを,Cosminexus 06-50以降で動作させる場合,次のことに注意してください。
アプリケーションが,<res-sharing-scope>にUnshareableを指定している場合でも,コネクションアソシエーション機能が動作することを期待している場合(具体的には,ローカルトランザクション内でコネクションを2本以上取得する場合など)には,trueを指定する必要があります。
なお,アプリケーションを新規に開発する場合には,このキーは指定しないでください。
false
ejbserver.connectionpool.sharingOutsideTransactionScope.enabled1.4モードの場合に,アプリケーションサーバが管理するトランザクションの外で複数回コネクションの取得を行ったときのコネクションシェアリングの動作を指定します。なお,リソースアダプタのトランザクションサポートレベルにNoTransactionを指定した場合は,コネクションシェアリングは行われません。
trueを指定した場合:
コネクションシェアリングを行います。なお,trueを指定した場合でも,サーブレットやEnterprise Beanの標準DDの<res-sharing-scope>にUnshareableを指定している場合には,コネクションシェアリングは行いません。
falseを指定した場合:
アプリケーションサーバが管理するトランザクションの外ではコネクションシェアリングを行いません。
false
ejbserver.connectionpool.validation.timeoutコネクション障害検知機能のタイムアウト時間およびコネクション数調節機能によるコネクション削除処理のタイムアウト時間を指定します。508-00
(g) ejbserver.connectorから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.connector.logwriter.filenumリソースアダプタ用ログファイルの面数を1~16の整数で指定します。4
ejbserver.connector.logwriter.filesizeリソースアダプタ用ログファイルのサイズ(単位:バイト)を4096~2147483647の整数で指定します。2097152
(凡例)
-:08-00より前のバージョンを示します。

(h) ejbserver.containerから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.container.audit_trail.enabledデータベース監査証跡連携機能を有効にするかどうかを指定します。
trueを指定した場合:
データベース監査証跡連携機能を有効にします。
falseを指定した場合:
データベース監査証跡連携機能を無効にします。
false
ejbserver.container.bmp.backcompatibleEntity Bean(BMP)のロック制御の動作を指定します。
trueを指定した場合:
EJBコンテナでロックを制御します。
falseを指定した場合:
EJBコンテナでロックを制御しません。
なお,このプロパティの変更を有効にするには,開始中のJ2EEアプリケーションをいったん削除し,再作成または再インポートしてください。
false
ejbserver.container.ejbhome.sessionbean.reconnect.enabledEJBホームオブジェクトへの再接続機能を有効にするかどうかを指定します。
trueを指定した場合:
EJBホームオブジェクトへの再接続機能を有効にします。
trueを指定した場合は,必ずvbroker.se.iiop_tp.scm.iiop_tp.listener.portプロパティにポート番号を指定してください。
falseを指定した場合:
EJBホームオブジェクトへの再接続機能を無効にします。
false
ejbserver.container.passivate.scan.intervalEnterprise Beanのタイムアウトやプールの状態を監視するスレッドの起動間隔を,0~2147483の整数(単位:秒)で指定します。
0を指定した場合は監視しません。
0
ejbserver.container.rebindpolicyEJBメソッドの呼び出し時に通信障害が発生した場合の,EJBクライアント側でのコネクションの再接続動作とリクエストの再送動作を指定します。
VB_TRANSPARENT:
コネクションを再接続してリクエストを再送します。
NO_RECONNECT:
コネクションを再接続しないで,リクエストを再送しません。
この場合,通信障害によってコネクションが切断されると,再接続されないため,そのオブジェクトリファレンスは再利用できなくなります。
VB_TRANSPARENT
ejbserver.container.security.disabledEnterprise Beanのアクセス制御機能を有効にするかどうかを指定します。Enterprise Beanのアクセス制御機能の詳細についてはマニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(EJBコンテナ)」の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
(凡例)
-:08-00より前のバージョンを示します。

(i) ejbserver.ctmから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.ctm.ActivateTimeOutCTM機能を使用する場合に必要なプロパティです。CTM機能を使用するJ2EEアプリケーションのデプロイ時,J2EEサーバはスケジュールキューを活性化します。このときの待ち時間(単位:秒)を0~2147483647で指定します。0を指定した場合,無限に待ち続け,省略した場合は,180(秒)が設定されます。180
ejbserver.ctm.CTMDomainCTM機能を使用する場合に必要なプロパティです。J2EEサーバが属するCTMドメイン名称を1~31文字の英数字またはアンダースコア(_)で指定します。"CTM"または"ctm"で始まるCTMドメイン名称は指定できません。省略した場合,"CTMDOMAIN"が設定されます。CTMDOMAIN
ejbserver.ctm.CTMIDCTM機能を使用する場合に必要なプロパティです。J2EEサーバを制御するCTMデーモンのCTM識別子を1~31文字の英数字,アンダースコア(_)またはピリオド(.)で指定します。ただし,IPアドレスで識別子を指定する場合にだけピリオドが使用できます。
"CTM"または"ctm"で始まるCTM識別子は指定できません。またCTMドメイン名称と同じ名称を指定できません。省略した場合,IPアドレスが設定されます。
<IPアドレス>
ejbserver.ctm.CTMMyHostCTM機能を使用する場合に必要なプロパティです。マルチホームまたはIPアドレスを引き継ぐ系切り替え環境でCTMが使用するホスト名称またはIPアドレスを1~64文字の文字列で指定します。
省略した場合は,hostnameコマンドで取得できるホスト名称が設定されます。
ejbserver.ctm.CTMIDプロパティを省略してこのプロパティを指定した場合,デフォルトのCTM識別子は,このプロパティで指定したIPアドレスになります。
<hostnameコマンドで取得されるホスト名称>
ejbserver.ctm.DeactivateTimeOutCTM機能を使用するJ2EEアプリケーションのアンデプロイ時,J2EEサーバはスケジュールキューを非活性化します。このときの待ち時間(実行中のリクエストの完了待ち)を0~2147483647(単位:秒)で指定します。0を指定した場合,無限に待ち続け,省略した場合は,180(秒)が設定されます。
CTM経由で仕掛かり中のリクエストがある状態でアプリケーションを停止しようとした場合に,強制停止できなくなるため,0は指定しないでください。
180
ejbserver.ctm.enabledCTM機能の使用の有無を指定します。
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.QueueLengthCTM機能を使用するJ2EEアプリケーションのデプロイ時,J2EEサーバはCTMキューを生成します。このときのCTMキューの長さを,1~32767で指定します。省略した場合,CTMデーモンで保持しているCTMキューの生成時の長さ(-CTMMaxRequestCountオプションで指定した長さ)が有効となります。CTMキューを共有する場合,CTMキューはすでに作成されているため,指定された値ではなく作成済みの長さが有効となります。なし
(凡例)
-:08-00より前のバージョンを示します。

(j) ejbserver.deployから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.deploy.app.stopforcibly.disabledJ2EEアプリケーションの強制停止を無効にするかどうかを指定します。
trueを指定した場合:
J2EEアプリケーションの強制停止を無効にします。
falseを指定した場合:
J2EEアプリケーションの強制停止を有効にします。
false
ejbserver.deploy.annotations.load_check.enabledアノテーション情報取得のためのクラスロードで例外が発生した場合に無視するかどうかを指定します。
trueを指定した場合:
エラーとなり処理を中断します。
falseを指定した場合:
例外ログを取得し処理を続行します。
  • 新規インストール時
    false
  • 07-60より以前からのアップデート時
    true
08-00
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
app:
EJBアプリケーション,サーブレット,JSPでリロード機能を使用します。
jsp:
JSPでリロード機能を使用します。
none:
リロード機能を使用しません。
web:
サーブレット,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.directoryWebアプリケーションのセッション情報ファイルを設定した<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
(凡例)
-:08-00より前のバージョンを示します。

(k) ejbserver.distributedtxから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.distributedtx.enableXidReuseOptimization1.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.port1.4モードの場合に,グローバルトランザクションを使用するとき,トランザクションリカバリで使用する固定ポート番号を1~65535の整数で指定します。無効な値を指定した場合や,指定したポートがすでに使用されていた場合には,起動が中断されます。なお,ライトトランザクションを有効として起動した場合は,このプロパティは無視されます。20302
ejbserver.distributedtx.rollbackClientTxOnSystemExceptionシステム例外が発生した場合に,呼び出したクライアントトランザクションをロールバックにマークするかどうかを指定します。
trueを指定した場合:
クライアントトランザクションをロールバックにマークします。
falseを指定した場合:
クライアントトランザクションをロールバックにマークしません。
プロパティが指定されていない場合や,無効な値を指定した場合は,falseが設定されます。
J2EEサーバが1.4モードで稼働時に,クライアントのトランザクションを開始してJ2EEサーバにあるリモートインタフェースを実装したEJBを,ローカル呼び出し最適化で呼び出し,呼ばれたEJBで新たなトランザクションを開始するかトランザクションを開始しない場合にだけ,このプロパティが有効になります。
false(1.4モードからの上書きインストールの場合はtrue)
ejbserver.distributedtx.XATransaction.enabled1.4モードの場合に,グローバルトランザクションを使用するかどうかを指定します。
trueを指定した場合:
ライトトランザクション機能が無効となり,グローバルトランザクションを利用できます。
falseを指定した場合:
ライトトランザクション機能が有効となり,ローカルトランザクションに最適化された環境となります。ただし,グローバルトランザクションは利用できません。
false
(凡例)
-:08-00より前のバージョンを示します。
注※
インプロセストランザクションサービスのステータスファイルには,J2EEサーバの識別情報としてホスト名またはIPアドレスを取り込んでいます。このため,ホスト名またはIPアドレスを変更する場合には,J2EEサーバの停止などの作業が必要です。ステータスファイルの格納ディレクトリに関するホスト名またはIPアドレスの変更は,J2EEサーバの動作設定のカスタマイズ時に実行します。J2EEサーバの動作設定のカスタマイズについては,マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」を参照してください。

(l) ejbserver.DynamicStubLoadingから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.DynamicStubLoading.Enabledダイナミッククラスローディングを使用するかどうかを指定します。
falseを指定した場合:
ダイナミッククラスローディングは機能しません。EJBオブジェクトのスタブ,EJBHomeオブジェクトのスタブ,またはビジネスインタフェースのリファレンスのスタブをダウンロードして,EJBクライアントのユーザクラスパスに指定してください。
trueを指定した場合:
ダイナミッククラスローディングが機能します。EJBオブジェクトのスタブ,EJBHomeオブジェクトのスタブ,またはビジネスインタフェースのリファレンスのスタブをEJBクライアントのユーザクラスパスに指定する必要はありません。
false
(凡例)
-:08-00より前のバージョンを示します。

(m) ejbserver.ejbから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.ejb.cmp20.cmr.use.existing_tableデプロイ時に既存のCMR表を使用するオプションです。通常はデプロイ時にCMR表を生成するので既存のCMR表を使用する必要はありませんが,障害から回復する場合に一時的に指定します。
falseを指定した場合:
デプロイ時にすでにCMR表がある場合はエラーになります。
trueを指定した場合:
デプロイ時にすでにあるCMR表を使用します。
false
ejbserver.ejb.timerservice.maxCallbackThreadsJ2EEサーバ全体で,TimerServiceでのタイムアウトメソッドをコールバックする最大スレッド数を,1~100の整数で指定します。1
ejbserver.ejb.timerservice.retryCountTimerServiceでの,タイムアウトメソッドのコールバックをリトライする最大回数を,0~2147483646の整数で指定します。1
ejbserver.ejb.timerservice.retryIntervalTimerServiceでの,タイムアウトメソッドのコールバックをリトライする間隔を,1~604800の整数(単位:秒)で指定します。5
(凡例)
-:08-00より前のバージョンを示します。

(n) ejbserver.extから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.ext.method_observation.intervalこのプロパティの設定には,次の二つの意味があります。
  • J2EEアプリケーション実行時間監視機能を使用するかどうかを指定します。
  • 動作中のリクエスト処理がタイムアウトしていないかを監視する時間間隔,タイムアウトしたリクエスト(メソッド)をキャンセルする時間間隔として,0~86400の整数(単位:秒)を指定します。
0を指定した場合:
J2EEアプリケーション実行時間監視機能を使用しません。また,タイムアウトを監視しません
0以外の有効値を指定した場合:
J2EEアプリケーション実行時間監視機能を使用します。また,指定された時間間隔で,タイムアウトとメソッドキャンセルを異なるスレッドで実行します。
上記以外の無効な値を指定した場合:
デフォルト値が設定されます。
0
(凡例)
-:08-00より前のバージョンを示します。

(o) ejbserver.httpから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.http.port簡易Webサーバのポート番号を1~65535の整数で指定します。
すでにほかのアプリケーションで使用または確保されているポート番号は指定できません。また,複数のJ2EEサーバでWebサーバとの通信に使用するポートのポート番号に同じ値を設定しないでください。同一のポート番号を指定したJ2EEサーバはcjstartsvコマンドで複数起動できません。
8080
(凡例)
-:08-00より前のバージョンを示します。

(p) ejbserver.instrumentationから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.instrumentation.enabledManagement Serverと連携するかどうかを指定します。
trueを指定した場合:
Management Serverと連携できます。
falseを指定した場合:
Management Serverと連携できません。
true
(q) ejbserver.jcaから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.jca.adapter.tp1.bind_hostTP1インバウンド連携機能の通信(受信および送信)で使用するIPアドレスまたはホスト名を指定します。ただし,ホスト名を指定した場合で,アドレスを解決できないときは,省略値を使用します。システムによって自動選択された有効なローカルアドレス08-50
(r) ejbserver.jdbcから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
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の引数に渡します。
なお,このプロパティは,ベーシックモードでだけ指定できます。
なし
(凡例)
-:08-00より前のバージョンを示します。

(s) ejbserver.jndiから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
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.referenceDataSourceオブジェクトのキャッシング機能を使用するかどうかを指定します。
onを指定した場合:
DataSourceオブジェクトのキャッシング機能が有効になり,検索の要求に対して同じインスタンスが返ります。
offまたは無効な文字列を指定した場合:
通常通りに動作し,検索ごとに異なるインスタンスが返ります。
off
ejbserver.jndi.namingservice.group.<Specify group name>.providerurls各グループに属するネーミングサービスのルート位置をプロバイダURLで指定します。
<Specify group name>には,ejbserver.jndi.namingservice.group.list内に指定したグループ名を指定します。
プロバイダURLは,URLスキーマ"corbaname"を使用して記述します。
指定形式:
<プロバイダURL>[;<プロバイダURL>]*
なし
ejbserver.jndi.namingservice.group.listラウンドロビン検索をする場合に,検索対象になる論理ネーミングサービスのグループを定義します。指定するグループ名は,英数字(A~Z,a~z,0~9)またはアンダースコア(_)で構成される,ejbserver.jndi.namingservice.group.list内で一意に識別できる名前にします。
指定形式:

<Specify group name>[;<Specify group name>]*

なお,*は繰り返しを示します。
なし
ejbserver.jndi.request.timeoutネーミングサービスとの通信タイムアウト時間(単位:秒)を0~86400の整数で指定します。0を指定した場合,またはこのプロパティを指定しない場合,タイムアウトしません。また,86400を超える値を設定した場合,警告メッセージを出力して,タイムアウトしません。0
(凡例)
*:[]部分の繰り返しを示します。
-:08-00より前のバージョンを示します。

(t) ejbserver.jpaから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.jpa.defaultJtaDsNameデフォルトのJTAデータソースの参照を指定します。このプロパティはpersistence.xmlのjta-data-sourceを指定しなかった場合,または空白文字を指定した場合に使用されます。なし08-00
ejbserver.jpa.defaultNonJtaDsNameデフォルトの非JTAデータソースの参照を指定します。このプロパティはpersistence.xmlのnon-jta-data-sourceを指定しなかった場合または空白文字を指定した場合に使用されます。なし08-00
ejbserver.jpa.defaultProviderClassNameデフォルトのJPAプロバイダクラス名を指定するプロパティです。このプロパティは,persistence.xmlのproviderを指定しなかった場合または空白文字が指定した場合に使用されます。com.hitachi.software.jpa.PersistenceProvider08-00
ejbserver.jpa.disableアプリケーションサーバのJPA機能を使用する場合に指定します。
trueを指定した場合:
アプリケーションサーバのJPA機能は無効になります。
falseを指定した場合:
アプリケーションサーバのJPA機能は有効になります。
false08-20
ejbserver.jpa.overrideJtaDsNamepersistence.xmlのjta-data-sourceに指定した値,およびejbserver.jpa.defaultJtaDsNameに指定した値より優先して使用するJTAデータソースの参照を指定します。なし08-00
ejbserver.jpa.overrideNonJtaDsNamepersistence.xmlのnon-jta-data-sourceに指定した値,およびejbserver.jpa.defaultNonJtaDsNameに指定した値より優先して使用する非JTAデータソースの参照を指定します。なし08-00
ejbserver.jpa.overrideProviderpersistence.xmlのproviderに指定した値,およびejbserver.jpa.defaultProviderClassNameに指定した値より優先して使用するJPAプロバイダクラス名を指定します。なし08-00
ejbserver.jpa.emfprop.<property key>JPAプロバイダ独自のプロパティのキーを指定します。すべての永続化ユニットのデプロイ時に,「ejbserver.jpa.emfprop.」プリフィックスを除去したプロパティがJPAプロバイダに渡されます。なし08-00
注※ ejbserver.jpa.disable=trueを指定した場合の注意事項
アプリケーションにpersistence.xmlが含まれる場合,アプリケーションサーバはアプリケーション開始時にpersistence.xmlを読み込まなくなります。また,アプリケーションのリロード機能を利用している場合,persistence.xmlが更新検知の対象ではなくなります。
アプリケーションがアプリケーションサーバの管理する永続化コンテキストまたは永続化ユニットを利用している場合,アプリケーションの開始ができなくなります。

(u) ejbserver.jtaから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.jta.TransactionManager.defaultTimeOutJ2EEサーバ上で開始されるトランザクションのトランザクションタイムアウトのデフォルト値(単位:秒)を次の範囲で指定します。
1.4モードの場合:
1~2147483647
ベーシックモードの場合:
1~2000000
180
ejbserver.jta.TransactionManager.enlist.compatibleMode.enabledJ2EEサーバモードがベーシックモードの場合のトランザクション処理に関する仕様を指定します。
トランザクション中に,複数回データベースコネクションを取得した場合(コネクションシェアリング機能が有効になる条件を満たしているとき):
該当キーの値による動作の違いはありません。トランザクション中に2回目以降に取得したコネクションも,トランザクションに参加して動作します。
トランザクション中に,複数回DBコネクションを取得した場合(コネクションシェアリング機能が有効になる条件を満たしていないとき):
  • trueを指定したとき
    トランザクション中に2回目以降に取得したコネクションは,トランザクションに参加しないで動作します。
  • falseを指定したとき
    トランザクション中に2回目にコネクションを取得した場合に,java.sql.SQLExceptionが発生します。
複数回データベースコネクションを取得したあとで,トランザクションを開始した場合
  • trueを指定したとき
    トランザクション開始前に取得したコネクションは,トランザクションに参加しないで動作します。
  • falseを指定したとき
    トランザクション開始時に,javax.transaction.SystemExceptionが発生します。
true
(凡例)
-:08-00より前のバージョンを示します。

(v) ejbserver.loggerから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.logger.channels.define.<チャネル名>.filenumJ2EEサーバのログファイルの面数を,1~16の整数で指定します。
  • チャネル名がWebAccessLogFileの場合
    16
  • チャネル名がMaintenanceLogFileまたはWebServletLogFileの場合
    4
  • チャネル名が上記以外の場合
    2
ejbserver.logger.channels.define.<チャネル名>.filesizeJ2EEサーバのログファイルのサイズ(単位:バイト)を,4096~2147483647の整数で指定します。
  • チャネル名がWebAccessLogFileの場合
    2097152
  • チャネル名がMaintenanceLogFileの場合
    16777216
  • チャネル名がWebServletLogFileの場合
    4194304
  • チャネル名が上記以外の場合
    1048576
ejbserver.logger.enabled.*J2EEサーバのログレベルを指定します。Error,Warning,Information,Debugのうち,一つまたは複数を指定します。一つだけ指定した場合は,該当するログレベルのログだけが出力されます。複数指定する場合は,レベル名の文字列の間をコンマ(,)で区切ります。通常はデフォルトのまま利用してください。Error
ejbserver.logger.systemlog.enabledJ2EEサーバの起動,停止および異常終了に関するメッセージを,イベントログ(UNIXの場合は,syslog)へログを出力するかどうかを指定します。
trueを指定した場合:
イベントログ(UNIXの場合は,syslog)へログを出力します。
falseを指定した場合:
イベントログ(UNIXの場合は,syslog)へログを出力しません。
true
(凡例)
-:08-00より前のバージョンを示します。
注※
チャネル名称として次に示す名称を設定できます。

資料の取得については,マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守/移行/互換編」を参照してください。


(w) ejbserver.managementから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
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
(凡例)
-:08-00より前のバージョンを示します。

(x) ejbserver.managerから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.manager.agent.Agent.confManagement Serverとの連携に必要な設定をします。なお,この内容はManagement ServerがJ2EEサーバに自動で設定します。Management ServerがJ2EEサーバに自動で設定する内容については,マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」を参照してください。なし
ejbserver.manager.agent.Agent.enabledManagement Serverとの連携に必要な設定をします。なお,この内容はManagement ServerがJ2EEサーバに自動で設定します。Management ServerがJ2EEサーバに自動で設定する内容については,マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」を参照してください。false
ejbserver.manager.agent.JP1EventAgent.confJP1連携に関する設定ファイルのパスを指定します。なし
ejbserver.manager.agent.JP1EventAgent.enabledJP1と連携するかどうかを指定します。false
ejbserver.manager.jp1event.event_server_name使用するJP1/Baseのイベントサービスのイベントサーバ設定ファイル(conf)に指定した,portsパラメタのアドレスと同じ値を指定します。portsパラメタに複数のアドレスを指定している場合は,指定したアドレスのうちのどれか一つを指定します。なお,portsパラメタのアドレスに「0.0.0.0」(デフォルト値)を指定したイベントサービスを使用する場合は,このキーを省略するか,自マシンのホスト名またはlocalhostを指定します。localhost
ejbserver.manager.agent.MEventAgent.confManagementイベント発行用プロパティファイルを絶対パスで指定します。指定がない場合,または指定したファイルが存在しない場合はManagementイベントを発行しません。
Managementイベント発行用プロパティファイルの詳細は,「10.12 Managementイベント発行用プロパティファイル」を参照してください。
なし
ejbserver.manager.agent.MEventAgent.enabledManagementイベント発行機能を有効にするかどうかを指定します。
trueを指定した場合:
Managementイベント発行機能を有効にします。
falseを指定した場合:
Managementイベント発行機能を無効にします。
不正な値が指定された場合は,デフォルト値が設定されます。
false
(凡例)
-:08-00より前のバージョンを示します。

(y) ejbserver.namingから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.naming.exec.argsCORBAネーミングサービスを自動起動モード(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.hostJ2EEサーバがネーミングサービスとして利用するCORBAネーミングサービスが起動しているホスト名称またはIPアドレスを指定します。
ネーミングの切り替え機能を使用する場合,ホスト名称として"localhost"は使用しないでください。CORBAネーミングサービスが起動しているホスト名称またはIPアドレスを指定してください。
CORBAネーミングサービスを自動起動モード(ejbserver.naming.startupMode=automaticまたはinprocess)で使用する場合,デフォルト値("localhost"),またはJ2EEサーバを起動させるホスト名称もしくはIPアドレスを指定してください。
localhost
ejbserver.naming.namerootCORBAネーミングサービスを自動起動モード(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.portJ2EEサーバがネーミングサービスとして利用するCORBAネーミングサービスのポート番号を1~65535の整数で指定します。ポート番号には,すでにほかのアプリケーションで使用されているポート番号は指定できません。ほかのアプリケーションで使用されているポート番号を指定してJ2EEサーバを起動した場合,起動処理が完了しないことがあります。900
ejbserver.naming.protocolJ2EEサーバがネーミングサービスとして利用するCORBAネーミングサービスへのアクセスプロトコルを指定します。現状,corbanameだけサポートしています。ただし,旧バージョンで使用されていたプロトコル(iioplocまたはiiopname)でも動作できます。corbaname
ejbserver.naming.startupModeCORBAネーミングサービスの起動モードを指定します。
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.startupRetryCountejbserver.naming.startupWaitTimeで指定したCORBAネーミングサービスの起動待ち時間経過後,CORBAネーミングサービスがまだ起動していない場合に,ejbserver.naming.startupWaitTimeで指定された秒数だけ起動待ちを繰り返す回数を0~2147483647の整数で指定します。
0が指定された場合はCORBAネーミングサービス起動状態チェック処理のリトライをしません。
なお,ejbserver.naming.startupWaitTimeに0が指定されている場合は,このプロパティ値は無効です。
  • 06-00以降での新規インストールの場合:
    9
  • バージョンアップの場合:
    0
ejbserver.naming.startupWaitTimeJ2EEサーバ起動時にCORBAネーミングサービスが利用可能になるまで待つ時間(単位:秒)を0~2147483647の整数で指定します。0を指定した場合は,CORBAネーミングサービスの起動待ちをしません。
ejbserver.naming.startupModeにinprocessを設定している場合には,0を指定しないでください。
  • 06-00以降での新規インストールの場合:
    1
  • バージョンアップの場合
    manualモードで使用していた場合には0が設定されます。
    automaticモードを使用し,このプロパティ値を設定していた場合は,既存の指定値がデフォルト値となります。省略していた場合10となります。
(凡例)
-:08-00より前のバージョンを示します。
注※
Management Serverを利用してJ2EEサーバを起動する場合,automatic以外を指定してください。automaticを指定した場合,CORBA Naming ServiceプロセスがTPBroker運用支援機能のプロセス監視対象外となり,プロセスがダウンしても再起動されなくなります。

(z) ejbserver.rmiから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.rmi.localinvocation.scopeローカル呼び出し最適化機能の適用範囲を指定します。
noneを指定した場合:
適用範囲はありません。バージョンアップインストール時は互換性のため,これが指定されます。
appを指定した場合:
同一アプリケーション内が適用範囲になります。
allを指定した場合:
同一J2EEサーバ内が適用範囲になります。
app
ejbserver.rmi.naming.hostマルチホームドホスト環境で,J2EEサーバが使用するRMIレジストリやMBeanサーバのホスト名称,またはIPアドレスを指定します。指定した半角英文字の大文字,小文字の区別はしません。なし
ejbserver.rmi.naming.portJ2EEサーバが利用するRMIレジストリのポート番号を,1~65535の整数で指定します。ポート番号には,すでにほかのアプリケーションで使用されているポート番号は指定できません。ほかのアプリケーションで使用されているポート番号を指定してJ2EEサーバを起動した場合,起動処理が完了しないことがあります。23152
ejbserver.rmi.passbyreferencetrueを指定した場合,リモートインタフェースを持つ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.enabledStateless Session Beanのremoveメソッドの呼び出しに対して,呼び出しを不要とするか,必要とするかを指定します。
trueを指定した場合:
Stateless Session BeanのEJBObjectに対してremoveメソッドの呼び出しを不要とします。
removeメソッドの呼び出し後にビジネスメソッドを呼び出した場合には,java.rmi.NoSuchObjectException例外は発生しないで,ビジネスメソッドが実行されます。
falseを指定した場合:
Stateless Session BeanのEJBObjectに対してremoveメソッドの呼び出しを必要とします。
removeメソッドの呼び出し後にビジネスメソッドを呼び出した場合には,java.rmi.NoSuchObjectException例外が発生します。
false
(凡例)
-:08-00より前のバージョンを示します。
注※
サーバ管理コマンドからEJB単位での参照渡し(Pass-by-reference)の設定をすることもできます。

(aa) ejbserver.serverから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.server.eheap.ajp13.enabledリダイレクタとの通信用オブジェクトをExplicitヒープに配置するかどうかを指定します。
trueを指定した場合:
リダイレクタとの通信用オブジェクトをExplicitヒープに配置します。
falseを指定した場合:
リダイレクタとの通信用オブジェクトをJavaヒープ領域に配置します。
ただし,日立JavaVMオプションHitachiUseExplicitMemoryを無効にした場合,このプロパティは無効(false指定時と同じ挙動)となります。
true08-00
ejbserver.server.eheap.httpsession.enabledHTTPセッションに格納するオブジェクトをExplicitヒープに配置するかどうかを指定します。
trueを指定した場合:
HTTPセッションに格納するオブジェクトをExplicitヒープに配置します。
falseを指定した場合:
HTTPセッションに格納するオブジェクトをJavaヒープ領域に配置します。
ただし,日立JavaVMオプションHitachiUseExplicitMemoryを無効にした場合は,このプロパティは無効(false指定時と同じ挙動)となります。
true08-00
ejbserver.server.j2ee.featureComponent 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.PRFIDPRF識別子を指定します。
PRFデーモン起動時にPRF識別子を指定した場合に,同じPRF識別子を指定します。
PRFデーモン起動時にPRF識別子を省略した場合は,指定しないでください。PRF識別子が一致しないと,性能解析トレースが取得されません。
PRF_ID
ejbserver.server.threaddump.filenumJ2EEサーバが障害を検知して自発的にスレッドダンプを出力する場合のスレッドダンプのファイル数の上限を,1~2147483647の整数で指定します。
範囲外の値を指定した場合は,デフォルト値が設定されます。
また,次に示す外部からのスレッドダンプ出力要求に対しては,このオプションの設定に関係なくスレッドダンプのファイルが出力されます。
  • cjdumpsvコマンド
  • cjstopsvコマンドの-fd指定
  • J2EEサーバ実行コンソールでのCtrl+Break(Windowsの場合)
  • J2EEサーバプロセスへのkillコマンド -3(SIGTERM)指定(UNIXの場合)
256
(凡例)
-:08-00より前のバージョンを示します。

(ab) ejbserver.statefulから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.stateful.passivate.switchStateful Session Beanの非活性化,活性化の機能を使用するかどうかを指定します。
trueを指定した場合:
Stateful Session Beanの非活性化,活性化の機能が動作します。
falseを指定した場合:
Stateful Session Beanの非活性化,活性化の機能が動作しません。
false
(凡例)
-:08-00より前のバージョンを示します。

(ac) ejbserver.stdoutlogから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.stdoutlog.autoflushユーザ出力ログおよびユーザエラーログの自動フラッシュ機能を有効にするかどうかを指定します。
trueを指定した場合:
自動フラッシュ機能を有効にします。
falseを指定した場合:
自動フラッシュ機能を無効にします。
false08-00
(凡例)
-:08-00より前のバージョンを示します。

(ad) ejbserver.watchから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
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
ejbserver.watch.enabledすべてのリソース枯渇監視を有効にするかどうかを指定します。
trueを指定した場合:
すべてのリソース枯渇監視を有効にします。
falseを指定した場合:
すべてのリソース枯渇監視を無効にします。この場合,各リソース枯渇監視が有効に設定されていても,すべてのリソース枯渇監視が無効になります。
true(06-00以前からのバージョンアップの場合は,false)
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.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.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
(凡例)
-:08-00より前のバージョンを示します。

(ae) ejbserver.webj2eeから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
ejbserver.webj2ee.connectionAutoClose.enabledJ2EEサーバの動作モードが1.4モードの場合に,自動クローズ機能を使用するかどうかを指定します。動作モードがベーシックモードの場合,このプロパティは無視され,自動クローズ機能は無効となります。
trueを指定した場合:
自動クローズ機能を有効にします。
falseを指定した場合:
自動クローズ機能を無効にします。
不正な値を指定した場合は,デフォルト値が設定されます。
true
(凡例)
-:08-00より前のバージョンを示します。

(af) javaから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
java.naming.factory.initialJNDIのInitialContextがデレゲートするコンテキストの実装クラスのファクトリクラスを指定します。各設定値での動作を次に示します。
com.hitachi.software.ejb.jndi.InsContextFactory :
JNDIラウンドロビン検索機能を使用しないで,通常の検索機能を使用する場合に指定するコンテキストです。
com.hitachi.software.ejb.jndi.GroupContextFactory :
J2EEサーバ内アプリケーション(EJB)の実行時に,JNDIラウンドロビン検索機能を使用する場合に指定するコンテキストです。
com.hitachi.software.ejb.jndi.InsContextFactory
(凡例)
-:08-00より前のバージョンを示します。

(ag) vbjから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
vbj.java2iiop.jvm.maxHeapSizeJ2EEアプリケーション開始時に起動されるjava2iiopコマンドのヒープサイズの最大値を指定します。
指定する値は,javaコマンドの-Xmx,-Xmsオプションが受け付ける形式で指定してください。それ以外の形式で指定された場合の動作は保証されません。
次のように指定してください。
  • 2048~4294966272の値を指定してください。ただし,vbj.java2iiop.jvm.minHeapSizeに指定した以上の値を指定してください。
  • キロバイト単位で指定する場合は,文字「k」または「K」を付けて指定してください。
  • メガバイト単位で指定する場合は,文字「m」または「M」を付けて指定してください。
128m
vbj.java2iiop.jvm.minHeapSizeJ2EEアプリケーション開始時に起動されるjava2iiopコマンドのヒープサイズの初期値を指定します。
指定する値は,javaコマンドの-Xmx,-Xmsオプションが受け付ける形式で指定してください。それ以外の形式で指定された場合の動作は保証されません。
次のように指定してください。
  • 1024~-Xmx指定値の値を指定してください。
  • キロバイト単位で指定する場合は文字「k」または「K」を付けて指定してください。
  • メガバイト単位で指定する場合は,文字「m」または「M」を付けて指定してください。
16m
(凡例)
-:08-00より前のバージョンを示します。

(ah) vbrokerから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
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.entryCountCosminexus TPBroker通信トレースファイル1個当たりのエントリ数の上限値を100~30000000の範囲で指定します。120000
vbroker.orb.htc.comt.fileCountCosminexus TPBroker通信トレースファイルの個数の上限値を1~256の範囲で指定します。3
vbroker.orb.htc.tracePathCosminexus 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
(凡例)
-:08-00より前のバージョンを示します。

(ai) webserver.applicationから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
webserver.application.lower_versionWebアプリケーションのバージョン設定機能で設定したいWebアプリケーションのバージョンを指定します。
2.4を指定した場合は,web.xmlで定義されたWebアプリケーションバージョンが2.4以下のWebアプリケーションをバージョン2.4のWebアプリケーションとして実行します。
2.5を指定した場合は,web.xmlで定義されたWebアプリケーションバージョンが2.5以下のWebアプリケーションをバージョン2.5のWebアプリケーションとして実行します。
なし08-20
(aj) webserver.connectorから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
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_hostWebサーバ連携で使用するIPアドレスまたはホスト名称を指定します。
IPアドレス,またはホスト名称の前後の半角スペースは無視されます。値を指定しない場合は,ワイルドカードアドレスが使用されます。
このプロパティを指定するときは,ワーカホスト名称にもローカルホスト名称またはIPアドレスを指定する必要があります。
同一ホストで実行しているWebサーバとWebサーバ連携をしている構成の場合に,このプロパティにローカルホスト名称,またはIPアドレスを指定し,リダイレクタのワーカホスト名称にlocalhostなどのループバックアドレスを指定したとき,WebコンテナはWebサーバからのリクエストを受信できません。
なし
webserver.connector.ajp13.max_threadsWebコンテナがリクエストを処理する同時実行数を指定します。※1
1~1024の整数で指定します。
指定されたリクエストの同時実行数分のスレッドがサーバ起動時に生成されます。
10
webserver.connector.ajp13.portWebサーバとの通信に使用するポート番号を指定します。
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.backlogWebクライアントからの接続要求を格納する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を絶対パスで指定します。
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_headersHTTPリクエストに含まれるHTTPヘッダの個数の上限を0~32767の整数で指定します。上限値を設定しない場合は,0を指定してください。
このプロパティで指定したHTTPヘッダの個数に満たない場合でも,webserver.connector.inprocess_http.limit.max_request_headerで指定したサイズを超えた場合はエラーとなります。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
100
webserver.connector.inprocess_http.limit.max_request_bodyHTTPリクエストのリクエストボディの最大サイズ(単位:バイト)を-1~2147483647の整数で指定します。上限値を設定しない場合は,-1を指定してください。また,リクエストボディがチャンク形式で送信された場合,チャンクヘッダのサイズも指定するサイズに含める必要があります。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
-1
webserver.connector.inprocess_http.limit.max_request_headerHTTPリクエストのリクエストヘッダの最大サイズ(単位:バイト)を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_connectionsWebクライアントとの最大接続数を1~1024の整数で指定します。有効な最大値は実行するOSによって異なります。
このパラメタに指定した値がリクエスト処理スレッドの最大値になります。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
100
webserver.connector.inprocess_http.max_execute_threadsWebコンテナがリクエストを処理する同時実行数を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_connectionsPersistent 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_requestsPersistent ConnectionによるTCPコネクションを持続したままの連続接続回数の上限を0~2147483647の整数で指定します。上限値を設定しない場合は,0を指定してください。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
100
webserver.connector.inprocess_http.persistent_connection.timeoutPersistent ConnectionでTCPコネクションを持続した状態での,リクエスト待ち時間(単位:秒)を0~3600の整数で指定します。0を指定した場合,タイムアウトしません。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
3
webserver.connector.inprocess_http.portインプロセスHTTPサーバが使用するポート番号を1~65535の整数で指定します。すでにほかのアプリケーションで使用されているポート番号は指定できません。ほかのアプリケーションで使用されているポート番号や確保されているポート番号を指定した場合,メッセージが出力され,J2EEサーバが起動されません。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
80
webserver.connector.inprocess_http.receive_timeoutWebクライアントからのリクエスト受信で,タイムアウトするまでの時間(単位:秒)を0~3600の整数で指定します。0を指定した場合,タイムアウトしません。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
300
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.redirect.listリダイレクト機能で使用するリダイレクト定義名を指定します。
このプロパティに指定できる値の最大長は1024文字です。リダイレクト定義名は,英数字(A~Z,a~z,0~9)またはアンダースコア(_)で構成される文字列で指定します。また,リダイレクト定義名一つの文字列長は1文字~32文字です。
リダイレクト定義名を複数指定する場合は,コンマ(,)で区切ります。コンマの前後の空白文字※2は無視されます。同じリダイレクト定義名は複数回指定できません。
不正な値を指定した場合は,メッセージが出力され,すべてのリダイレクト定義は無効となります。
なし
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_timeoutWebクライアントへのレスポンス送信で,タイムアウトするまでの時間(単位:秒)を0~3600の整数で指定します。0を指定した場合,タイムアウトは有効になりません。
数値以外の文字列や範囲外の数値,空文字列または空白文字※2を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
300
webserver.connector.limit.max_post_form_dataPOSTリクエストのフォームデータの最大サイズを,-1~2147483647の整数(単位:バイト)で指定します。POSTリクエストのフォームデータとは,Content-Typeヘッダの値がapplication/x-www-form-urlencodedの場合を指します。最大サイズを設定しない場合は,-1を指定します。
次の数値または文字列を指定した場合,メッセージが出力され,デフォルト値が適用されます。
  • 数値以外の文字列
  • 指定範囲外の数値
  • 空文字列または空白文字
リクエストのContent-Lengthヘッダの値が,指定した最大サイズを超える場合,ステータスコード413(Request Entity Too Large)エラーが返却され,メッセージKDJE39336-Eが出力されます。
209715208-50
webserver.connector.redirect_https.portWebサーバが使用しているHTTPSのポート番号を指定します。
1~65535の整数で指定します。
指定しない場合,HTTPSポートにリダイレクトしません。
すでにほかのアプリケーションで使用または確保されているポート番号は指定できません。また,複数のJ2EEサーバでWebサーバとの通信に使用するポートのポート番号に同じ値を設定しないでください。同一のポート番号を指定したJ2EEサーバはcjstartsvコマンドで複数起動できません。
なし
(凡例)
-:08-00より前のバージョンを示します。

注※1
  • 有効な最大値は実行するプラットフォームに依存します。
  • Webサーバに到着するリクエストの一部がWebコンテナに転送されるため,Webサーバの最大同時接続数は,URLグループ単位,Webアプリケーション単位およびデフォルトの実行待ちキューサイズの総和+Webコンテナ単位の最大同時実行スレッド数より大きく設定する必要があります。
    また,データベース操作をするサーブレットやJSPについては,データベースコネクションの数よりも多くの多重度は得られないため,Webコンテナの同時実行数を増やす場合は,利用できるデータベースコネクションの数も増やす必要があります。
    性能のチューニング時には,次に示す関係を常に考慮して,各パラメタの値を調整してください。
    <Webサーバの最大同時接続数> > <URLグループ単位,Webアプリケーション単位およびデフォルトの実行待ちキューサイズの総和>+<Webコンテナ単位の最大同時実行スレッド数>
    <Webコンテナ単位の最大同時実行スレッド数> ≧ <データベースコネクションの数>
    Webコンテナでの同時実行スレッド数の制御については,マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」を参照してください。
    Webサーバでの処理の同時接続数についてはWebサーバのマニュアルを参照してください。
注※2
空白文字とは,半角スペース,タブ,LF(0x0a),CR(0x0d)またはFF(0x0c)のことを指します。
(ak) webserver.containerから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
webserver.container.ac.logEnabledWebコンテナの保守用のトレースログを出力するかどうかを指定します。
trueを指定した場合:
トレースログを出力します。
falseを指定した場合:
トレースログを出力しません。
false
webserver.container.jaxws.webservice.no_webxml.enabledWebサービスのクライアントからSOAP要求メッセージが到着した際,WARファイルにweb.xmlが完全に,または部分的に含まれていなくても,Cosminexus JAX-WSを利用して開発したWebサービス実装クラスまたはプロバイダ実装クラスが含まれていれば,SOAP要求メッセージを受け付けて,Webサービス実装クラスに振り分けるかどうか指定します。
strictまたはtrueを指定した場合:
WARファイルにweb.xmlが含まれない場合,@javax.jws.WebServiceアノテーション,または@javax.xml.ws.WebServiceProviderアノテーションの情報に基づき,SOAP要求メッセージをWebサービス実装クラス,またはプロバイダ実装クラスに振り分けます。
laxを指定した場合:
WARファイルにweb.xmlが完全に,または部分的に含まれない場合,@javax.jws.WebServiceアノテーション,または@javax.xml.ws.WebServiceProviderアノテーションの情報に基づき,SOAP要求メッセージをWebサービス実装クラス,またはプロバイダ実装クラスに振り分けます。
noneまたはfalseを指定した場合:
WARファイルにweb.xmlが含まれない場合,SOAP要求メッセージをWebサービス実装クラスに振り分けません。
意図しないクラスが誤ってURLと関連づけられ,ユーザが外部からアクセス可能な状態になることを防ぐため,デフォルトはnone(false)に設定されています。
none08-00
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.servlet.default_mapping.enabledサーブレットのデフォルトマッピングを有効にするかどうかを指定します。
trueを指定した場合:
有効になります。
falseを指定した場合:
無効になります。
false08-00
webserver.container.thread_control.enabledWebアプリケーション単位の同時実行スレッド数の制御機能を使用するかどうかを指定します。J2EEサーバモードでだけ有効です。
trueを指定した場合:
Webアプリケーション単位の同時実行スレッド数の制御機能を有効にします。
falseを指定した場合:
Webアプリケーション単位の同時実行スレッド数の制御機能を無効にします。
true
webserver.container.thread_control.queue_sizeWebアプリケーション単位の同時実行スレッド数の制御機能を使用する場合に,デフォルトの実行待ちキューサイズを0~2147483647の整数で指定します。J2EEサーバモードでだけ有効です。8192
(凡例)
-:08-00より前のバージョンを示します。
注※
空白文字とは,半角スペース,タブ,LF(0x0a),CR(0x0d)またはFF(0x0c)のことを指します。

(al) webserver.contextから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

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

(am) webserver.dbsfoから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
webserver.dbsfo.attribute_data_size.maxグローバルセッション情報に含めることができるHTTPセッションの属性情報の最大サイズをバイト単位で設定します。102408-00
webserver.dbsfo.check_size.modeHTTPセッションの属性情報のサイズ見積もり機能を有効にするかどうかを指定します。
onを設定した場合:
HTTPセッションの属性情報のサイズ見積もり機能が有効となります。
offを設定した場合:
HTTPセッションの属性情報のサイズ見積もり機能が無効となります。
off08-00
webserver.dbsfo.connector.nameデータベースセッションフェイルオーバ機能で使用するDB Connectorの別名を設定します。COSMINEXUS_SFO_DBCONNECTOR08-00
webserver.dbsfo.enabledデータベースセッションフェイルオーバ機能を有効にするかどうかを指定します。
trueを設定した場合:
J2EEサーバ上のすべてのWebアプリケーションでデータベースセッションフェイルオーバ機能が有効となります。
falseを指定した場合:
データベースセッションフェイルオーバ機能が無効となります。
false08-00
webserver.dbsfo.exclude.extensionsデータベースセッションフェイルオーバ機能を抑止する拡張子を指定します。
URLのパスが指定した拡張子と合致した場合,該当するリクエストでデータベースセッションフェイルオーバ機能は無効となります。指定した拡張子とURLの比較では大文字,小文字の区別はしません。
また,データベースセッションフェイルオーバ機能を抑止する拡張子を設定しない場合,空文字列,またはコンマ「,」を指定します。
txt,htm,html,jpg,gif,js08-00
webserver.dbsfo.exclude.urisデータベースセッションフェイルオーバ機能を抑止するURIを指定します。リクエストURIのパスが指定したURIと一致した場合,該当するリクエストはデータベースセッションフェイルオーバ機能が無効となります。
指定したURIとリクエストURIの比較では大文字,小文字が区別されます。
データベースセッションフェイルオーバ機能を抑止するURIを設定しない場合,空文字列を設定します。
なし08-50
(an) webserver.errorpageから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
webserver.errorpage.stack_trace.enabled例外発生時,デフォルトのエラーページにスタックトレースを出力するかどうかを指定します。
trueを指定した場合:
スタックトレースを出力します。
falseを指定した場合:
スタックトレースを出力しません。
trueまたはfalse以外の文字列を指定した場合,空文字列または空白文字を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
false
(凡例)
-:08-00より前のバージョンを示します。
注※
空白文字とは,半角スペース,タブ,LF(0x0a),CR(0x0d)またはFF(0x0c)のことを指します。

(ao) webserver.httpから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
webserver.http.request.encodingリクエストボディおよびクエリのデコードに使用する文字エンコーディングを指定します。
デフォルトの文字エンコーディングとして設定できる文字は,JavaVMがサポートしている文字エンコーディングとなります。JavaVMがサポートしている文字エンコーディングについては,JDKのドキュメントのサポートされているエンコーディングに関する説明を参照してください。また,指定できる文字列は,java.nio API用の正準名とjava.lang API用の正準名に記載されている文字エンコーディング,およびそれらの別名になります。
なし
webserver.http.request.uri_decode.enabledサーブレットパス,追加のパス情報をデコードするかどうかを指定します。
trueを指定した場合:
デコードします。
falseを指定した場合:
デコードしません。
false08-00
webserver.http.response.encodingレスポンスボディのエンコードに使用する文字エンコーディングを指定します。
デフォルトの文字エンコーディングとして設定できる文字は,JavaVMがサポートしている文字エンコーディングとなります。JavaVMがサポートしている文字エンコーディングについては,JDKのドキュメントのサポートされているエンコーディングに関する説明を参照してください。また,指定できる文字列は,java.nio API用の正準名とjava.lang API用の正準名に記載されている文字エンコーディング,およびそれらの別名になります。
なし
(凡例)
-:08-00より前のバージョンを示します。

(ap) webserver.jspから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
webserver.jsp.check_intervalJSPの更新検知インターバルを0~2147483647の範囲(単位:秒)の整数で指定します。
0を指定した場合,更新の自動検知は行われません。
JSPのリロード機能が無効の場合,このプロパティは設定できません。設定した場合無視されます。
数値以外の文字列,範囲外の数値または空文字列を指定した場合はメッセージを出力し,デフォルト値が設定されます。
ejbserver.deploy.context.check_intervalに設定した値(デフォルト値:0)
webserver.jsp.compile.backcompatJSPから生成されたサーブレットのjavaソースのコンパイル時に,javaソースコードのバージョンを指定します。このプロパティは,旧バージョンで生成されたJSP内のスクリプティングでJavaコードをJSP内に記述しているため,Cosminexusが提供するJavaVMのバージョンではコンパイルできない場合に指定します。Java VMのバージョンに依存しない場合,このプロパティを省略するか,falseを指定します。
指定できる値を次に示します。
1.5または5:
JavaSE 5.0に依存したソースコードを,JSPファイルのスクリプティングに記述している場合に指定します。
1.4:
J2SE 5.0ではエラーとなるJ2SE 1.4に依存したソースコードをJSPファイルのスクリプティングに記述している場合に指定します。
1.3:
J2SE 5.0ではエラーとなるJ2SE 1.3に依存したソースコードをJSPファイルのスクリプティングに記述している場合に指定します。
1.2:
J2SE 5.0ではエラーとなるJ2SE 1.2に依存したソースコードをJSPファイルのスクリプティングに記述している場合に,指定します。
true:
J2SE 5.0ではエラーとなるJ2SE 1.2に依存したソースコードをJSPファイルのスクリプティングに記述している場合に,指定します。
false:
JSPファイル内にスクリプティングを記述していない場合,スクリプティングを記述している場合でもJ2SEのバージョンに依存しない場合に指定します。
指定可能なパラメタ値以外の文字列,空文字列または空白文字を指定した場合は,メッセージが出力され,デフォルト値が設定されます。
false
webserver.jsp.precompile.jsp_work_dirJSP事前コンパイル機能によって生成されたJSPファイルのコンパイル結果の格納先ディレクトリ名を指定します。
ディレクトリ名は,半角の英数字(A~Z,a~z,0~9)またはアンダースコア(_)で構成される文字列で指定します。
不正な値を指定した場合は,メッセージが出力され,デフォルト値が設定されます。また,予約語である次の文字列を指定した場合は,メッセージが出力され,デフォルト値を使用します。
  • classes
  • lib
  • tags
cosminexus_jsp_work
webserver.jsp.keepgeneratedJSPファイル,またはタグファイルのコンパイルで生成されたjavaファイルを保持するかどうかを指定します。
次の値を指定します。
trueを指定した場合:
javaファイルを保持します。
falseを指定した場合:
javaファイルを保持しません。
false
webserver.jsp.pageEncodingJSPの文字エンコーディングを指定します。デフォルトの文字エンコーディングとして設定できる文字は,JavaVMがサポートしている文字エンコーディングとなります。JavaVMがサポートしている文字エンコーディングについては,JDKのドキュメントのサポートされているエンコーディングに関する説明を参照してください。また,指定できる文字列は,java.nio API用の正準名とjava.lang API用の正準名に記載されている文字エンコーディング,およびそれらの別名になります。なし
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.tag.noCheckRtexprvalueExpressionが指定できないタグの属性値にExpressionが指定されているかどうか検証するかどうかを指定します。
true:
Expressionが指定されているかどうかを検証します。
false
Expressionが指定されているかどうかを検証しません。
false
webserver.jsp.translation.backcompat.tag.rtexprvalueTerminateタグの属性値が,「"<%=」または「'<%=」で開始しており,「%>"」(「'<%」で開始した場合は「%>'」)で終了していない属性値の「"」(または「'」)で囲まれた値を文字列として扱うかどうかを指定します。
true:
「"」までを文字列として扱います。
false:
「%>"」までを属性値とします。
false
webserver.jsp.translation.backcompat.taglib.noCheckPrefixtaglibディレクティブの前に,taglibディレクティブで指定したprefixを使用したカスタムタグを記述しているかチェックするかどうかを指定します。
true:
チェックしない。
false:
チェックする。
false
webserver.jsp.translation.backcompat.useBean.noCheckClassJSPトランスレーション時に<jsp:useBean>タグのクラス属性値のチェック処理を実行するかどうかを指定します。
true:
クラス属性値をチェックしません。
false:
クラス属性値をチェックします。
false
webserver.jsp.update.intervalJSPのリロード監視対象ファイルのコピーに必要な時間のインターバルを0~2147483647の範囲(単位:秒)の整数で指定します。なお,インターバルは余裕のある値にしてください。JSPファイルの更新を検知してから指定したインターバルのあとに,JSPのリロードが実行されます。
JSPのリロード機能が無効の場合,このプロパティは設定できません。設定した場合無視されます。
数値以外の文字列,範囲外の数値または空文字列を指定した場合はメッセージを出力し,デフォルト値が設定されます。
ejbserver.deploy.context.update.intervalに設定した値(デフォルト値:0)
webserver.jsp.translation.customAction.ignoreCaseAttributeNameカスタムタグで指定された属性が,TLDファイルもしくはタグファイルで定義されているかどうかをチェックする際に,大文字小文字を区別するかどうかを指定します。
trueを指定した場合:
大文字小文字を区別しません。
falseを指定した場合:
大文字小文字を区別します。
false08-00
webserver.jsp.translation.useBean.noCheckDuplicateId<jsp:useBean>タグのid属性値が重複しているかどうかをチェックします。trueの場合,id属性値が重複してもトランスレーションエラーは発生しません。falseの場合,id属性値が重複している時にトランスレーションエラーが発生します。false08-00
webserver.jsp.tld.mapping.java_ee_tag_library.enabledServlet2.5仕様以降のWebアプリケーションで,Java EE仕様に含まれるタグライブラリ(JSTL,JSF)のTLDとURLのマッピングを自動的に実行するかどうかを指定します。
trueを指定した場合:
自動的にマッピングします。
falseを指定した場合:
自動的にマッピングしません。
true08-00
webserver.jsp.jsp_page.bom.enabledServlet2.5仕様以降のWebアプリケーションのJSPページで,BOMによる文字エンコーディングの指定を有効にするかどうかを指定します。
trueを指定した場合:
BOMによる文字エンコーディングの指定が有効になります。
falseを指定した場合:
BOMによる文字エンコーディングの指定が無効になります。
true08-00
webserver.jsp.debugging.enabledJSPデバッグ機能を有効にするかどうかを指定します。なお,このプロパティはJ2EEサーバモードにだけ有効です。
trueを設定した場合:
JSPデバッグ機能が有効となりJSPファイルから作成されたサーブレットのclassファイルにSMAPを埋め込みます。
falseを指定した場合:
JSPデバッグ機能が無効になります。
false08-00
(凡例)
-:08-00より前のバージョンを示します。
注※
空白文字とは,半角スペース,タブ,LF(0x0a),CR(0x0d)またはFF(0x0c)のことを指します。

(aq) webserver.loggerから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
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
(凡例)
-:08-00より前のバージョンを示します。
注※1
空白文字とは,半角スペース,タブ,LF(0x0a),CR(0x0d)またはFF(0x0c)のことを指します。
注※2
指定できるフォーマット引数と出力例を次の表に示します。

フォーマット引数出力内容出力例
%%% 記号。%
%aWebクライアントのIPアドレス。10.20.30.40
%AJ2EEサーバのIPアドレス。10.20.30.100
%bHTTPヘッダを除く送信バイト数。0バイトのときは「-」となります。2048
%BHTTPヘッダを除く送信バイト数。0バイトのときは「0」となります。1024
%hWebクライアントのホスト名またはIPアドレス。ホスト名が得られない場合はIPアドレスとなります。10.20.30.40
%Hリクエストプロトコル。HTTP/1.1
%lリモートログ名(RFC 1413で規定されているIdentificationプロトコルによって得られるWebクライアント側のユーザ名)。-
%mリクエストメソッド。GET
%pWebクライアントからのリクエストを受け付けたポート番号。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
%tWebクライアントのリクエストに応答した時刻[dd/MMM/YYYY:HH:mm:ss Z]。[18/Jan/2005:13:06:10 +0900]
%TWebクライアントのリクエストの処理に要した時間(単位:秒)。2
%dWebクライアントのリクエストに応答した時刻。次の形式で表示します。[dd/MMM/YYYY:HH:mm:ss.nnn Z](nnnはミリ秒)[18/Jan/2005:13:06:10.152 +0900]
%DWebクライアントのリクエストの処理に要した時間(単位:ミリ秒)。2000
%uベーシック認証ユーザ名,またはフォーム認証ユーザ名。認証ユーザ名がない場合は「-」となります。user
%Uリクエストファイルパス。/index.html
%vJ2EEサーバのローカルホスト名。server
%{foo}iリクエストヘッダfooの内容。fooヘッダが存在しない場合は「-」になります。
一度のHTTPリクエストまたはHTTPレスポンスで同じヘッダ名が複数回送信された場合,最初に読み込んだヘッダの内容を出力します。
%{Host}iの場合
www.example.com:8888
%{foo}cWebクライアントが送信したCookie情報でCookieの名前がfooの内容。Cookieの名前にfooがない場合は「-」になります。%{JSESSIONID}cの場合
00455AFE4DA4E7B7789F247B8FE5D605
%{foo}oレスポンスヘッダfooの内容。fooヘッダが存在しない場合は「-」になります。
一度のHTTPリクエストまたはHTTPレスポンスで同じヘッダ名が複数回送信された場合,最初に読み込んだヘッダの内容を出力します。
%{Server}oの場合
CosminexusComponentContainer
注※3
ファイル名の末尾に<連番>.logが追加されます。

(ar) webserver.servletから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
webserver.servlet_api.exception.getCause.backcompatjavax.servlet.ServletExceptionのコンストラクタServletException(String, Throwable)およびServletException(Throwable)で指定した根本原因の例外をgetCause()により取得できないようにします。
同様にjavax.servlet.jsp.JspExceptionのコンストラクタJspException(String, Throwable)およびJspException(Throwable)で指定した根本原因の例外をgetCause()により取得できないようにします。
trueを設定した場合:
根本原因の例外を取得できません。
falseを設定した場合:
根本原因の例外を取得できます。
false08-00
(as) webserver.sessionから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
webserver.session.max.log_intervalHttpSession数の上限値を超えてHttpSessionオブジェクトを生成しようとした場合に出力されるメッセージKDJE39225-Eのインターバルを,0~2147483647の整数(単位:秒)で指定します。
メッセージKDJE39225-Eが出力されてからこのプロパティで指定したインターバルの間,メッセージKDJE39225-Eの出力を抑止します。0を指定した場合,メッセージ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サーバが使用するポート番号から生成する文字列
webserver.session.delete_cookie.backcompatHTTPセッションを無効にした場合,Webクライアントが保持するセッションIDを示すHTTP Cookieを削除するかどうかを設定します。
trueを指定した場合:
HTTPセッションを無効化した場合,Webクライアントが保持するセッションIDを示すHTTP Cookieを削除しません。
falseを指定した場合:
HTTPセッションを無効化した場合,HTTPレスポンスのヘッダにWebクライアントが保持するセッションIDを示すHTTP Cookieを削除するためのHTTP Cookieを付加します。
false08-00
webserver.session.max.throwHttpSessionLimitExceededExceptionHTTPセッションオブジェクト数が上限値を超えた時に,com.hitachi.software.web.session.HttpSessionLimitExceededException例外をスローするかどうかを指定します。
trueを指定した場合:
java.lang.IllegalStateException例外の派生クラスであるcom.hitachi.software.web.session.HttpSessionLimitExceededException例外をスローします。
falseを指定した場合:
java.lang.IllegalStateException例外をスローします。
false08-00
(凡例)
-:08-00より前のバージョンを示します。
注※
空白文字とは,半角スペース,タブ,LF(0x0a),CR(0x0d)またはFF(0x0c)のことを指します。

(at) webserver.sfoから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
webserver.sfo.negotiation.ignore_serverIdネゴシエーションで,J2EEサーバに設定されたHttpSessionのセッションIDに付加するサーバIDが,すでに接続済みのJ2EEサーバの設定と一致した場合に,エラーとするかどうかを指定します。
trueを指定した場合:
エラーとします。
falseを指定した場合:
エラーとしません。
false
webserver.sfo.check_size.modeグローバルセッション情報のサイズ見積もり機能を有効にするかどうかを指定します。
onを指定した場合:
グローバルセッション情報のサイズ見積もり機能が有効になります。
offを指定した場合
グローバルセッション情報のサイズ見積もり機能が無効になります。
off
webserver.sfo.sfo_server.<SFOサーバ名>.connectionTimeoutJ2EEサーバからSFOサーバに通信した際のタイムアウト時間を,1~3600の整数(単位:秒)で指定します。30
webserver.sfo.sfo_server.<SFOサーバ名>.naming<SFOサーバ名>が指すSFOサーバのインプロセスで起動したCORBAネーミングサービスのIPアドレスまたはホスト名,およびポート番号を指定します。
IPアドレスは10進表記で,ポート番号は1~65535の整数で指定します。区切り文字には半角コロン(:)を使用します。
指定形式:
<IPアドレス>:<ポート番号>
<ホスト名>:<ポート番号>
webserver.sfo.sfo_serversキーで指定した,すべてのSFOサーバについて設定が必要です。設定されていないSFOサーバが存在した場合,セッションフェイルオーバを使用するアプリケーションは開始できません。
なし
webserver.sfo.sfo_serversJ2EEサーバ上のWebアプリケーションが使用する,すべてのSFOサーバ名を指定します。1024文字までの文字列が指定できます。半角英数字(A~Z,a~z,0~9)またはアンダースコア(_)が使用できます。
SFOサーバを複数指定する場合は,半角コンマ(,)で区切ります。ただし,一つのSFOサーバ名に指定できる文字列長は32文字までです。このとき,一つ目に指定されたSFOサーバ名がデフォルトとなります。
指定形式:
<SFOサーバ名>[,<SFOサーバ名>]
同じSFOサーバ名を複数回指定することはできません。
セッションフェイルオーバ機能を使用しない場合,このプロパティは無効です。
なし
(凡例)
-:08-00より前のバージョンを示します。
注※
webserver.sfo.sfo_serversキーで指定したSFOサーバ名。webserver.sfo.sfo_serversキーに指定されていないSFOサーバ名を指定した場合,そのキーは無効になります。

(au) webserver.staticから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
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キーが指定されている場合に有効になります。
キーの値に何も設定しない場合,このキーは無効になります。
なし
(凡例)
-:08-00より前のバージョンを示します。
注※
空白文字とは,半角スペース,タブ,LF(0x0a),CR(0x0d)またはFF(0x0c)のことを指します。

(av) webserver.workから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
webserver.work.cleanJSP用テンポラリディレクトリ下に生成したディレクトリをサーバ起動時,および終了時に削除するかどうかを指定します。
trueが指定された場合:
ディレクトリを削除します。
falseが指定された場合:
ディレクトリを削除しません。
false
webserver.work.directoryJSP用テンポラリディレクトリを指定します。絶対パスによるディレクトリ名を指定します。
ディレクトリのパスの区切り記号には,"/"を使用してください。
例えば,Windowsの場合,workディレクトリとしてC:¥temp¥workを設定するときは,次のように指定します。
(指定例)
webserver.work.directory=c:/temp/work
  • Windowsの場合
    <Cosminexusのインストールディレクトリ>¥CC¥server¥repository¥<サーバ名称>¥web
  • UNIXの場合
    /opt/Cosminexus/CC/server/repository/<サーバ名称>/web
(凡例)
-:08-00より前のバージョンを示します。
注※
使用するOSによってファイル名長に制限があります。例えば,Windowsでは250バイト程度となっています。このため,ディレクトリ階層の深い場所でサーブレットやJSPを実行できません。特にJSPファイルから生成されるファイル名はWebアプリケーションで配置されたディレクトリ階層の深さに比例して長くなり,JSPファイルに対するJavaファイルを生成できないことがあります。これを回避するためにはWebアプリケーションの配置ディレクトリの階層を浅くしたり,プロパティwebserver.work.directoryに絶対パスで浅いディレクトリ階層を指定したりすることで回避してください。Cosminexusの作業ディレクトリについては,マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」を参照してください。

(aw) webserver.xmlから始まるキー

指定できるキーについて次に示します。なお「省略値」とは,キーの指定がない場合に仮定される値です。

「VR」とは,キーが導入・変更されたアプリケーションサーバのバージョンです。

キー名称内容省略値VR
webserver.xml.validateServlet 2.3のWebアプリケーションについて,タグライブラリ・ディスクリプタ(TLDファイル)が,DTDで記述されたスキーマに沿って記述されているかチェックするかどうかを指定します。
J2EEサーバモードで起動した場合のweb.xml,およびServlet 2.4以降のWebアプリケーションのTLDファイルには,このプロパティの指定は無効となります。また,Servlet 2.4以降のWebアプリケーションに含まれるTLDファイルはTLDのバージョンにかかわらずすべてチェックされます。
次の値を指定します。
trueを指定した場合:
タグライブラリ・ディスクリプタだけをチェックします。
falseを指定した場合:
チェックしません。
true
(凡例)
-:08-00より前のバージョンを示します。

(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