ログ、トレース、およびライセンスの設定などのランタイム設定は、次の 2 つの異なるファイルのいずれかに保管されます。
Web アプリケーションのランタイム設定の管理方法について詳しくは、問題判別コンポーネントの管理を参照してください。リッチ・クライアント・アプリケーションのランタイム設定の管理方法について詳しくは、HATS リッチ・クライアント・アプリケーションの管理を参照してください。
runtime.properties ファイルと runtime-debug.properties ファイルには、次のプロパティーが含まれています。
各パターンには、1 つ以上のワイルドカード (*) 文字を使用できます。例えば IntegrationObject.Callup* は、Callup で始まる名前を持つすべての統合オブジェクトに対してトレースを使用可能にすることを指定します。すべての統合オブジェクトをトレースするには、IntegrationObject.* を指定します。
複数のパターンを指定する場合には、各パターンをコンマで区切ってください。
この値は整数です。デフォルト値はありません。「許可ユーザー」ライセンスの有効値は 1 から 50000 です。「バリュー・ユニット」ライセンスでは、値は、-1 でなければなりません。
ライセンス使用状況ファイルの最大サイズは、512 KB です。license1.txt ファイルのサイズが 512 KB に達するか、または HATS サーバーが再始動されると、そのファイル名は license2.txt に変更され、新しい license1.txt ファイルが作成されます。新しい license1.txt ファイルには、最新のライセンス使用状況情報が入ります。新しい license1.txt が 512 KB に達し、名前変更されると、古い license2.txt は削除されます。
ライセンス使用状況ファイルは一連の行から成り、1 行に以下の情報が入っています。各行はそれぞれ 1 時間分の操作に対応しています。値と値の間はスペース ( ) で区切られます。
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 の数を超過すると、最も古いファイルが削除されます。
この値は整数です。デフォルトは 512 KB です。
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 の数を超過すると、最も古いファイルが削除されます。
この値は整数です。デフォルトは 10240 KB です。
このセクションで説明するトレース・オプションで使用されるトレース・レベル値は、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 を使用すると、メソッドの開始とメソッド出口のランタイム・トレースのみが実行されます。
この値は、0 から 9 の整数です。デフォルトは 0 です。このデフォルト値ではランタイム・トレースは実行されません。
この値は、0 から 9 の整数です。デフォルトは 0 です。このデフォルト値ではイベント・アクション・トレースは実行されません。
この値は、0 から 9 の整数です。デフォルトは 0 です。このデフォルト値では変換トレースは実行されません。
この値は、0 から 9 の整数です。デフォルトは 0 です。このデフォルト値ではコンポーネント・トレースは実行されません。
この値は、0 から 9 の整数です。デフォルトは 0 です。このデフォルト値ではウィジェット・トレースは実行されません。
この値は、0 から 9 の整数です。デフォルトは 0 です。このデフォルト値では統合オブジェクトのトレースは実行されません。
この値は、0 から 9 の整数です。デフォルトは 0 です。このデフォルト値ではランタイム・ユーティリティー・トレースは実行されません。
値は整数であり、以下のようになります。
デフォルトは 0 です。
この値は 2 進数です。デフォルトは 0 です。
この値は 2 進数です。デフォルトは 0 です。
trace.HOD.DISPLAYTERMINAL が 1 の場合、HATS がホスト接続を作成すると (例えばアプリケーションからの要求に応答して作成するなど)、自動的にホスト端末表示が作成されます。このプロパティーが 0 に設定されていると、この処理は行われません。ただし、ホスト接続作成時にホスト端末表示が自動的に作成されるかどうかに関係なく、HATS 管理者は HATS 管理コンソールを使用して各ホスト接続のホスト端末表示をオンまたはオフにできます。
この値は、0 から 3 の整数です。
デフォルトは 0 です。
この値は、0 から 2 の整数です。
デフォルトは 0 です。
この値は、0 から 3 の整数です。
デフォルトは 0 です。
この値は 2 進数です。デフォルトは 0 です。
この値は 2 進数です。デフォルトは 0 です。
この値は、0 から 3 の整数です。
デフォルトは 0 です。
この値は、0 から 3 の整数です。
デフォルトは 0 です。
この値は、0 から 3 の整数です。
デフォルトは 0 です。
この値は 2 進数です。デフォルトは 0 です。