Cosminexus リファレンス 定義編

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

3.6 usrconf.cfgバッチアプリケーション用オプション定義ファイル

<この節の構成>
(1) 形式
(2) ファイルの格納先
(3) 機能
(4) 指定できるキー

(1) 形式

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

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

 
<キー名称> = <値>
 

指定方法
  • 改行までが値になります。
  • #で始まる行はコメントとみなされます。
  • 値が存在しない行を定義した場合,その行は無視されます。
  • 値の後ろには,空白やコメントなどの文字列は追加できません。追加した場合,不正な値と解釈されます。
(例) <キー名称> = <値> #<コメント>
  • 実行時の文字エンコーディングと異なる文字エンコーディングでは記述できません。

(2) ファイルの格納先

環境変数CJBATCHUSRCONFDIRにusrconf.cfg(バッチアプリケーション用オプション定義ファイル)の格納先のパスを設定するか,cjexecjobコマンド(バッチアプリケーション実行コマンド)を実行するディレクトリにusrconf.cfg(バッチアプリケーション用オプション定義ファイル)を格納してください。usrconf.cfg(バッチアプリケーション用オプション定義ファイル)は,cjexecjobコマンド(バッチアプリケーション実行コマンド)実行時に,次の順で検索されます。

  1. 環境変数(CJBATCHUSRCONFDIR)に設定したディレクトリ
  2. cjexecjobコマンド(バッチアプリケーション実行コマンド)を実行したディレクトリ

(3) 機能

バッチサーバを実行するJavaVMの起動オプションを指定します。

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

(4) 指定できるキー

指定できるキーとデフォルト値を次の表に示します。

注意
ファイル内でマルチバイト文字を使用する場合は,次の個所で使用しているマルチバイト文字とエンコードを統一してください。
  • usrconf.cfg(バッチサーバ用オプション定義ファイル)
  • cjexecjobコマンド(バッチアプリケーション実行コマンド)の引数
  • バッチアプリケーションのソースコード(java.lang.System.outまたはjava.lang.System.err)

 

表3-3 usrconf.cfgに指定できるキーとデフォルト値(バッチサーバ)

キー名称 内容 デフォルト値
add.jvm.arg 指定された値をバッチサーバ上のバッチアプリケーションに渡します。次のオプションを指定できます。
  • -D<property>

次に示すプロパティは指定できません。
  • java.endorsed.dirs
  • java.security.policy
  • java.class.path
  • java.library.path
なし
add.class.path 設定されている値をバッチサーバ上にあるバッチアプリケーションクラスローダのクラスパスに追加します。このキーに指定できるJavaVMのオプションは1個だけです。複数指定する場合は,新たにadd.class.pathを追加します。ダブルクォーテーションは指定できません。 なし
batch.log.directory ログファイルの出力先ディレクトリを指定します。ログ出力先のパスを絶対パス,または相対パスで指定します。次の文字が指定できます。
  • 半角英数字
  • アンダースコア(_)
  • ハイフン(-)
  • パス区切り文字
180バイトを超えるパス(相対パス指定の場合,カレントディレクトリまでの絶対パスと相対パスの合計)を指定した場合は,KDJE40059-Wのメッセージが出力され,デフォルト値が使用されます。デフォルト値が180バイトを超える場合は,ログの初期化に失敗し,異常終了します。ディレクトリにアクセス権がない場合や,ファイル名を指定した場合は,KDJE55039-Wのメッセージが出力され,コマンドが終了します。
Windowsの場合,UNC名を含むパスは指定できません。UNIXの場合,nfsマウントされたディスク上へのパスは指定できません。
なし
batch.log.stdout.enabled バッチジョブ投入コマンドの標準出力に,バッチジョブ投入コマンドが出すメッセージを出力するかを指定します。

trueを指定した場合:
メッセージを標準出力に出力します。

falseを指定した場合:
メッセージを標準出力に出力しません。
true