HATS 管理コンソールの使用

HATS 管理インターフェースを使用して、接続を管理し、HATS Web アプリケーションの問題を判別できます。この章では、これらの管理機能の使用方法について説明します。HATS リッチ・クライアント・アプリケーションに関する情報については、HATS リッチ・クライアント・アプリケーションの管理を参照してください。

WebSphere® Application Server に展開されている Enterprise Archive (.ear) ファイルに含まれる一連の HATS アプリケーションに HATS 管理コンソールのサポート・ファイルを含めることができます。展開済み .ear ファイルはランタイム環境を提供します。この環境では、HATS 管理コンソールを使用することにより HATS アプリケーションを管理できます。複数のプロジェクトに HATS 管理コンソール・ファイルを含めると、異なるアプリケーション名を使用して複数の管理コンソールを開始できます。ただし、各管理コンソールは同一のビューと機能を提供します。

注:
このオプションは、HATS 標準ポートレット・プロジェクトではサポートされていません。

各 .ear ファイルに HATS 管理コンソール・サポート・ファイルを含める代わりに、HATS 管理コンソール・ファイルのみを含む .ear ファイルを作成することができます。この .ear ファイルを展開すると、HATS 管理コンソールを開始して管理の有効範囲を変更することで、1 つの管理コンソールのインスタンスで (HATS IBM® ポートレットおよび標準ポートレットに加えて) 複数の .ear ファイル の HATS アプリケーションをリモート側で管理できます。展開済み HATS 管理コンソール・アプリケーションにより、すべての HATS アプリケーションをまとめて 1 箇所から管理できます。新規 HATS プロジェクトを作成するときに、プロジェクトに HATS 管理コンソール・ファイルを含めるかどうかを指定します。HATS 管理コンソール・プロジェクトを作成する場合、作成したほかのプロジェクトに管理サポート・ファイルを追加する必要はありません。

HATS Toolkit で HATS 管理コンソール・プロジェクトを作成するには、「ファイル」>「新規」>「プロジェクト」>「HATS」>「HATS 管理プロジェクト」を選択します。このプロジェクトを HATS 管理コンソール・プロジェクトとして一意に識別する Enterprise Application プロジェクト名を指定します。HATS 管理コンソール・プロジェクトは、HATS Toolkit の「ナビゲーター」タブにのみ表示されます。作成した .ear ファイルを WebSphere Application Server に展開して開始します (HATS 管理コンソールの開始を参照)。HATS 管理コンソール・プロジェクトの管理の有効範囲を変更する場合には、管理の有効範囲の選択を参照してください。

その他の管理トピックについては、端末の表示機能で説明します。

HATS 管理コンソールおよび WebSphere セキュリティー

HATS 管理コンソールでは、Java™ Management Extensions (JMX) Bean を使用してリモート管理が実行されます。WebSphere Application Server のグローバル・セキュリティーが有効になっている場合は、これらの JMX 呼び出しが WebSphere セキュリティーにより認証されるため、WebSphere で有効な許可レベルが設定されている必要があります。したがって、ユーザー ID が、管理者権限またはオペレーター権限が付与されている WebSphere Application Server 管理コンソール・ユーザーとして定義されていないと、HATS 管理コンソールから適切にリモート管理操作を実行できません。

HATS 管理コンソールでは、問題判別設定を表示および変更できます。また、接続状況を確認し、ホスト接続を切断できます。HATS 管理機能を使用して HATS アプリケーションを展開する場合は、セキュリティーのために、HATS の 3 つの役割をそれぞれ特定のシステム・ユーザー ID にマップできます。定義されている 3 つの HATS 役割 (HATSAdministrator、HATSOperator、および HATSMonitor) では、それぞれに HATS 管理コンソールで実行できる機能が異なります。詳しくは、HATS 管理コンソールの役割を参照してください。

同様に、WebSphere Application Server 管理コンソールでは WebSphere Application Server 環境の構成を表示および変更できます。また、Web アプリケーション (HATS アプリケーションなど) のインストール、開始、停止、およびアンインストールを実行できます。WebSphere コンソールのユーザー役割 (管理者、コンフィギュレーター、オペレーター、またはモニター) では、それぞれに WebSphere Application Server 管理コンソールで実行できる機能が異なります。これらのセキュリティーの役割およびポリシーの詳細については、WebSphere Application Server インフォメーション・センターの以下のリンクを参照してください。

WebSphere グローバル・セキュリティーが有効な場合は、HATS 役割が設定されているユーザー ID を使用して、HATS アプリケーションで HATS 管理コンソールに接続でき、また特定の HATS アプリケーション内でのみ各管理操作を実行できます。他の HATS アプリケーションをリモート側で管理するために管理の有効範囲を変更しようとすると、WebSphere セキュリティーによりユーザー ID の権限が検査されます。ユーザー ID が、管理者権限またはオペレーター権限が設定された有効な WebSphere Application Server 管理コンソール・ユーザーでない場合は、JMX 呼び出しがブロックされ、HATS リモート管理が正しく機能しません。

例えば、ユーザー ID が WebSphere Application Server 管理コンソール・ユーザーとして定義されていないか、またはモニター権限のみが設定されている場合は、HATS 管理コンソールの「管理の有効範囲」の下の「アプリケーションの選択」リストに、他の HATS アプリケーションが表示されません。他のアプリケーションがリストされていないために、管理の有効範囲を変更できません。

もう 1 つの例として、コンフィギュレーター権限が設定された WebSphere Application Server 管理コンソール・ユーザーとして定義されているユーザー ID の場合、このリストには他の HATS アプリケーションが表示されるので、ユーザーが有効範囲を別のアプリケーションに変更できます。ただし、HATS 管理コンソールに表示される情報が正しくないことがあり、この場合リモート管理操作で試行した変更はすべて無効になります。

したがって、WebSphere グローバル・セキュリティーが有効である場合は、HATS 管理コンソールの使用に関して次の 2 つのオプションがあります。

オプション 1: HATS と WebSphere Application Server のユーザー役割を分離する
HATS 役割にマップされているユーザー ID に対して WebSphere Application Server 管理権限を付与しない場合は、すべての HATS アプリケーションに HATS 管理コンソールを組み込む必要があります。また、各 HATS アプリケーションを管理する際に、その HATS アプリケーションの HATS 管理コンソールを使用して別々に管理する必要があります。リモート管理は使用できません。

オプション 2: HATS と WebSphere Application Server のユーザー役割を結合する
単一の HATS アプリケーションで HATS 管理コンソールを使用し、管理の有効範囲を変更して他の HATS アプリケーションをリモートで管理するには、HATS 役割にマップされているユーザー ID を、WebSphere Application Server で管理者役割またはオペレーター役割が設定された WebSphere 管理コンソール・ユーザーとして定義する必要があります。これらのユーザーは、HATS 管理コンソールで管理の有効範囲を変更でき、マップされている特定の HATS 役割に許可されているその他の HATS 管理用タスクを実行できます。また、ユーザーは WebSphere Application Server 管理コンソールにログインして、マップされている WebSphere Application Server 管理コンソール・ユーザー役割に許可されている WebSphere 管理用タスクを実行できます。

いずれのオプションでも、WebSphere グローバル・セキュリティーが有効である場合は、「アプリケーション・セキュリティーを有効にする (Enable application security)」オプションが選択されていることを確認してください。 WebSphere Application Server V6.x の場合、WebSphere 管理コンソールから、「セキュリティー」>「セキュアな管理、アプリケーション、およびインフラストラクチャー (Secure administration, applications, and infrastructure)」>「アプリケーション・セキュリティー」>「アプリケーション・セキュリティーを有効にする (Enable application security)」を選択します。WebSphere Application Server V7.x の場合、WebSphere 管理コンソールから、「セキュリティー」>「グローバル・セキュリティー」>「アプリケーション・セキュリティー」>「アプリケーション・セキュリティーを有効にする (Enable application security)」を選択します。

要約すると、WebSphere グローバル・セキュリティーが有効な場合は、HATS リモート管理が適切に機能するように、HATS 役割にマップされているユーザー ID を、WebSphere Application Server の管理者役割またはオペレーター役割にもマップする必要があります。

HATS 管理コンソールの役割

HATS 管理コンソールは WebSphere セキュリティーにバインドされています。つまり、WebSphere Application Server セキュリティーが使用可能な場合には、システム管理者には HATS 管理タスクを実行するための適切な認証が必要となります。HATS により使用されるセキュリティー機能は、Java EE フォーム・ベースの認証プロセスに基づいています。WebSphere Application Server セキュリティーが使用可能な場合には、HATS 管理コンソールの操作はユーザー ID に定義されている役割に基づいて制限されます。HATS 管理コンソールの使用には、次の 3 つの役割が定義されています。各役割ではそれぞれ実行できる機能が異なります。

HATSAdministrator
この役割は完全な管理能力を備えており、以下のすべてのタスクを実行できます。 デフォルトでは、HATSAdministrator 役割は「すべての認証済み」ユーザーにマップされています。
HATSOperator
この役割は、重要データである可能性のあるデータにアクセスできない点を除いて役割 HATSAdministrator と同等です。この役割が設定されているユーザーは、端末の表示のトレースを使用可能にすることができません。また、トレース・ファイルもダウンロードできません。
HATSMonitor
この役割では、ユーザーが重要データ以外のデータ (アクティブ接続、接続プール、ユーザー・リスト、およびログなど) だけを表示できます。この役割が設定されているユーザーは、設定 (ライセンス管理設定、ログおよびトレース・ファイル・オプション、端末の表示の設定など) の変更と、トレース・ファイルのダウンロードを実行できません。

ユーザーまたはユーザー・グループへの役割のマッピングは、WebSphere 管理コンソールを使用して実行されます。

WebSphere Application Server V6.x の場合、適切な HATS 役割について、「セキュリティー・ロールをユーザー/グループにマップ」パネルで「認証済みすべて」オプションに必ずチェックマークを付けてください。WebSphere Application Server V7.x の場合、適切な HATS 役割について、「セキュリティー・ロールをユーザー/グループにマップ」 パネルの「特殊サブジェクトのマップ (Map Special Subjects)」ドロップダウンを使用して、「アプリケーション・レルム内の認証済みすべて (All Authenticated in Application Realm)」オプションが選択されていることを確認してください。

HATS 管理コンソールの開始

HATS 管理コンソールは、Web ベースです。 Web ブラウザーを使用して、HATS 管理コンソール・サーブレットである HATSAdminServlet により提供されるユーザー・インターフェースを介して管理タスクを実行します。

HATS 管理コンソールを始動するには、ブラウザーで URL http://host:port/appname/hatsadmin/admin をロードします。ここで、host は使用するホスト名、port は HATS アプリケーションが稼働しているアプリケーション・サーバーの HTTP トランスポートのポート番号、appname は管理サポートが含まれている HATS アプリケーションの名前です。

注:
URL 要求が WebSphere に対応して構成されている Web サーバーに送信される場合は、ポートの指定は不要です。

HATS 管理コンソールを始動すると、サーバーのデフォルト言語が使用されます。ただし、この言語は変更できます。言語を変更するには、ナビゲーション・フレームの「プリファレンス」を選択し、言語を選択してからブラウザーを再開始します。ブラウザーでは新たに選択した言語がデフォルトになります。この言語を変更するには、「プリファレンス」を選択して別の言語を選択します。

注:
  1. HATS 管理コンソールにアクセスするブラウザーの Cookie が無効になっている場合は、次の変更が発生します。
  2. サポートされる Web ブラウザーと制約事項のリストについては、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp) の HATS 前提条件のセクションを参照してください。

HATS Toolkit での管理コンソールの開始

HATS Toolkit では、「サーバーでデバッグ」または「サーバーで実行」モードで HATS 管理コンソールを開始できます。

特定のプロジェクトに対して HATS 管理コンソールを起動するには、「HATS プロジェクト」ビューでプロジェクトを右クリックし、「管理コンソールをオープン」をクリックします。

プロジェクトがローカル・テスト環境でまだ実行されていない場合は、「サーバーでデバッグ」モードを使用してこのプロジェクトが起動され、Web ブラウザー・ページで管理コンソール URL が表示されます。

「サーバーで実行」モードでプロジェクトが既に実行されている場合は、サーバーがデバッグ・モードで実行されていないことを示すプロンプトが表示されます。「現行モードで続行 (Continue in the current mode)」オプションを選択すると、管理コンソールが「サーバーで実行」モードで開きます。

異なるテスト・モードでの実行について詳しくは、「HATS スタートアップ・ガイド」の『Web プロジェクトのテスト・モード』を参照してください。

HATS Toolkit で管理コンソールを実行するときに変更するランタイム設定は、使用しているモードによって異なります。詳しくは、問題判別コンポーネントの管理を参照してください。

HATS 管理コンソールの機能の使用

このセクションでは、HATS 管理コンソールのさまざまな機能について説明します。

管理の有効範囲の選択

管理の有効範囲を選択できます。HATS 管理コンソールでは、HttpSession の存続期間にわたる管理の有効範囲のリストが維持されます。最初の管理の有効範囲は、デフォルトでは、HATS 管理コンソールへのアクセスに使用される HATS アプリケーションの HATS Enterprise Application (.ear) として選択されます。同じ WebSphere セル内に展開されている別の HATS Enterprise Application を管理するように管理の有効範囲を変更できます。

管理の有効範囲の変更で重要なことは、HATS 管理コンソールがインストールされている HATS Enterprise Application を検出できるようにホストとポートに関する情報を提供することです。指定されているポート値は、アクティブな WebSphere BOOTSTRAP_ADDRESS ポートでなければなりません。WebSphere Application Server、ノード、およびセルにはそれぞれ、BOOTSTRAP_ADDRESS ポートがあります。1 つの WebSphere リソースにポート値を指定すると、そのリソースに展開されている HATS Enterprise Application の管理が可能になります。WebSphere ノードのホストとポートを指定すると、そのノードにインストールされているすべての HATS Enterprise Application の管理が可能になります。BOOTSTRAP_ADDRESS ポートの詳細については、WebSphere Application Server の資料を参照してください。

機密保護機能のある環境では、管理者が管理の有効範囲を変更しようとすると、HATS 管理コンソールで次のメッセージが表示されることがあります。

選択された有効範囲の管理中に問題が発生しました。HATS アプリケーションがありません。管理の有効範囲は変更されませんでした。

機密保護機能のある WebSphere 環境で、管理対象の使用可能なアプリケーションのリストにデータを設定するための通信を実行する権限がユーザーにない場合に、この問題が発生することがあります。

WebSphere でユーザー・レジストリーにローカル・オペレーティング・システムを使用している場合、HATS 管理コンソールへのアクセスで使用するユーザー名に、ローカル・オペレーティング・システムのレジストリーでの管理者権限を設定する必要があります。WebSphere でユーザー・レジストリーに LDAP を使用している場合は、HATS 管理コンソールへのアクセスで使用するユーザー名は、WebSphere で LDAP へのアクセスで使用するサーバー ID である必要があります。

ライセンスの管理

左側のナビゲーション・フレームの「ライセンス管理」という見出しの下に、ライセンス情報を管理するための 2 つのパネルがあります。

接続のモニター

左側のナビゲーション・フレームの「接続管理」という見出しの下に、各種接続をモニターできる独立したパネルがあります。

これらの表示画面に表示される各接続は、バックエンド・データ・ソース (3270 アプリケーションやデータベースなど) への通信リンクを示します。これらの表示画面では、データ・ソースとユーザーの接続と、ユーザーの接続 ID に関する詳細情報を確認できます。3270 接続用の LU またはプール名が存在する場合は、それも表示されます。また、セッションをシャットダウンすることもできます。

接続プールのモニター

左側のナビゲーション・フレームの「接続管理」という見出しの下にある「接続プール」パネルには、定義されている接続プールに関する情報が表示されます。接続プールの 1 つ以上の接続が割り振られるまでは、接続プールはリストされません。

接続プールは、3270 アプリケーションやデータベースのようなバックエンド・データ・ソースへの通信リンクの集合です。クライアント要求の代理として統合オブジェクトまたはアプリケーションが実行されると、このオブジェクトまたはアプリケーションはプールから使用可能な接続を取得し、この接続を使用してデータ・ソースへアクセスし、接続をプールに戻します。接続プールが使用可能になる場合、接続の確立におけるプロセッサー使用は、最初の接続の使用時に吸収されます。この接続を再利用すると、前回確立された接続が利用され、処理が高速になります。

プール定義のモニター

左側のナビゲーション・フレームの「接続管理」という見出しの下にある「接続プール定義」パネルには、ホストおよびデータベース接続のプール定義情報が表示されます。定義されているプールから 1 つ以上の接続が割り振られるまでは、プール定義はリストされません。

プール定義は、データ・ソース接続の集合に関する情報を提供します。プール定義には、関連する一部の定義 (接続とマクロの定義やユーザー・リスト名など) が関連付けられています。プール定義は、他のいくつかの定義間の関連を作成するほかに、最小および最大プール・サイズ (アクティブ接続数に換算) や接続タイマーなど、プール内のすべての接続に対する構成パラメーターを提供します。

ユーザー・リストとユーザー・リスト・メンバーのモニター

左側のナビゲーション・フレームの「ユーザー管理」という見出しの下にある「ユーザー・リスト」パネルには、ユーザー・リストに関する情報が表示されます。

ユーザー・リストは、特定の接続プール定義に関連付けられているユーザー ID やその他の接続固有パラメーターを示します。ユーザー ID ごとに 1 つの接続だけが許可されるシステムでは、1 つのプールでアクティブな接続の数はユーザー ID の数によって決まります。

問題判別コンポーネントの管理

HATS 管理コンソールでは、問題解決時に役立つロギングとトレースをモニターできます。左側のナビゲーション・フレームの「トラブルシューティング」という見出しの下にあるリンクを選択して、ログ内のメッセージを表示したり、ログ設定やトレース設定を変更したりできます。このような問題判別補助機能の設定は、プロパティー・ファイルに維持されています。

ランタイム環境で実行されている HATS 管理コンソールへのアクセス中に設定を変更すると、この変更は runtime.properties ファイルに保存されます。この方法は推奨しませんが、ファイルを直接編集して設定を変更することもできます。このファイルは HATS Enterprise Application の was_dir/installedApps/ear_name ディレクトリーに格納されています。

HATS Toolkit 内のローカル・テスト環境で実行されている HATS 管理コンソールへのアクセス中に設定を変更すると、この変更は異なる 2 つのファイルのいずれか 1 つに保存されます。「サーバーで実行」モードで実行している場合は、変更は runtime.properties ファイルに保存されます。「サーバーでデバッグ」モードで実行している場合は、変更は runtime-debug.properties ファイルに保存されます。詳しくは、HATS Toolkit での管理コンソールの開始を参照してください。ファイルを直接編集して設定を変更することもできます。これらのファイルは HATS Toolkit の .ear プロジェクトのルートにあります。 HATS Toolkit で runtime.properties ファイルが変更された場合、その変更は保持され、HATS アプリケーションをランタイム環境に展開するときに有効になります。runtime-debug.properties ファイルは、ランタイム環境では無視されます。

注:
WebSphere Application Server for z/OS® 上で実行している場合、runtime.properties ファイルを編集するときには ASCII エディターを使用してください。この場合、このファイルをワークステーションに例えば FTP を使用して転送し、ファイルを編集した後でこのファイルを送り返します。また、アプリケーション・サーバーのアクティブなサーバントごとに runtime.properties のコピーがあります (サーバントのアドレス・スペース ID により区別されます)。アプリケーション・サーバーの再始動後も変更を維持するには、基本 runtime.properties ファイルを変更します。

これらのファイルでのログ設定とトレース設定について詳しくは、付録A. ランタイム・プロパティー・ファイルを参照してください。

ログ・ファイルとトレース・ファイルの名前

runtime.properties に記述されている基本ログおよびトレース・ファイルの名前は、各アプリケーション・サーバーの一意のログ・ファイルおよびトレース・ファイルのセットを生成するときにテンプレートとして使用されます。デフォルトの基本トレース・ファイル名は trace.txt、デフォルトの基本ログ・ファイル名は messages.txt です。アプリケーション・サーバーのログ・ファイルおよびトレース・ファイルのテンプレートを生成するときには、基本ファイル名にアプリケーション・サーバー名が付加されます。このアプリケーション・サーバー名は、WebSphere で定義されているアプリケーション・サーバーの完全修飾名と同一です。この名前は cell_node_server です。

HATS を実行しているアプリケーション・サーバーの名前は、アンダースコアー文字 (_)、アプリケーション・サーバー名、アンダースコアー文字 (_) をこの順序で連結したものになります。

例えばトレース・ファイルを使用する場合、この名前は trace _cell_node_server_.txt となります。さらに、複数のファイルを区別する場合、この名前に索引 (1、2、3 ...) を追加します。複数のトレース・ファイルが構成されている場合、このアプリケーション・サーバーのトレース・ファイル名は trace_cell_node_server_1.txt, trace_cell_node_server_2.txt ... となります。

注:
WebSphere Application Server for z/OS 上で実行している場合、アプリケーション・サーバーは複数のサーバントを実行できます。この場合、各サーバントが固有のログ・ファイルとトレース・ファイルを生成します。これらのファイルを区別するため、名前のサーバー・コンポーネント部分にはサーバントのアドレス・スペース ID (ASID) が接頭部として追加されます (例: trace_asid_1.txt)。

ログの表示

「ログの表示」パネルを使用して、HATS ログ・ファイルを表示したり、ファイル全体をダウンロードしたり、ファイルをクリアしたりできます。ログ・ファイルには、次の 2 種類のイベントに関する情報が記録されます。

エラー・イベント
操作の完了を妨げている問題。一般にエラー・イベントでは、問題を訂正する何らかのアクションを実行する必要があります。
警告イベント
問題を訂正するアクションが必要な可能性のある予期しない状況の発生。警告イベントはエラー・イベントほど重大ではありません。

ログ・ファイルは、管理者がトラブルシューティングを行うときに参照し、参考情報として使用することを目的としています。ログに表示されるメッセージのほとんどは、「HATS メッセージ」に収録されています。この資料では、必要に応じて実行できる問題訂正アクションを提案しています。

注:
Windows® では、HATS アプリケーションの実行中に標準出力ログと標準エラー・ログの名前の変更や削除はできません。トラブルシューティング手順で、ディスク・スペースの再利用や情報バンドル・ファイルのサイズの最小化のためにこれらのログの名前を変更するか、または削除する必要がある場合には、HATS を表すアプリケーション・サーバーを停止する必要があります。ただし、WebSphere ノードは引き続き実行できます。

ログ・オプションの設定

「ログ設定」パネルでは、ログ・ファイルへの情報と警告イベントの書き込みを制御し、ログ・イベントの書き込み先ファイルを定義できます。ログ・ファイル名の指定方法については、ログ・ファイルとトレース・ファイルの名前を参照してください。ファイルがすでに存在している場合には、新しいイベントはこのファイルに追加されます。エラー・イベントは常にログ・ファイルに書き込まれます。維持するログ・ファイルの数と各ログ・ファイルの最大サイズも定義できます。

トレース・オプションの設定

「トレース設定」パネルを使用して、次のタイプのトレース・オプションを 1 つ以上選択できます。

ランタイムのトレースを使用可能にする
プロジェクト内で接続に関する HATS ランタイムのトレースを使用可能にします。これらのランタイム接続を異なるレベルでトレースする場合には、付録A. ランタイム・プロパティー・ファイルでトレースの設定に関する説明を参照してください。
ウィジェットのトレースを使用可能にする
プロジェクト内でウィジェットに関する HATS ランタイムのトレースを使用可能にします。ウィジェットを異なるレベルでトレースする場合には、付録A. ランタイム・プロパティー・ファイルでトレースの設定に関する説明を参照してください。
アクションのトレースを使用可能にする
プロジェクト内でイベント・アクションに関する HATS ランタイムのトレースを使用可能にします。トレース・イベントを異なるレベルでトレースする場合には、付録A. ランタイム・プロパティー・ファイルでトレースの設定に関する説明を参照してください。
コンポーネントのトレースを使用可能にする
プロジェクト内でコンポーネントに関する HATS ランタイムのトレースを使用可能にします。コンポーネントを異なるレベルでトレースする場合には、付録A. ランタイム・プロパティー・ファイルでトレースの設定に関する説明を参照してください。
ユーティリティーのトレースを使用可能にする
プロジェクト内でランタイム・ユーティリティーに関する HATS ランタイムのトレースを使用可能にします。これらのランタイム・ユーティリティーを異なるレベルでトレースする場合には、付録A. ランタイム・プロパティー・ファイルでトレースの設定に関する説明を参照してください。
統合オブジェクトのトレース
プロジェクト内の特定の統合オブジェクトのトレースを使用可能にします。クラス名指定フィールドに、1 つ以上のパターンを使用してトレースする統合オブジェクトを指定します。各パターンには、1 つ以上のワイルドカード (*) 文字を使用できます。例えば IntegrationObject.Callup* は、Callup で始まる名前を持つすべての統合オブジェクトに対してトレースを使用可能にすることを指定します。すべての統合オブジェクトをトレースするには、IntegrationObject.* を指定します。複数のパターンを指定する場合には、各パターンをコンマで区切ってください。HATS 管理コンソールでは、統合オブジェクトの設定が最大トレース・レベルに設定されます。統合オブジェクトを異なるレベルでトレースする場合には、付録A. ランタイム・プロパティー・ファイルでトレースの設定に関する説明を参照してください。
アプレットのトレース
アプレットのトレースを使用可能にします。トレースのレベルを上げるほど、より多くのトレース情報が生成されます。アプレットのトレースをオンにすると、サーバー・サイドのトラブルシューティング・メッセージが出力されます。アプレットのトレース設定の詳細については、付録A. ランタイム・プロパティー・ファイルを参照してください。
ユーザー・マクロのトレース
マクロ実行をトレースします。このトレースはシステム・パフォーマンスに影響するため、このトレースはマクロをデバッグする目的でのみ使用することをお勧めします。
端末の表示
サーバーでリアルタイムに実行されているあらゆる接続のホスト端末画面を表示できます。端末の表示を使用可能にすると、その後に作成された接続の端末設定のみが表示されます。端末の表示の詳細については、テストとデバッグでの端末の表示の使用を参照してください。
注:
サーバーで実行時に端末の表示をオンにするかどうかを尋ねるダイアログを HATS で表示するかを決定できます。詳しくは、HATS プリファレンスの使用を参照してください。
ホスト・シミュレーション・トレースの記録
実行時にホスト・シミュレーションの記録を使用可能にするには、「ホスト・シミュレーションの記録を使用可能にする」ボックスを選択します。ホスト・セッションの次回開始時に記録が開始され、ホスト・セッションのクローズ時 (ユーザーがアプリケーション・キーパッドの切断ボタンをクリックする時点など) に記録が終了されます。トレースがアクティブなときにユーザーが Web ブラウザーを閉じると、HTTP セッションがタイムアウトになるまでトレースが続行されます。トレース・ファイルはサーバーのホスト・シミュレーション・フォルダー (例: <WebSphere install root>¥AppServer¥profiles¥AppSrv01¥installedApps¥<Node ID>¥<ear file name>¥<ApplicationName>.war¥WEB-INF¥profiles¥hostsimulations) に保存されます。トレース・ファイル名は、ApplicationName_ConnectionName_Date(yyyymmdd)_Time(hhmmss)_Number というテンプレートを使用して指定されます (例えば、MyApplication_main_20060101_134543_1)。

複数のホスト・セッションを同時にトレースするため、ホスト・シミュレーションでは複数の TCP/IP ポートが使用されます。「記録の対象となる TCP/IP ポート範囲」フィールドを使用してサーバーが実行時に使用するポート番号の範囲を設定します。デフォルトの範囲開始ポートは 7021、デフォルトの終了ポートは 7050 です。

IBM サービス・トレース・オプション
HATS 管理コンソールの「サービス・トレース・オプションの表示」チェック・ボックスを使用して、トレースをオンにできます (IBM サービス担当員から指示された場合)。IBM サービス担当員に指示された場合以外は、これらのトレースは使用しないでください。
トレース出力
トレース・ファイルへのトレース情報の書き込みを制御し、ログ・イベントの書き込み先ファイルを定義できます。トレース・ファイル名の生成方法については、ログ・ファイルとトレース・ファイルの名前を参照してください。ファイルがすでに存在している場合には、新しいトレース情報はこのファイルに追加されます。維持するトレース・ファイルの数と各トレース・ファイルの最大サイズも定義できます。

端末の表示機能

テストとデバッグでの端末の表示の使用

テスト・システムでアプリケーションをデバッグするときに、サーバーのディスプレイ上にホスト画面を表示する端末ウィンドウを作成するかどうかを制御できます。端末ウィンドウに表示されるホスト画面では、実行時に HATS アプリケーションとホスト・アプリケーションの間の対話を監視できます。また、端末ウィンドウのホスト画面を使用してホスト・アプリケーションと対話することもできます。このオプションがオンの間に確立された接続の端末画面のみが作成されます。既存の接続またはアイドル状態の接続には作成されません。ただし、HATS 管理コンソールの「ホスト接続」パネルには、選択されている接続の端末の表示をオンまたはオフにする「表示状況の切り替え (Toggle Display Status)」ボタンがあります。

注意:
「端末の表示」オプションをオンにすると、サーバーのパフォーマンスに深刻な影響を及ぼしたり、サーバーで過負荷が発生する可能性があります。多数の接続があるサーバーではこのオプションを使用しないでください。端末の表示は、テスト・システムでのアプリケーション開発時のデバッグ作業で使用することを目的としており、負荷の高い実動サーバーでの使用には適していません。

新しいホスト接続で端末の表示をオンにするには、左側のナビゲーション・フレームにある「トラブルシューティング」という見出しの下の「トレース設定」パネルの「端末の表示を使用可能にする」ボックスを選択します。ただし、「トレース設定」パネルの「端末の表示を使用可能にする」ボックスが選択されているかどうかに関係なくいつでも特定の接続の端末の表示をオンまたはオフにするには、「ホスト接続」パネルの「端末の表示の切り替え」ボタンを使用します。

注:
  1. WebSphere Application Server が、Windows プラットフォームでサービスとして始動されるときに端末の表示が正しく行われるように、WebSphere Application Server のサービス設定で 「デスクトップと対話することをサービスに許可する (Allow service to interact with desktop)」 を選択する必要があります。
  2. 端末の表示機能に必要な、IBM i プラットフォームでの Native Abstract Windowing Toolkit (NAWT) を使用してのグラフィックスの表示について詳しくは、資料 System i プログラミング IBM Developer Kit for Java (http://publib.boulder.ibm.com/infocenter/iseries/v5r4/topic/rzaha/rzaha.pdf) のセクション『グラフィカル・ユーザー・インターフェースを使用しないホスト上で Java アプリケーションを実行する』を参照してください。
  3. その他のプラットフォームでの端末の表示機能の構成の詳細については、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp) でセクション『System i®、System z®、および Unix プラットフォームに固有の情報』を参照してください。