HATS-Administrationskonsole verwenden

Die HATS-Administrationsschnittstelle kann zum Management von Verbindungen und zur Fehlerbestimmung für HATS-Webanwendungen verwendet werden. In diesem Kapitel wird die Verwendungsweise dieser Managementfunktionen beschrieben. Informationen zu HATS Rich-Client-Anwendungen finden Sie in HATS-Rich-Client-Anwendungen verwalten.

Sie können die Unterstützungsdateien für die HATS-Administrationskonsole in die Gruppe der HATS-Anwendungen aufnehmen, die in einer Enterprise Archive-Datei (EAR-Datei) enthalten sind, die in WebSphere Application Server implementiert wird. Die implementierte EAR-Datei stellt eine Laufzeitumgebung bereit, in der die HATS-Administrationskonsole die Verwaltung der HATS-Anwendungen ermöglicht. Wenn Sie die Dateien der HATS-Administrationskonsole in mehrere Projekte aufnehmen, können mehrere Administrationskonsolen über verschiedene Anwendungsnamen gestartet werden. In jeder Administrationskonsole werden jedoch dieselben Sichten und Funktionen bereitgestellt.

Anmerkung:
Diese Option wird von HATS-Standardportletprojekten nicht unterstützt.

Anstatt die Unterstützungsdateien für die HATS-Administrationskonsole in jede EAR-Datei einzufügen, können Sie eine EAR-Datei erstellen, die nur die Dateien der HATS-Administrationskonsole enthält. Wenn Sie diese EAR-Datei implementieren, können Sie die HATS-Administrationskonsole starten und den Verwaltungsbereich so ändern, dass HATS-Anwendungen in mehreren EAR-Dateien (sowie HATS IBM® und standardportlets) durch eine einzige Instanz der Administrationskonsole fern verwaltet werden können. Die implementierte HATS-Administrationskonsolenanwendung stellt einen zentralen Verwaltungspunkt für alle HATS-Anwendungen zur Verfügung. Wenn Sie ein neues HATS-Projekt erstellen, geben Sie an, ob die Dateien der HATS-Administrationskonsole in das Projekt mit aufgenommen werden sollen. Wenn Sie ein HATS-Administrationskonsolenprojekt erstellen, brauchen Sie die Verwaltungsunterstützungsdateien keinen anderen Projekten, die Sie erstellen, mehr hinzuzufügen.

Zur Erstellung eines HATS-Administrationskonsolenprojekts in HATS Toolkit folgen Sie dem Pfad Datei > Neu > Projekt > HATS > HATS-Verwaltungsprojekt. Sie sollten einen Enterprise Application-Projektnamen angeben, der dieses Projekt eindeutig als HATS-Administrationskonsolenprojekt ausweist. Das HATS-Administrationskonsolenprojekt wird in HATS Toolkit nur auf der Registerkarte Navigator angezeigt. Implementieren Sie die von Ihnen erstellte EAR-Datei in WebSphere Application Server, und starten Sie die Konsole (siehe HATS-Administrationskonsole starten). Informationen zum Ändern des Verwaltungsbereichs für das HATS-Administrationskonsolenprojekt finden Sie in Verwaltungsbereich auswählen.

Weitere Verwaltungsthemen werden in Funktionen des Anzeigeterminals behandelt.

HATS-Administrationskonsole und WebSphere-Sicherheit

Die HATS-Administrationskonsole arbeitet mit einer Java™ Management Extensions-Bean (JMX-Bean), um die Fernverwaltung auszuführen. Wenn die globale Sicherheit von WebSphere Application Server aktiviert ist, werden diese JMX-Aufrufe durch die WebSphere-Sicherheit authentifiziert und müssen eine gültige Berechtigungsebene in WebSphere besitzen. Infolgedessen funktioniert die Fernverwaltung von der HATS-Administrationskonsole aus nicht ordnungsgemäß, wenn die Benutzer-ID nicht als Benutzer der WebSphere Application Server-Administrationskonsole mit der Berechtigung eines Administrators oder Operators definiert ist.

Die HATS-Administrationskonsole ermöglicht Ihnen das Anzeigen und Ändern von Einstellungen für die Fehlerermittlung. Sie ermöglicht außerdem das Anzeigen des Verbindungsstatus sowie das Trennen von Hostverbindungen. Wenn Sie eine HATS-Anwendung mit HATS-Verwaltungsfunktionalität implementieren, können Sie aus Gründen der Sicherheit jede von drei HATS-Rollen bestimmten Systembenutzer-IDs zuordnen. Die drei definierten HATS-Rollen (HATSAdministrator, HATSOperator und HATSMonitor) verfügen jeweils über andere Funktionen in der HATS-Administrationskonsole. Weitere Informationen zu diesem Thema finden Sie in Rollen der HATS-Administrationskonsole.

Ebenso bietet die Administrationskonsole von WebSphere Application Server die Möglichkeit, die Konfiguration der WebSphere Application Server-Umgebung anzuzeigen und zu ändern. Über diese Konsole können Sie Webanwendungen, wie zum Beispiel HATS-Anwendungen, installieren, starten, stoppen und deinstallieren. Anhand verschiedener WebSphere-Konsolenbenutzerrollen (Administrator, Konfigurator, Operator und Monitor) werden verschiedene Funktionen in der Administrationskonsole von WebSphere Application Server bereitgestellt. Über die folgenden Links aus dem Information Center von WebSphere Application Server finden Sie weitere Details zu diesen Sicherheitsrollen und -richtlinien:

Wenn die globale Sicherheit von WebSphere aktiviert ist, können die Benutzer-IDs, die eine HATS-Rolle besitzen, eine Verbindung zur HATS-Administrationskonsole in einer HATS-Anwendung herstellen und Verwaltungstasks nur in der betreffenden HATS-Anwendung ausführen. Wenn der Benutzer versucht, den Verwaltungsbereich zu ändern, um eine andere HATS-Anwendung fern zu verwalten, prüft die WebSphere-Sicherheit die Berechtigung der Benutzer-ID. Wenn die Benutzer-ID keinem gültigen Benutzer mit Administrator- oder Operatorberechtigung in der Administrationskonsole von WebSphere gehört, werden JMX-Aufrufe blockiert und die HATS-Fernverwaltung funktioniert nicht ordnungsgemäß.

Wenn die Benutzer-ID beispielsweise überhaupt nicht als Benutzer der WebSphere Application Server-Administrationskonsole definiert ist oder nur mit Monitorberechtigung definiert ist, werden in der Liste "Anwendung auswählen" unter "Verwaltung" in der HATS-Administrationskonsole keine anderen HATS-Anwendungen angezeigt. In diesem Fall ist es nicht möglich, den Verwaltungsbereich zu ändern, da keine anderen Anwendungen aufgelistet sind.

Ein anderes Beispiel: Wenn die Benutzer-ID als Benutzer der WebSphere Application Server-Administrationskonsole mit der Konfiguratorberechtigung definiert ist, enthält die Liste andere HATS-Anwendungen, sodass der Benutzer den Verwaltungsbereich von einer Anwendung in eine andere ändern kann. Die in der HATS-Administrationskonsole angezeigten Informationen können jedoch falsch sein, und Änderungen, die über die Fernverwaltung versucht werden, treten nicht in Kraft.

Daher sind zwei Optionen zur Verwendung der HATS-Administrationskonsole verfügbar, wenn die globale Sicherheit von WebSphere aktiviert ist.

Option 1: HATS- und WebSphere Application Server-Benutzerrollen voneinander getrennt halten
Wenn Sie keiner der Benutzer-IDs, denen HATS-Rollen zugeordnet sind, eine Administrationsberechtigung in WebSphere Application Server erteilen wollen, müssen Sie die HATS-Administrationskonsole in jede HATS-Anwendung einfügen und jede HATS-Anwendung separat über die HATS-Administrationskonsole für die jeweilige Anwendung verwalten. In diesem Fall ist keine Fernverwaltung möglich.
Option 2: HATS- und WebSphere Application Server-Benutzerrollen kombinieren
Wenn Sie die HATS-Administrationskonsole nur in einer HATS-Anwendung verwenden wollen, um andere HATS-Anwendungen fern zu verwalten, indem Sie den Verwaltungsbereich ändern, müssen die Benutzer-IDs, denen HATS-Rollen zugeordnet sind, auch in WebSphere Application Server als Benutzer der WebSphere-Administrationskonsole entweder mit der Administratorrolle oder der Operatorrolle definiert sein. Diese Benutzer sind in der Lage, den Verwaltungsbereich in der HATS-Administrationskonsole zu ändern, und können die anderen HATS-Administrationstasks ausführen, die für die bestimmte HATS-Rolle, die ihnen zugeordnet ist, zugelassen werden. Darüber hinaus sind die Benutzer auch in der Lage, sich an der WebSphere Application Server-Administrationskonsole anzumelden und WebSphere-Administrationstasks auszuführen, die für die Benutzerrolle in der WebSphere Application Server-Administrationskonsole, die ihnen zugeordnet ist, zugelassen werden.

Für jede dieser Optionen gilt: Bei aktivierter globaler Sicherheit von WebSphere müssen Sie sicherstellen, dass die Option Anwendungssicherheit aktivieren ausgewählt ist. Wählen Sie unter WebSphere Application Server V6.x in der WebSphere-Administrationskonsole die Optionen Sicherheit > Sichere Verwaltung, Anwendungen und Infrastruktur > Anwendungssicherheit > Anwendungssicherheit aktivieren aus. Wählen Sie unter WebSphere Application Server V7.x in der WebSphere-Administrationskonsole die Optionen Sicherheit > Globale Sicherheit > Anwendungssicherheit > Anwendungssicherheit aktivieren aus.

Grundsätzlich gilt, dass bei aktivierter globaler Sicherheit in WebSphere den Benutzer-IDs, denen HATS-Rollen zugeordnet sind, auch Administrator- bzw. Operatorrollen in WebSphere Application Server zugeordnet sein müssen, damit die HATS-Fernverwaltung ordnungsgemäß funktioniert.

Rollen der HATS-Administrationskonsole

Die HATS-Administrationskonsole ist an die WebSphere-Sicherheit gebunden. Dies bedeutet, dass Ihre Systemadministratoren bei aktivierter WebSphere Application Server-Sicherheit über die entsprechende Authentifizierung verfügen müssen, um HATS-Administrationstasks ausführen zu können. Die von HATS verwendeten Sicherheitsfunktionen beruhen auf dem formularbasierten Java EE-Authentifizierungsprozess. Wenn die WebSphere Application Server-Sicherheit aktiviert ist, werden die über die HATS-Administrationskonsole ausführbaren Operationen auf der Basis der für eine Benutzer-ID definierten Rolle eingeschränkt. Zur Verwendung der HATS-Administrationskonsole sind drei Rollen definiert. Jede Rolle verfügt über andere Funktionen.

HATSAdministrator
Diese Rolle besitzt vollständige Verwaltungsberechtigung, mit der alle folgenden Tasks ausgeführt werden können: Standardmäßig wird die Rolle HATSAdministrator „allen authentifizierten" Benutzern zugeordnet.
HATSOperator
Diese Rolle ist mit der Rolle HATSAdministrator äquivalent, kann jedoch nicht auf potenziell sensible Daten zugreifen. Ein Benutzer mit dieser Rolle kann weder die Tracefunktion des Anzeigeterminals aktivieren noch Tracedateien herunterladen.
HATSMonitor
Diese Rolle ermöglicht dem Benutzer nur das Anzeigen nicht sensibler Daten, wie zum Beispiel aktiver Verbindungen, Verbindungspools, Benutzerlisten und Protokollen. Ein Benutzer mit dieser Rolle kann weder Einstellungen, wie zum Beispiel Einstellungen für das Lizenzmanagement, Protokoll- und Tracedateioptionen und Anzeigeterminaleinstellungen, ändern noch Tracedateien herunterladen.

Die Zuordnung von Rollen für Benutzer oder Gruppen von Benutzern erfolgt über die WebSphere-Administrationskonsole.

Stellen Sie unter WebSphere Application Server V6.x sicher, dass für die entsprechende HATS-Rolle in der Anzeige Sicherheitsaufgabenbereiche zu Benutzern oder Gruppen zuordnen die Option Alle authentifizierten ausgewählt ist. Stellen Sie unter WebSphere Application Server V7.x sicher, dass für die entsprechende HATS-Rolle in der Anzeige Sicherheitsaufgabenbereiche zu Benutzern oder Gruppen zuordnen in der Dropdown-Liste Sondersubjekte zuordnen die Option Alle Authentifizierten im Realm der Anwendung ausgewählt ist.

HATS-Administrationskonsole starten

Die HATS-Administrationskonsole ist webbasiert. Sie führen Verwaltungstasks über einen Web-Browser durch eine Benutzerschnittstelle aus, die vom Servlet der HATS-Administrationskonsole HATSAdminServlet bereitgestellt wird.

Zum Starten der HATS-Administrationskonsole laden Sie die folgende URL-Adresse in Ihren Browser: http://host:port/anwendungsname/hatsadmin/admin. Dabei ist host Ihr Hostname, port die Portnummer des HTTP-Transports des Anwendungsservers, auf dem die HATS-Anwendung ausgeführt wird, und anwendungsname der Name einer HATS-Anwendung, die die Administrationsunterstützung enthält.

Anmerkung:
Die Angabe port wird nicht benötigt, wenn URL-Anforderungen an einen Web-Server gerichtet werden, der für WebSphere konfiguriert ist.

Wenn Sie die HATS-Administrationskonsole starten, verwendet sie die Standardsprache des Servers. Sie können jedoch die Sprache ändern, indem Sie Benutzervorgaben im Navigationsrahmen auswählen, die gewünschte Sprache auswählen und den Browser erneut starten. Die neue Sprachauswahl bleibt für den Browser in Kraft, bis Sie eine andere Sprache unter Benutzervorgaben auswählen.

Anmerkungen:
  1. Wenn für den Browser, der auf die HATS-Administrationskonsole zugreift, Cookies inaktiviert werden, treten die folgenden Änderungen auf:
  2. Eine Liste der unterstützten Web-Browser sowie Informationen zu Einschränkungen finden Sie im HATS Information Center unter http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp im Abschnitt "HATS prerequisites".

Administrationskonsole in HATS Toolkit starten

Die HATS-Administrationskonsole kann in HATS Toolkit entweder im Modus "Debug auf Server" oder im Modus "Ausführen auf Server" gestartet werden.

Zum Starten der HATS-Administrationskonsole für ein bestimmtes Projekt klicken Sie mit der rechten Maustaste auf das Projekt in der Sicht HATS-Projekte, und klicken auf Administrationskonsole öffnen.

Wenn das Projekt nicht bereits in einer lokalen Testumgebung ausgeführt wird, wird es im Modus "Debug auf Server" gestartet und eine Web-Browser-Seite mit der URL-Adresse der Administrationskonsole geöffnet.

Wenn das Projekt bereits im Modus "Ausführen auf Server" ausgeführt wird, wird eine Eingabeaufforderung angezeigt, die Sie informiert, dass der Server nicht im Debugmodus ausgeführt wird. Wenn Sie die Option Im aktuellen Modus fortfahren auswählen, wird die Administrationskonsole im Modus "Ausführen auf Server" geöffnet.

Weitere Informationen zur Ausführung in verschiedenen Testmodi finden Sie in Testmodi für Webprojekte im Handbuch HATS Erste Schritte.

Die Laufzeiteinstellungen, die Sie während der Ausführung der Administrationskonsole in HATS Toolkit ändern können, hängen vom Modus ab, den Sie verwenden. Informationen finden Sie in Fehlerermittlungskomponenten verwalten.

Funktionen in der HATS-Administrationskonsole verwenden

Dieser Abschnitt enthält Informationen, die die verschiedenen Funktionen in der HATS-Administrationskonsole erläutern.

Verwaltungsbereich auswählen

Sie können den Verwaltungsbereich auswählen. Die HATS-Administrationskonsole pflegt eine Liste der Verwaltungsbereiche für die Dauer der HTTP-Sitzung (HttpSession). Als erster Verwaltungsbereich wird standardmäßig die HATS Enterprise Application (EAR) ausgewählt, die für den Zugriff auf die HATS-Administrationskonsole verwendet wird. Sie können den Verwaltungsbereich ändern, um andere HATS Enterprise Applications zu verwalten, die in derselben WebSphere-Zelle implementiert sind.

Der Schlüssel zum Ändern des Verwaltungsbereichs besteht darin, die Host- und Portinformationen für die HATS-Administrationskonsole anzugeben, um die installierten HATS Enterprise Applications zu lokalisieren. Der angegebene Portwert muss einen aktiven WebSphere-BOOTSTRAP_ADDRESS-Port bezeichnen. WebSphere-Anwendungsserver, -Knoten und -Zellen besitzen jeweils einen BOOTSTRAP_ADDRESS-Port. Durch die Angabe des Portwerts für eine dieser WebSphere-Ressourcen wird die Verwaltung für die HATS Enterprise Applications aktiviert, die in dieser Ressource implementiert sind. Durch die Angabe eines Hosts und eines Ports eines WebSphere-Knotens wird die Verwaltung aller HATS Enterprise Applications ermöglicht, die auf diesem Knoten installiert sind. Weitere Informationen zum BOOTSTRAP_ADDRESS-Port finden Sie in der Dokumentation zu WebSphere Application Server.

In einer geschützten Umgebung kann einem Administrator die folgende Nachricht in der HATS-Administrationskonsole angezeigt werden, wenn er versucht, den Verwaltungsbereich zu ändern:

Beim Versuch, den ausgewählten Bereich zu verwalten, ist ein Fehler aufgetreten. Es wurden keine HATS-Anwendungen gefunden. Ihr Verwaltungsbereich wurde nicht geändert.

Dies kann daran liegen, dass der Benutzer in einer geschützten WebSphere-Umgebung nicht berechtigt ist, die Kommunikation auszuführen, die erforderlich ist, um die Liste der verfügbaren Anwendungen zu füllen, die verwaltet werden können.

Wenn WebSphere mit dem lokalen Betriebssystem als Benutzerregister arbeitet, muss der Benutzername, der für den Zugriff auf die HATS-Administrationskonsole verwendet wird, Administratorberechtigungen im Register des lokalen Betriebssystems besitzen. Wenn WebSphere mit LDAP als Benutzerregister arbeitet, muss der Benutzername, der für den Zugriff auf die HATS-Administrationskonsole verwendet wird, die Server-ID sein, die von WebSphere für den Zugriff auf LDAP verwendet wird.

Lizenzen verwalten

Unter der Überschrift "Lizenzverwaltung" im linken Navigationsrahmen befinden sich zwei Anzeigen zur Verwaltung von Lizenzinformationen:

Verbindungen verwalten

Es gibt separate Anzeigen unter der Überschrift "Verbindungsverwaltung" im linken Navigationsrahmen, über die Sie die verschiedenen Typen von Verbindungen überwachen können:

Jede Verbindung, die in diesen Anzeigen gezeigt wird, stellt eine Kommunikationsverbindung zu einer Back-End-Datenquelle, wie zum Beispiel eine 3270-Anwendung oder eine Datenbank, dar. In den Anzeigen können Sie Details darüber prüfen, welche Benutzer Verbindungen zu welchen Datenquellen herstellen und welche Verbindungs-IDs verwendet werden. Wenn für eine 3270-Verbindung ein LU- oder ein Poolname vorhanden ist, wird dieser ebenfalls angezeigt. Sie können darüber hinaus Sitzungen beenden.

Verbindungspools überwachen

Die Anzeige "Verbindungspools" unter der Überschrift "Verbindungsverwaltung" im linken Navigationsrahmen zeigt Informationen zu definierten Verbindungspools an. Ein Verbindungspool wird erst angezeigt, wenn mindestens eine Verbindung aus dem Pool zugeordnet ist.

Verbindungspools sind Zusammenschlüsse von DFV-Verbindungen zu Back-End-Datenquellen, wie zum Beispiel 3270-Anwendungen oder Datenbanken. Wenn ein Integrationsobjekt oder eine Anwendung zur Verarbeitung einer Clientanforderung ausgeführt wird, ruft es bzw. sie eine Verbindung aus einem Pool ab, verwendet diese für den Zugriff auf die Datenquelle und gibt anschließend die Verbindung an den Pool zurück. Wenn die Verwendung des Verbindungspools aktiviert ist, wird der Prozessoraufwand zur Einrichtung einer Verbindung nur bei der ersten Verwendung erforderlich. Jede Wiederverwendung dieser Verbindung profitiert von dieser zuvor durchgeführten Herstellung der Verbindung und kann entsprechend schneller erfolgen.

Pooldefinitionen überwachen

Die Anzeige "Verbindungspooldefinitionen" unter der Überschrift "Verbindungsverwaltung" im linken Navigationsrahmen zeigt Informationen zu Pooldefinitionen für Host- und Datenbankverbindungen an. Eine Pooldefinition wird erst aufgeführt, wenn mindestens eine Verbindung aus dem definierten Pool zugeordnet ist.

Eine Pooldefinition stellt Informationen zu einem Zusammenschluss von Verbindungen zu Datenquellen bereit. Einige zugehörige Definitionen sind einer Pooldefinition zugeordnet, wie zum Beispiel Verbindungs- und Makrodefinitionen sowie ein Benutzerlistenname. Die Pooldefinition stellt jedoch nicht nur Zuordnungen zwischen verschiedenen anderen Definitionen her, sondern enthält auch Konfigurationsparameter für alle Verbindungen im Pool, wie zum Beispiel die maximale und die minimale Poolgröße (angegeben als Anzahl der aktiven Verbindungen) sowie Verbindungszeitgeber.

Benutzerlisten und Benutzerlistenmitglieder überwachen

Die Anzeige "Benutzerlisten" unter der Überschrift "Verbindungsverwaltung" im linken Navigationsrahmen enthält Informationen zu Benutzerlisten.

Benutzerlisten geben die Benutzer-IDs und anderen verbindungsspezifischen Parameter an, die einer bestimmten Verbindungspooldefinition zugeordnet sind. Für Systeme, die nur eine einzige Verbindung pro Benutzer-ID zulassen, bestimmt die Anzahl der Benutzer-IDs die Anzahl der Verbindungen, die in einem einzigen Pool aktiv sein können.

Fehlerermittlungskomponenten verwalten

Die HATS-Administrationskonsole bietet Ihnen die Möglichkeit, Protokoll- und Tracedaten zur Unterstützung der Fehlerermittlung zu überwachen. Über die Links unter der Überschrift "Fehlerbehebung" im linken Navigationsrahmen können Sie die Nachrichten im Protokoll anzeigen und Protokoll- und Traceeinstellungen ändern. Eigenschaftendateien enthalten Einstellungen für diese Fehlerermittlungshilfen.

Wenn Sie Einstellungen ändern, während Sie auf die in einer Laufzeitumgebung aktive HATS-Administrationskonsole zugreifen, werden die Änderungen in der Datei "runtime.properties" gespeichert. Obwohl dies nicht empfohlen wird, können Sie die Datei auch direkt bearbeiten, um Einstellungen zu ändern. Die Datei befindet sich im Verzeichnis was-verzeichnis/installedApps/ear-dateiname für eine HATS-Enterprise Application.

Wenn Sie Einstellungen ändern, während Sie auf die in einer lokalen Testumgebung in HATS Toolkit aktive HATS-Administrationskonsole zugreifen, werden die Änderungen in einer von zwei verschiedenen Dateien gespeichert. Im Modus "Ausführen auf Server" werden Änderungen in der Datei "runtime.properties" gespeichert, während sie im Modus "Debug auf Server" in der Datei "runtime-debug.properties" gespeichert werden. Weitere Informationen finden Sie in Administrationskonsole in HATS Toolkit starten. Sie können die Dateien auch direkt bearbeiten, um Einstellungen zu ändern. Die Dateien befinden sich im Stammverzeichnis des EAR-Projekts in HATS Toolkit. Beachten Sie, dass alle Änderungen, die an der Datei "runtime.properties" in HATS Toolkit vorgenommen werden, beibehalten und in Kraft gesetzt werden, wenn Sie die HATS-Anwendung in einer Laufzeitumgebung implementieren. Die Datei "runtime-debug.properties" wird in der Laufzeitumgebung ignoriert.

Anmerkung:
Bei Ausführung auf WebSphere Application Server für z/OS muss die Datei "runtime.properties" mit einem ASCII-Editor bearbeitet werden. Dies kann so geschehen, dass die Datei zum Beispiel mit FTP auf eine Workstation übertragen, dort bearbeitet und anschließend zurück übertragen wird. Zudem ist eine Kopie der Datei "runtime.properties" für jeden aktiven Servant innerhalb eines Anwendungsservers (durch die Adressraum-ID des Server unterschieden) vorhanden. Die Basisdatei "runtime.properties" muss geändert werden, wenn Änderungen über Neustarts des Anwendungsservers hinaus bestehen bleiben sollen.

Weitere Informationen zu Protokoll- und Traceeinstellungen in diesen Dateien finden Sie in Anhang A. Eigenschaftendateien für die Laufzeit.

Protokoll- und Tracedateinamen

Die Basisdateinamen für Protokoll- und Tracedateinamen in der Datei "runtime.properties" werden als Schablonen zur Generierung eindeutiger Sätze von Protokoll- und Tracedateien für jeden Anwendungsserver verwendet. Der Standardbasisname für Tracedateien lautet trace.txt, der Standardbasisname für Protokolldateien messages.txt. An den Basisdateinamen wird der Anwendungsservername angehängt, um die Schablone für die Protokoll- und Tracedateien für einen Anwendungsserver zu generieren. Der Anwendungsservername ist derselbe wie der vollständig qualifizierte Name des Anwendungsservers, wie er von WebSphere definiert wird. Dieser Name hat das Format zelle_knoten_server. Dabei gilt:

Der Name des Anwendungsservers, auf dem HATS ausgeführt wird, setzt sich aus der Verkettung des Unterstreichungszeichens (_) mit dem Anwendungsservernamen und einem weiteren Unterstreichungszeichen (_) zusammen.

Bei der im Beispiel genannten Tracedatei ergibt sich zum Beispiel der Name trace _zelle_knoten_server_.txt. Schließlich wird ein Index (1, 2, 3 usw.) an diesen Namen angehängt, um mehrere Dateien voneinander zu unterscheiden. Wenn mehrere Tracedateien konfiguriert sind, heißen die Tracedateien für den betreffenden Anwendungsserver trace_zelle_knoten_server_1.txt, trace_zelle_knoten_server_2.txt usw.

Anmerkung:
Bei der Ausführung auf WebSphere Application Server für z/OS kann auf einem Anwendungsserver mehr als ein Servant ausgeführt werden, wobei jeder Servant eindeutige Protokoll- und Tracedateien generiert. Zu ihrer Unterscheidung wird der Serverkomponente des Namens die Adressraum-ID (ASID) des Servants vorangestellt (Beispiel: trace_asid_1.txt).

Protokoll anzeigen

Über die Anzeige "Protokoll anzeigen" können Sie die HATS-Protokolldatei prüfen, die gesamte Datei herunterladen oder den Inhalt der Datei löschen. Die Protokolldatei zeichnet Informationen über zwei Arten von Ereignissen auf:

Fehlerereignisse
Fehler, die die Ausführung einer Operation verhindern. Fehlerereignisse haben in der Regel zur Folge, dass Sie eine Maßnahme zur Fehlerkorrektur ausführen müssen.
Warnungsereignisse
Unerwartete Vorkommnisse, die möglicherweise eine Maßnahme zur Fehlerkorrektur erfordern. Warnungsereignisse sind nicht so schwer wiegend wie Fehlerereignisse.

Die Protokolldatei dient dem Zweck, lesbare Informationen zu Ihrer Referenz bereitzustellen, wenn Sie Fehler ermitteln. Die meisten Nachrichten, die im Protokoll erfasst werden, sind im Handbuch HATS Nachrichten dokumentiert. Dieses Handbuch enthält Vorschläge für Maßnahmen, die Sie bei Bedarf zur Korrektur von Fehlern ergreifen können.

Anmerkung:
Unter Windows® können Sie die Standardausgabe und die Standardfehlerprotokolle während der Ausführung von HATS-Anwendungen nicht umbenennen oder löschen. Wenn Sie diese Protokolle im Rahmen Ihrer Fehlerbehebungsverfahren umbenennen oder löschen wollen, um Plattenspeicherplatz freizugeben oder die Größe einer Informationspaketdatei zu minimieren, müssen Sie den Anwendungsserver stoppen, der HATS darstellt. Der WebSphere-Knoten kann jedoch aktiv bleiben.

Protokolloptionen festlegen

Über die Anzeige "Protokolleinstellungen" können Sie steuern, ob Informations- und Warnungsereignisse in die Protokolldatei geschrieben werden, und die Datei definieren, in die die Protokollereignisse geschrieben werden. Informationen über die Benennung von Protokolldateien finden Sie in Protokoll- und Tracedateinamen. Wenn die Datei bereits vorhanden ist, werden neue Ereignisse an sie angehängt. Fehlerereignisse werden in jedem Fall in die Protokolldatei geschrieben. Sie können außerdem die Anzahl der zu verwaltenden Protokolldateien und die Maximalgröße jeder Protokolldatei definieren.

Traceoptionen festlegen

Über die Anzeige "Traceeinstellungen" können Sie eine oder mehrere der folgenden Typen von Traceoptionen auswählen:

Laufzeittrace aktivieren
Aktiviert den Trace in der HATS-Laufzeit für Verbindungen in Ihrem Projekt. Wenn Sie Traces für Laufzeitverbindungen auf einer anderen Stufe durchführen wollen, finden Sie Informationen zu den Traceeinstellungen in Anhang A. Eigenschaftendateien für die Laufzeit.
Trace für Fensterobjekte aktivieren
Aktiviert den Trace in der HATS-Laufzeit für Fensterobjekte in Ihrem Projekt. Wenn Sie Traces für Fensterobjekte auf einer anderen Stufe durchführen wollen, finden Sie Informationen zu den Traceeinstellungen in Anhang A. Eigenschaftendateien für die Laufzeit.
Trace für Aktionen aktivieren
Aktiviert den Trace in der HATS-Laufzeit für Ereignisaktionen in Ihrem Projekt. Wenn Sie Traces für Ereignisse auf einer anderen Stufe durchführen wollen, finden Sie Informationen zu den Traceeinstellungen in Anhang A. Eigenschaftendateien für die Laufzeit.
Trace für Komponenten aktivieren
Aktiviert den Trace in der HATS-Laufzeit für Komponenten in Ihrem Projekt. Wenn Sie Traces für Komponenten auf einer anderen Stufe durchführen wollen, finden Sie Informationen zu den Traceeinstellungen in Anhang A. Eigenschaftendateien für die Laufzeit.
Trace für Dienstprogramme aktivieren
Aktiviert den Trace in der HATS-Laufzeit für Laufzeitdienstprogramme in Ihrem Projekt. Wenn Sie Traces für diese Laufzeitdienstprogramme auf einer anderen Stufe durchführen wollen, finden Sie Informationen zu den Traceeinstellungen in Anhang A. Eigenschaftendateien für die Laufzeit.
Trace für Integrationsobjekte
Aktiviert den Trace in bestimmten Integrationsobjekten in Ihrem Projekt. Geben Sie im Feld "Klassenname" die Integrationsobjekte an, für die der Trace durchzuführen ist, indem Sie ein oder mehrere Muster verwenden. Jedes Muster kann ein oder mehrere Platzhalterzeichen (*) enthalten. Wenn Sie zum Beispiel 'IntegrationObject.Callup*' eingeben, wird der Trace für alle Integrationsobjekte aktiviert, die mit den Buchstaben Callup beginnen. Soll der Trace für alle Integrationsobjekte erfolgen, geben Sie 'IntegrationObject.*' an. Wenn mehrere Muster angegeben werden, müssen sie durch Kommata voneinander getrennt werden. Die HATS-Administrationskonsole setzt die Integrationsobjekteinstellung auf die höchste Tracestufe. Wenn Sie Traces für Integrationsobjekte auf einer anderen Stufe durchführen wollen, finden Sie Informationen zu den Traceeinstellungen in Anhang A. Eigenschaftendateien für die Laufzeit.
Applet-Trace
Aktiviert den Trace für das Applet. Eine höhere Stufe von Trace generiert mehr Traceinformationen. Wenn der Applet-Trace aktiviert ist, gibt er serverseitige Nachrichten zur Fehlerbehebung aus. Weitere Informationen zu Applet-Traceeinstellungen finden Sie in Anhang A. Eigenschaftendateien für die Laufzeit.
Trace für Benutzermakros
Aktiviert den Trace für die Wiedergabe von Makros. Da dieser Trace Auswirkungen auf die Systemleistung hat, ist zu empfehlen, diesen Trace nur zum Debugging von Makros zu verwenden.
Anzeigeterminal
Bietet Ihnen die Möglichkeit, die Host-Terminalanzeige einer beliebigen Verbindung anzuzeigen, wie sie in Echtzeit auf dem Server ausgeführt wird. Wenn Sie den Anzeigeterminal aktiviert haben, werden die Terminaleinstellungen nur für neu erstellte Verbindungen angezeigt. Weitere Informationen zum Anzeigeterminal finden Sie in Anzeigeterminal zum Testen und Debugging verwenden.
Anmerkung:
Sie können entscheiden, ob HATS einen Dialog anzeigen soll, der Sie fragt, ob das Anzeigeterminal aktiviert werden soll, wenn Sie im Modus "Ausführen auf Server" arbeiten. Weitere Informationen finden Sie unter HATS-Benutzervorgaben verwenden.
Trace für die Hostsimulation aufzeichnen
Wählen Sie das Markierungsfeld Aufzeichnung der Hostsimulation aktivieren aus, um die Aufzeichnung der Hostsimulation während der Laufzeit zu aktivieren. Die Aufzeichnung beginnt beim nächsten Start einer Hostsitzung und endet mit dem Schließen der Hostsitzung, zum Beispiel wenn der Benutzer auf den Knopf zum Trennen der Verbindung auf dem Anwendungstastenblock klickt. Wenn der Benutzer den Web-Browser schließt, während der Trace aktiv ist, wird der Trace fortgesetzt, bis die HTTP-Sitzung das Zeitlimit überschreitet. Die Tracedatei wird im Ordner für Hostsimulationen auf dem Server gespeichert. Beispiel: <websphere-installationsstammverzeichnis>\AppServer\profiles\AppSrv01\installedApps\<knoten-id>\<ear-dateiname>\<anwendungsname>.war\WEB-INF\profiles\hostsimulations. Tracedateien werden nach folgender Schablone benannt: anwendungsname_verbindungsname_datum(jjjjmmtt)_zeit(hhmmss)_nummer. Beispiel: MeineAnwendung_main_20060101_134543_1.

Zur gleichzeitigen Generierung von Traces für mehrere Hostsitzungen arbeitet die Hostsimulation mit mehreren TCP/IP-Ports. In den Feldern TCP/IP-Portbereich für Aufzeichnung können Sie den Bereich der Portnummern zur Verwendung durch den Server während der Laufzeit festlegen. Der Standardanfangsport des Bereichs ist 7021, der Standardendport ist 7050.

IBM Service-Traceoptionen
Die HATS-Administrationskonsole enthält auch ein Markierungsfeld IBM Service-Traceoptionen aktivieren, mit dessen Hilfe Sie Traces aktivieren können (sofern Sie vom IBM Service entsprechend angewiesen werden). Sie sollten diese Traces nur verwenden, wenn Sie durch den IBM Service dazu aufgefordert werden.
Traceausgabe
Über diese Option können Sie steuern, ob Traceinformationen in die Tracedatei geschrieben werden, und die Datei definieren, in die Protokollereignisse geschrieben werden. Informationen über die Benennung von Tracedateien finden Sie in Protokoll- und Tracedateinamen. Wenn die Datei bereits vorhanden ist, werden neue Traceinformationen an sie angehängt. Sie können außerdem die Anzahl der zu verwaltenden Tracedateien und die Maximalgröße jeder Tracedatei definieren.

Funktionen des Anzeigeterminals

Anzeigeterminal zum Testen und Debugging verwenden

Beim Debugging von Anwendungen auf einem Testsystem können Sie steuern, ob ein Terminalfenster auf der Serveranzeige erstellt wird, in dem Hostanzeigen gezeigt werden. Sie können im Terminalfenster dargestellte Hostanzeigen zur Beobachtung der Interaktionen zwischen den HATS-Anwendungen und der Hostanwendung zur Laufzeit verwenden. Darüber hinaus können Sie auch mit der Hostanwendung über die Hostanzeige im Terminalfenster interagieren. Terminalanzeigen werden nur für Verbindungen erstellt, die hergestellt werden, während diese Option aktiviert ist. Sie werden nicht für bestehende Verbindungen oder für nicht genutzte Verbindungen im Leerlauf erstellt. Die Anzeige "Hostverbindungen" in der HATS-Administrationskonsole enthält jedoch einen Knopf Anzeigeterminal umschalten, über den das Anzeigeterminal für ausgewählte Verbindungen aktiviert bzw. inaktiviert werden kann.

Vorsicht:
Die Aktivierung der Option Anzeigeterminal kann sich schwer wiegend auf die Leistung auswirken oder den Server überlasten. Verwenden Sie diese Option nicht auf Servern mit vielen Verbindungen. Das Anzeigeterminal ist zur Verwendung beim Debugging während der Anwendungsentwicklung auf einem Testsystem gedacht. Es ist nicht zur Verwendung auf einem hoch ausgelasteten Produktionsserver vorgesehen.

Sie können das Anzeigeterminal für beliebige neue Hostverbindungen aktivieren, indem Sie das Markierungsfeld Anzeigeterminal aktivieren auf der Anzeige Traceeinstellungen unter der Überschrift Fehlerbehebung im linken Navigationsrahmen auswählen. Über die Option Anzeigeterminal umschalten der Anzeige Hostverbindungen können Sie jedoch das Anzeigeterminal für eine bestimmte Verbindung jederzeit aktivieren bzw. inaktivieren, unabhängig davon, ob Sie das Markierungsfeld Anzeigeterminal aktivieren der Anzeige Traceeinstellungen ausgewählt haben.

Anmerkungen:
  1. Für eine ordnungsgemäße Funktion des Anzeigeterminals, wenn WebSphere Application Server auf der Windows-Plattform als Dienst gestartet wird, müssen Sie die Option Datenaustausch zwischen Dienst und Desktop zulassen in den Diensteigenschaften für WebSphere Application Server auswählen.
  2. Informationen zur Anzeige von Grafiken, die für die Anzeigeterminalfunktion bei Verwendung von Native Abstract Windowing Toolkit (NAWT) auf der IBM i-Plattform erforderlich sind, finden Sie im Abschnitt zur Ausführung einer Java-Anwendung auf einem Host, der keine grafische Benutzerschnittstelle hat, im Dokument System i Programming IBM Developer Kit for Java unter der Adresse http://publib.boulder.ibm.com/infocenter/iseries/v5r4/topic/rzaha/rzaha.pdf.
  3. Informationen zur Konfiguration der Anzeigeterminalfunktionen auf anderen Plattformen finden Sie im HATS Information Center unter http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp im Abschnitt System i, System z, and Unix platform-specific information.