付録A. ランタイム・プロパティー・ファイル

ログ、トレース、およびライセンスの設定などのランタイム設定は、次の 2 つの異なるファイルのいずれかに保管されます。

Web アプリケーションのランタイム設定の管理方法について詳しくは、問題判別コンポーネントの管理を参照してください。リッチ・クライアント・アプリケーションのランタイム設定の管理方法について詳しくは、HATS リッチ・クライアント・アプリケーションの管理を参照してください。

runtime.properties ファイルと runtime-debug.properties ファイルには、次のプロパティーが含まれています。

adminPortNum
adminPortNum は、管理の有効範囲を変更するときに HATS 管理コンソールにより使用されるデフォルト値です。ポート値は、アクティブな WebSphere® BOOTSTRAP_ADDRESS ポートでなければなりません。デフォルト値は 2809 です。これは、WebSphere ベース・インストールの server1 のデフォルト BOOTSTRAP_ADDRESS ポート、または Deployment Manager セルにアプリケーション・サーバー・ノードを統合するときのノード・エージェント・サーバーのデフォルト BOOTSTRAP_ADDRESS ポートです。
ioPatternKey  Web のみ 
トレースする統合オブジェクトを指定する 1 つ以上のパターン。以下の trace.INTEGRATIONOBJECT の説明を参照してください。

各パターンには、1 つ以上のワイルドカード (*) 文字を使用できます。例えば IntegrationObject.Callup* は、Callup で始まる名前を持つすべての統合オブジェクトに対してトレースを使用可能にすることを指定します。すべての統合オブジェクトをトレースするには、IntegrationObject.* を指定します。

複数のパターンを指定する場合には、各パターンをコンマで区切ってください。

numLicenses
購入したライセンスの数を指定します。HATS は、ホスト・リソースへの HATS 接続の数を追跡し、その値が購入したライセンスの数を超過すると、メッセージをログに記録します。

この値は整数です。デフォルト値はありません。「許可ユーザー」ライセンスの有効値は 1 から 50000 です。「バリュー・ユニット」ライセンスでは、値は、-1 でなければなりません。

licenseHardLimit
HATS ライセンス資格を含む暗号化されたフィールド。このフィールドは、手動で変更しないでください。
licenseTracking
HATS でライセンス使用を記録するかどうかを指定します。この値は 2 進数です。デフォルトは 0 です。
0
HATS はライセンス使用を記録しません。
1
HATS は 1 つのノード内のすべてのアプリケーション・サーバーのライセンス使用を記録します。HATS は、ホストまたはデータベース・リソースへの HATS 接続の数を追跡し、その値が購入したライセンスの数を超過すると、メッセージをログに記録します。ライセンス使用情報は、サーバー上の HATS インストール・ディレクトリーの log ディレクトリーにある licensex.txt という名前のファイルに書き込まれます。ここで、x は 1 または 2 です。

ライセンス使用状況ファイルの最大サイズは、512 KB です。license1.txt ファイルのサイズが 512 KB に達するか、または HATS サーバーが再始動されると、そのファイル名は license2.txt に変更され、新しい license1.txt ファイルが作成されます。新しい license1.txt ファイルには、最新のライセンス使用状況情報が入ります。新しい license1.txt が 512 KB に達し、名前変更されると、古い license2.txt は削除されます。

ライセンス使用状況ファイルは一連の行から成り、1 行に以下の情報が入っています。各行はそれぞれ 1 時間分の操作に対応しています。値と値の間はスペース ( ) で区切られます。

  1. 日付
  2. 時刻
  3. サーバーが始動されてからの最大ライセンス数
  4. 過去 1 時間における最大ライセンス数 (最後の 60 エントリーの最大値)
  5. 1 分ごと (1 から 60) のライセンス数
licenseFile
ライセンス使用状況情報のライセンス・ファイルの名前を生成するときにテンプレートとして使用される名前です。このプロパティーのデフォルト値は license.txt です。
logFile
ログ・メッセージが書き込まれるアプリケーション・サーバー・ファイルの各セットに名前を生成するためのテンプレートとして使用する名前。ログ・ファイルのデフォルトのベース名は、messages.txt です。
maxLogFiles
メッセージ・ファイルの最大数。デフォルトは 2 です。

runtime.properties の中の基本ログ・ファイル名が、各アプリケーション・サーバーに固有のメッセージ・ログ・ファイルのセットを生成するためのテンプレートとして使用されます。デフォルトの基本ログ・ファイル名は runtime.properties で変更できます。HATS を実行しているアプリケーション・サーバーの名前は、アンダースコアー文字 (_)、HATS インスタンスの名前、アンダースコアー文字 (_) をこの順序で連結したものになります。

アプリケーション・サーバーのログ・ファイルのテンプレートを生成するには、基本ファイル名に HATS インスタンス ID (_SSS_ など) を付加します。ログ・ファイルの場合、これは messages _SSS_.txt になります。さらに、複数のファイルを区別する場合、この名前に索引 (1、2、3 ...) を追加します。そこで、例えば、HATS インスタンス ID が cell_node_server の場合、アプリケーション・サーバーのログ・ファイル名は messages_cell_node_server_.txt になります。複数のログ・ファイルが構成されている場合、このアプリケーション・サーバーのログ・ファイル名は messages_cell_node_server_1.txt, messages_cell_node_server_2.txt ... となります。

messages_cell_node_server_1.txt のサイズが maxLogFileSize に達すると、そのファイルはクローズされ、messages_cell_node_server_2.txt に名前変更されます。新しい messages_cell_node_server_1.txt がオープンされます。

messages_cell_node_server_1.txt のサイズが再度 maxLogFileSize に達すると、古いログ・ファイルの名前が変更されます。例えば、messages_cell_node_server_2.txt は messages_cell_node_server_3.txt に変更されます。messages_cell_node_server_1.txt は messages_cell_node_server_2.txt に名前変更され、新しい messages_cell_node_server_1.txt ファイルがオープンされます。

maxLogFiles の数を超過すると、最も古いファイルが削除されます。

注:
WebSphere Application Server for z/OS® 上で実行している場合、ログ・ファイル名のサーバー部分には、ログへの書き込みを実行するサーバントのアドレス・スペース ID も含まれています (例: messages_asid_1.txt)。詳細については、ログ・ファイルとトレース・ファイルの名前を参照してください。
maxLogFileSize
メッセージ・ログ・ファイルの最大サイズを KB 単位で指定します。このサイズに達すると、新しいログ・ファイルがオープンされます。

この値は整数です。デフォルトは 512 KB です。

traceFile
HATS トレース・メッセージの書き込み先のファイル名を生成するためにテンプレートとして使用する名前。トレース・ファイルのデフォルトの基本名は、trace.txt です。
maxTraceFiles
トレース情報ファイルの最大数。デフォルトは 5 です。

server.properties の中の基本トレース・ファイル名が、各アプリケーション・サーバーに固有のトレース・ファイルのセットを生成するためのテンプレートとして使用されます。デフォルトの基本トレース・ファイル名は runtime.properties で変更できます。HATS を実行しているアプリケーション・サーバーの名前は、アンダースコアー文字 (_)、HATS サーバー・インスタンスの名前、アンダースコアー文字 (_) をこの順序で連結したものになります。

アプリケーション・サーバーのトレース・ファイルのテンプレートを生成するには、基本ファイル名に HATS サーバー・インスタンス ID (_SSS_ など) を付加します。このファイル名は trace _SSS_.txt となります。さらに、複数のトレース・ファイルを区別する場合、この名前に索引 (1、2、3 ...) を追加します。そこで、例えば、HATS サーバー・インスタンス ID が cell_node_server の場合、アプリケーション・サーバーのトレース・ファイル名は trace_cell_node_server_.txt になります。複数のトレース・ファイルが構成されている場合、このアプリケーション・サーバーのトレース・ファイル名は trace_cell_node_server_1.txt, trace_cell_node_server_2.txt ... となります。

trace_cell_node_server_1.txt のサイズが maxTraceFileSize に達すると、そのファイルはクローズされ、trace_cell_node_server_2.txt に名前変更されます。新しい trace_cell_node_server_1.txt がオープンされます。

trace_cell_node_server_1.txt のサイズが再度 maxTraceFileSize に達すると、古いトレース・ファイルの名前が変更されます。例えば、trace_cell_node_server_2.txt は trace_cell_node_server_3.txt に変更されます。trace_cell_node_server_1.txt は trace_cell_node_server_2.txt に名前変更され、新しい trace_cell_node_server_1.txt ファイルがオープンされます。

maxTraceFiles の数を超過すると、最も古いファイルが削除されます。

注:
WebSphere Application Server for z/OS 上で実行している場合、トレース・ファイル名のサーバー部分には、ログへの書き込みを実行するサーバントのアドレス・スペース ID も含まれています (例: trace_asid_1.txt)。詳細については、ログ・ファイルとトレース・ファイルの名前を参照してください。
maxTraceFileSize
トレース・ファイルの最大サイズを KB 単位で指定します。このサイズに達すると、新しいトレース・ファイルがオープンされます。

この値は整数です。デフォルトは 10240 KB です。

traceLogDirectory
アプリケーションの EAR を展開する場合にログとトレース出力を書き込むためのディレクトリーを設定します。このキーワードを指定しない場合、または指定された値が有効でない場合は、使用されるディレクトリーは「logs」で、これは EAR のインストール・ディレクトリーの下に配置されます。この値は、EAR がアプリケーション・サーバーに展開された場合のみに使用されます。この値は、Toolkit 環境では無効です。
maxHODThreadManagerThreads
Host On-Demand ThreadManager スレッド・プールに作成できるスレッドの最大数を指定します。10 から 10000 までの値を指定できます。この範囲外の値を指定すると、設定が無視され、デフォルトの Host On-Demand 値である 10000 が使用されます。

トレース・オプション

このセクションで説明するトレース・オプションで使用されるトレース・レベル値は、16 進数字ストリングを表します。数字ストリングの各ビットは、そのランタイムに対する 1 つのトレース・タイプを制御します。デフォルトは以下のとおりです。

tracelevel.1 : 0000000000020000
tracelevel.2 : 000000000000020f
tracelevel.3 : 000000000004023f  (minimum)
tracelevel.4 : 0000000000041a3f
tracelevel.5 : 00000000000c1bbf  (normal)
tracelevel.6 : 00000000000c1bbf
tracelevel.7 : 00000000001c1bbf  (maximum)
tracelevel.8 : 00000000001c1bbf
tracelevel.9 : 00000000001c1bbf

以下に、トレース・マスク内の各ビットの定義を示します。

x000001  - Informational messages
x000002  - Warning messages
x000004  - Error messages
x000008  - Critical error messages
x000010  - API traces
x000020  - Callback API traces
x000080  - Method entry
x000100  - Method exit
x000200  - Exceptions
x000400  - Miscellaneous traces
x000800  - Object creation
x001000  - Object disposal
x020000  - performance tracing - use this value alone
x040000  - Miscellaneous data - level 1
x080000  - Miscellaneous data - level 2
x100000  - Miscellaneous data - level 3

トレース・レベル値をカスタマイズするには、トレース・マスクの 16 進値を合計します。例えば、tracelevel.9=180 と指定し、trace.RUNTIME=9 を使用すると、メソッドの開始とメソッド出口のランタイム・トレースのみが実行されます。

trace.RUNTIME
メイン・ランタイムのトレース・レベル、およびトレース・レベルを指定していない RUNTIME.* で使用されるすべての設定に関するトレース・レベルを指定します。

この値は、0 から 9 の整数です。デフォルトは 0 です。このデフォルト値ではランタイム・トレースは実行されません。

trace.RUNTIME.ACTION
イベント・アクションのトレースのレベルを指定します。この設定は、trace.RUNTIME の設定をオーバーライドします。

この値は、0 から 9 の整数です。デフォルトは 0 です。このデフォルト値ではイベント・アクション・トレースは実行されません。

trace.TRANSFORM
HATS 変換のトレース・レベル、およびトレース・レベルを指定していない TRANSFORM.* で使用されるすべての設定に関するトレース・レベルを指定します。

この値は、0 から 9 の整数です。デフォルトは 0 です。このデフォルト値では変換トレースは実行されません。

trace.TRANSFORM.COMPONENT
HATS コンポーネントに対するトレースのレベルを指定します。この設定は、trace.TRANSFORM の設定をオーバーライドします。

この値は、0 から 9 の整数です。デフォルトは 0 です。このデフォルト値ではコンポーネント・トレースは実行されません。

trace.TRANSFORM.WIDGET
HATS ウィジェットに対するトレースのレベルを指定します。この設定は、trace.TRANSFORM の設定をオーバーライドします。

この値は、0 から 9 の整数です。デフォルトは 0 です。このデフォルト値ではウィジェット・トレースは実行されません。

trace.INTEGRATIONOBJECT  Web のみ 
統合オブジェクトに対するトレースのレベルを指定します。

この値は、0 から 9 の整数です。デフォルトは 0 です。このデフォルト値では統合オブジェクトのトレースは実行されません。

trace.UTIL
HATS ランタイム・ユーティリティーに対するトレースのレベルを指定します。

この値は、0 から 9 の整数です。デフォルトは 0 です。このデフォルト値ではランタイム・ユーティリティー・トレースは実行されません。

trace.APPLET  Web のみ 
アプレットのトレースのレベルを指定します。

値は整数であり、以下のようになります。

0
トレースは実行されません。
3
最小レベルのトレースが実行されます。
5
通常レベルのトレースが実行されます。

デフォルトは 0 です。

Host On-Demand トレース

trace.HOD.COMMEVENT
Host On-Demand COMM イベントのトレース・レベルを指定します。
0
Host On-Demand COMM イベント・トレースは使用不可です。
1
Host On-Demand COMM イベント・トレースが使用可能です。

この値は 2 進数です。デフォルトは 0 です。

trace.HOD.DISPLAYTERMINAL
Host On-Demand が接続ごとに端末ウィンドウを表示するかどうかを指定します。
0
Host On-Demand は接続ごとに端末ウィンドウを表示しません。
1
Host On-Demand は接続ごとに端末ウィンドウを表示します。

この値は 2 進数です。デフォルトは 0 です。

trace.HOD.DISPLAYTERMINAL が 1 の場合、HATS がホスト接続を作成すると (例えばアプリケーションからの要求に応答して作成するなど)、自動的にホスト端末表示が作成されます。このプロパティーが 0 に設定されていると、この処理は行われません。ただし、ホスト接続作成時にホスト端末表示が自動的に作成されるかどうかに関係なく、HATS 管理者は HATS 管理コンソールを使用して各ホスト接続のホスト端末表示をオンまたはオフにできます。

trace.HOD.DS
Host On-Demand データ・ストリーム・トレースのトレース・レベルを指定します。

この値は、0 から 3 の整数です。

0
トレースは実行されません。
1
最小レベルのトレースが実行されます。
2
通常レベルのトレースが実行されます。
3
最大レベルのトレースが実行されます。

デフォルトは 0 です。

trace.HOD.MACRO
Host On-Demand マクロのトレースのレベルを指定します。

この値は、0 から 2 の整数です。

0
Host On-Demand マクロ・トレースは使用不可です。
1
Host On-Demand イベント・トレースが使用可能です。
2
Host On-Demand サポート・トレースが使用可能です。

デフォルトは 0 です。

trace.HOD.PS
Host On-Demand 表示スペースのトレース・レベルを指定します。

この値は、0 から 3 の整数です。

0
トレースは実行されません。
1
最小レベルのトレースが実行されます。
2
通常レベルのトレースが実行されます。
3
最大レベルのトレースが実行されます。

デフォルトは 0 です。

trace.HOD.PSEVENT
Host On-Demand PS イベントのトレース・レベルを指定します。
0
Host On-Demand PS イベント・トレースは使用不可です。
1
Host On-Demand PS イベント・トレースが使用可能です。

この値は 2 進数です。デフォルトは 0 です。

trace.HOD.OIAEVENT
Host On-Demand OIA イベントのトレース・レベルを指定します。
0
Host On-Demand OIA イベント・トレースは使用不可です。
1
Host On-Demand OIA イベント・トレースが使用可能です。

この値は 2 進数です。デフォルトは 0 です。

trace.HOD.SESSION
Host On-Demand セッションのトレースのレベルを指定します。

この値は、0 から 3 の整数です。

0
トレースは実行されません。
1
最小レベルのトレースが実行されます。
2
通常レベルのトレースが実行されます。
3
最大レベルのトレースが実行されます。

デフォルトは 0 です。

trace.HOD.TRANSPORT
Host On-Demand トランスポートのトレース・レベルを指定します。

この値は、0 から 3 の整数です。

0
トレースは実行されません。
1
最小レベルのトレースが実行されます。
2
通常レベルのトレースが実行されます。
3
最大レベルのトレースが実行されます。

デフォルトは 0 です。

trace.HOD.USERMACRO
Host On-Demand ユーザー・マクロでのトレース・アクションのトレース・レベルを指定します。

この値は、0 から 3 の整数です。

0
トレースは実行されません。
1
最小レベルのトレースが実行されます。
2
通常レベルのトレースが実行されます。
3
最大レベルのトレースが実行されます。

デフォルトは 0 です。

ホスト・シミュレーション・トレース

recordSimulationTrace
ホスト・シミュレーション・トレースの記録を実行時に使用可能にするかどうかを指定します。
0
ホスト・シミュレーション・トレースの記録は使用可能ではありません。
1
ホスト・シミュレーション・トレースの記録は使用可能です。

この値は 2 進数です。デフォルトは 0 です。

startPort
実行時に、複数ホスト・セッションのホスト・シミュレーション・トレース記録を同時に実行するために使用するポート範囲の開始ポートを指定します。デフォルトは、ポート 7021 です。
endPort
実行時に、複数ホスト・セッションのホスト・シミュレーション・トレース記録を同時に実行するために使用するポート範囲の終了ポートを指定します。デフォルトは、ポートは 7050 です。