9.2.49 Javaに関するオペランド
Javaストアドプロシジャ又はJavaストアドファンクションを使用する場合に,Javaに関するオペランドを指定します。Javaストアドプロシジャ及びJavaストアドファンクションについては,マニュアル「HiRDB Version 9 UAP開発ガイド」を参照してください。
- ◆ pd_java_option = "Javaオプション"〔,"Javaオプション"〕…
-
〜<文字列>
Java仮想マシンの起動オプションを指定します。起動オプションについては,Java仮想マシンのドキュメントを参照してください。
- 《オペランドの規則》
-
-
一つのJavaオプションの文字列長は255文字以内とします。
-
全Javaオプションの文字列長の合計は1024文字以内とします。
-
Javaオプションに " を指定できません。
-
Javaオプションは最大20個指定できます。
-
- 《オペランドの指定方法》
-
Java仮想マシンが使用するヒープサイズの初期値を32メガバイト,ヒープサイズの最大値を64メガバイトに設定する場合の例を次に示します。
pd_java_option = "-Xms32m","-Xmx64m"
- ◆ pd_java_routine_stack_size = 外部Javaルーチンが使用するスタック領域長
-
〜<符号なし整数>((1024〜2146435072))《131072》(単位:バイト)
外部Javaルーチンが使用するスタック領域長をバイト単位で指定します。
- 《指定値の目安》
-
-
Javaオプションで指定したスタック領域長以上の値を指定してください。
-
Java仮想マシンの起動オプションに,Java仮想マシンのスタック領域長とネイティブメソッドスタック領域長の両方を指定するオプションがある場合,このオペランドにはネイティブメソッドスタック領域長以上の値を指定してください。
-
- 《注意事項》
-
-
Javaオプションで指定したスタック領域長より小さい値を指定すると,HiRDBが正しく動作しないことがあります。
-
使用スタック領域長がこのオペランドの値を超えると,HiRDBが正しく動作しないことがあります。ただし,Java仮想マシンがスタックオーバフローを検知した場合は正しく動作します。
-
- ◆ pd_java_archive_directory = "JARファイル格納ディレクトリ"
-
〜<パス名>《%PDDIR%¥java》
Javaストアドプロシジャ又はJavaストアドファンクションで使用するJARファイルを格納するディレクトリ名を絶対パス名で指定します。
- 《注意事項》
-
-
このオペランドを指定する場合,ここで指定するディレクトリをJARファイルのインストール前に作成しておく必要があります。
-
JARファイル格納ディレクトリは,JARファイルを格納するための専用のディレクトリです。
-
JARファイル格納ディレクトリには,インストールしたJARファイル以外を格納しないでください。
-
- 《オペランドの規則》
-
-
パス名は255文字以内とします。
-
パス名の大文字と小文字の区別をしません。
-
- ◆ pd_java_classpath = "Javaクラスパス"
-
〜<パス名>
Java仮想マシンで使用するクラスパスを絶対パス名で指定します。
このオペランドに指定したパスに含まれるクラスは,Javaストアドプロシジャ又はJavaストアドファンクションの処理手続きとして実行されるJavaメソッドから参照できます。
Javaストアドプロシジャ又はJavaストアドファンクションの外部ルーチン名として指定したJARファイルとこのオペランドに指定したパスに同じ名称のクラスがある場合,このオペランドに指定したパスが優先されます。
- 《オペランドの規則》
-
-
パス名は1024文字以内とします。
-
パス名の大文字と小文字の区別をしません。
-
- ◆ pd_java_runtimepath = "Java Runtime Environmentのルートディレクトリ"
-
〜<パス名>《%PDDIR%¥jre》
Java Runtime Environmentのルートディレクトリを絶対パス名で指定します。
- 《オペランドの規則》
-
-
パス名は255文字以内とします。
-
パス名の大文字と小文字の区別をしません。
-
- 《注意事項》
-
JRE(Java Runtime Environment)の同梱を廃止したため,HiRDBを07-03より前のバージョンから07-03以降にバージョンアップする場合,このオペランドを追加するか,又はこのオペランドの指定値を変更してください。バージョンアップの注意事項については,マニュアル「HiRDB Version 9 システム導入・設計ガイド」の「Javaストアドプロシジャ及びJavaストアドファンクションを使用する場合」を参照してください。
- ◆ pd_java_libpath = "Java仮想マシンのライブラリディレクトリ"
-
〜<パス名>
Java仮想マシンのライブラリが格納されているディレクトリを,Java Runtime Environmentのルートディレクトリ(pd_java_runtimepathオペランドの値)への相対パス名で指定します。
- 《オペランドの省略値》
-
このオペランドの省略値を次に示します。
OSの種類
省略値
Windows(下記以外)
bin\hotspot,又はbin\client※
Windows (x64)
bin\server
- 注※
-
bin\hotspotにjvm.dllがない場合は,bin\clientを仮定します。
- 《オペランドの規則》
-
-
パス名は255文字以内とします。
-
パス名の大文字と小文字の区別をしません。
-
- ◆ pd_java_stdout_file = "Java仮想マシンの標準・標準エラー出力の設定先ファイル"
-
〜<パス名>
Java仮想マシンでの標準出力又は標準エラー出力の出力先をファイルにする場合,そのファイル名を絶対パス名で指定します。このオペランドを省略すると,Java仮想マシンでの標準出力又は標準エラー出力が無視されます。
- 《指定値の目安》
-
このオペランドで指定するファイルの容量が非常に大きくなるため,通常はこのオペランドを指定しないでください。Javaストアドプロシジャ又はJavaストアドファンクションのデバッグ時に指定することをお勧めします。なお,このオペランドで指定するファイルの容量制限はありません。
- 《注意事項》
-
複数プロセスからの同時書き込みがあった場合は,その出力内容を保証しません。
- 《オペランドの規則》
-
-
パス名は255文字以内とします。
-
パス名の大文字と小文字の区別をしません。
-
- ◆ pd_java_castoff = Y|N
-
Java仮想マシンを起動したサーバ(シングルサーバ,フロントエンドサーバ,ディクショナリサーバ,及びバックエンドサーバ)プロセスを,次の契機で終了させるかどうかを指定します。
項番
サーバの種類
プロセスの名称
プロセスが終了する契機
1
シングルサーバ
pdsds
UAPを切り離したとき
2
フロントエンドサーバ
pdfes
UAPを切り離したとき
3
ディクショナリサーバ
pddic
トランザクションが決着したとき,又はUAPを切り離したとき
4
バックエンドサーバ
pdbes
トランザクションが決着したとき,又はUAPを切り離したとき
Y:表に示した契機でサーバプロセスを終了させます。
N:表に示した契機でサーバプロセスを終了させません。
- 《指定値の目安》
-
通常はこのオペランドを指定しないでください。ただし,次に示す問題が発生した場合は,このオペランドにYを指定することをお勧めします。
-
Java仮想マシンの使用によってメモリサイズが大きくなり,システムの空きメモリが圧迫されている
-
別のコネクションでJava仮想マシンが設定したスタックサイズの上限が原因で,Java仮想マシンを使用しないコネクションでも探索条件が多いSQLを実行するとスタックの拡張ができなくなり,サーバプロセスがセグメンテーション障害でアボートする
なお,Java仮想マシンの機能についてはJava仮想マシンのドキュメントを参照してください。
-
- 《注意事項》
-
Javaストアドルーチンを頻繁に実行するシステムで,このオペランドにYを指定すると,サーバプロセスの再起動,及びJava仮想マシン起動のオーバヘッドが発生します。
- 《ほかのオペランドとの関連》
-
このオペランドは,pd_process_countオペランドと関連があります。