Anhang A. Eigenschaftendateien für die Laufzeit

Laufzeiteinstellungen, wie zum Beispiel Protokoll-, Trace- und Lizenzeinstellungen, werden in einer von zwei verschiedenen Dateien gespeichert:

Weitere Informationen zur Verwaltung von Laufzeiteinstellungen für Webanwendungen finden Sie in Fehlerermittlungskomponenten verwalten. Weitere Informationen zur Verwaltung von Laufzeiteinstellungen für Rich-Client-Anwendungen finden Sie in HATS-Rich-Client-Anwendungen verwalten.

Die Dateien "runtime.properties" und "runtime-debug.properties" enthalten die folgenden Eigenschaften.

adminPortNum
Die Eigenschaft "adminPortNum" ist der Standardwert, der von der HATS-Administrationskonsole verwendet wird, wenn der Verwaltungsbereich geändert werden soll. Der Portwert muss einen aktiven WebSphere-BOOTSTRAP_ADDRESS-Port bezeichnen. Der Standardwert ist 2809, d. h. der BOOTSTRAP_ADDRESS-Standardport von "server1" für eine WebSphere-Basisinstallation bzw. des Knotenagentenservers, wenn Sie einen Anwendungsserverknoten in eine Deployment Manager-Zelle einbinden.
ioPatternKey  Nur Web 
Ein oder mehrere Muster, die die zu verfolgenden Integrationsobjekte angeben. Siehe die nachfolgende Beschreibung zu trace.INTEGRATIONOBJECT.

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.

numLicenses
Gibt die Anzahl der von Ihnen erworbenen Lizenzen an. HATS verfolgt die Anzahl von HATS-Verbindungen zu Hostressourcen und protokolliert eine Nachricht, wenn der Wert die Anzahl der erworbenen Lizenzen überschreitet.

Der Wert ist eine ganze Zahl. Es gibt keinen Standardwert. Gültige Werte für Lizenzen berechtigter Benutzer liegen im Bereich von 1 - 50000. Für Werteinheitlizenzen (Value Unit-Lizenzen) muss der Wert -1 sein.

licenseHardLimit
Ein verschlüsseltes Feld, das die HATS-Lizenzberechtigung enthält. Ändern Sie dieses Feld nicht manuell.
licenseTracking
Gibt an, ob HATS die Lizenznutzung aufzeichnet oder nicht. Der Wert ist binär. Der Standardwert ist 0.
0
HATS zeichnet die Lizenznutzung nicht auf.
1
HATS zeichnet die Lizenznutzung für alle Anwendungsserver in einem Knoten auf. HATS verfolgt die Anzahl von HATS-Verbindungen zu Host- bzw. Datenbankressourcen und protokolliert eine Nachricht, wenn der Wert die Anzahl der erworbenen Lizenzen überschreitet. Die Informationen zur Lizenznutzung werden in eine Datei mit dem Namen "licensex.txt" im Verzeichnis log des HATS-Installationsverzeichnisses auf dem Server geschrieben. Dabei hat x entweder den Wert 1 oder den Wert 2.

Die maximale Größe der Lizenznutzungsdateien beträgt 512 KB. Wenn die Dateigröße der Datei "license1.txt" den Wert von 512 KB erreicht oder wenn der HATS-Server erneut gestartet wird, wird die Datei in "license2.txt" umbenannt und eine neue Datei "license1.txt" erstellt. Die neue Datei "license1.txt" enthält die aktuellsten Lizenznutzungsinformationen. Wenn die neue Datei "license1.txt" die Größe von 512 KB erreicht und umbenannt wird, wird die alte Datei "license2.txt" gelöscht.

Die Lizenznutzungsdateien enthalten die folgenden Informationen, die in Zeilen angeordnet sind, die jeweils eine Betriebsstunde darstellen. Die Werte werden durch ein Leerzeichen ( ) voneinander getrennt.

  1. Datum
  2. Uhrzeit
  3. Die höchste Lizenzanzahl seit dem Starts des Servers
  4. Die höchste Lizenzanzahl in der letzten Stunde (das Maximum der letzten 60 Einträge)
  5. Die Lizenzanzahl für jede Minute (1-60)
licenseFile
Der Name, der als Schablone zur Generierung von Namen für Lizenzdateien zur Aufzeichnung von Lizenznutzungsinformationen verwendet wird. Der Standardwert für diese Eigenschaft ist "license.txt".
logFile
Der Name, der als Schablone zur Generierung von Namen für die einzelnen Sätze von Anwendungsserverdateien verwendet wird, in die Protokollnachrichten geschrieben werden. Der Standardbasisname für eine Protokolldatei ist messages.txt.
maxLogFiles
Die maximale Anzahl von Nachrichtendateien. Der Standardwert ist 2.

Der Basisname für Protokolldateien in der Datei "runtime.properties" wird als Schablone zur Generierung eindeutiger Sätze von Nachrichtenprotokolldateien für die einzelnen Anwendungsserver verwendet. Der Standardbasisname für eine Protokolldatei kann in der Datei "runtime.properties" geändert werden. Der Name des Anwendungsservers, auf dem HATS ausgeführt wird, ist die Verkettung der folgenden Namensteile: Unterstreichungszeichen (_), gefolgt vom Namen der HATS-Instanz, gefolgt von einem weiteren Unterstreichungszeichen (_).

Die HATS-Instanz-ID (z. B. _SSS_) wird dann an den Basisdateinamen angehängt, um die Schablone für die Protokolldateien eines Anwendungsservers zu generieren. Für die Protokolldatei wird auf diese Weise der Name messages _SSS_.txt generiert. Schließlich wird an diesen Namen noch ein Index (1, 2, 3 usw.) angehängt, um mehrere Dateien voneinander zu unterscheiden. Wenn zum Beispiel die HATS-Instanz-ID zelle_knoten_server lautet, erhält die Protokolldatei für den Anwendungsserver den Namen messages_zelle_knoten_server_.txt. Wenn mehrere Protokolldateien konfiguriert sind, lauten die Protokolldateinamen für diesen Anwendungsserver messages_zelle_knoten_server_1.txt, messages_zelle_knoten_server_2.txt usw.

Wenn die Datei messages_zelle_knoten_server_1.txt den Wert von "maxLogFileSize" erreicht, wird sie geschlossen und in messages_zelle_knoten_server_2.txt umbenannt. Eine neue Datei messages_zelle_knoten_server_1.txt wird geöffnet.

Wenn die Datei messages_zelle_knoten_server_1.txt erneut den für "maxLogFileSize" festgelegten Wert erreicht, werden die vorherigen Dateien umbenannt. Zum Beispiel wird dann die Datei messages_zelle_knoten_server_2.txt in messages_zelle_knoten_server_3.txt umbenannt. Anschließend wird die Datei messages_zelle_knoten_server_1.txt in messages_zelle_knoten_server_2.txt umbenannt und eine neue Datei messages_zelle_knoten_server_1.txt geöffnet.

Wenn der Wert von "maxLogFiles" überschritten wird, wird die älteste Datei gelöscht.

Anmerkung:
Bei der Ausführung auf einem WebSphere Application Server für z/OS enthält der Serverteil des Protokolldateinamens auch die Adressraum-ID (Address Space ID) des Servants, der in das Protokoll schreibt (Beispiel: messages_asid_1.txt). Detaillierte Informationen dazu finden Sie in Protokoll- und Tracedateinamen.
maxLogFileSize
Gibt die maximale Größe (in KB) an, die eine Nachrichtenprotokolldatei erreicht, bevor eine weitere Protokolldatei geöffnet wird.

Der Wert ist eine ganze Zahl. Der Standardwert ist 512 KB.

traceFile
Der Name, der als Schablone zur Generierung von Namen für Dateien verwendet wird, in die HATS-Tracenachrichten geschrieben werden. Der Standardbasisname für eine Tracedatei ist trace.txt.
maxTraceFiles
Die maximale Anzahl von Traceinformationsdateien. Der Standardwert ist 5.

Der Basisname für Tracedateien in der Datei "server.properties" wird als Schablone zur Generierung eindeutiger Sätze von Tracedateien für die einzelnen Anwendungsserver verwendet. Der Standardbasisname für eine Tracedatei kann in der Datei "runtime.properties" geändert werden. Der Name des Anwendungsservers, auf dem HATS ausgeführt wird, ist die Verkettung der folgenden Namensteile: Unterstreichungszeichen (_), gefolgt vom Namen der HATS-Serverinstanz, gefolgt von einem weiteren Unterstreichungszeichen (_).

Die HATS-Serverinstanz-ID (z. B. _SSS_) wird dann an den Basisdateinamen angehängt, um die Schablone für die Tracedateien eines Anwendungsservers zu generieren, sodass sich der Name trace _SSS_.txt ergibt. Schließlich wird ein Index (1, 2, 3 usw.) an diesen Namen angehängt, um mehrere Tracedateien voneinander zu unterscheiden. Wenn zum Beispiel die HATS-Serverinstanz-ID zelle_knoten_server lautet, erhält die Tracedatei für den Anwendungsserver den Namen trace_zelle_knoten_server_.txt. 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.

Wenn die Datei trace_zelle_knoten_server_1.txt den Wert von "maxTraceFileSize" erreicht, wird sie geschlossen und in trace_zelle_knoten_server_2.txt umbenannt. Eine neue Datei trace_zelle_knoten_server_1.txt wird geöffnet.

Wenn die Datei trace_zelle_knoten_server_1.txt den Wert von "maxTraceFileSize" erneut erreicht, werden die vorherigen Dateien umbenannt. Zum Beispiel wird trace_zelle_knotne_server_2.txt in trace_zelle_knoten_server_3.txt umbenannt. Anschließend wird die Datei trace_zelle_knoten_server_1.txt in trace_zelle_knoten_server_2.txt umbenannt und eine neue Datei trace_zelle_knoten_server_1.txt geöffnet.

Wenn der Wert von "maxTraceFiles" überschritten wird, wird die älteste Datei gelöscht.

Anmerkung:
Bei der Ausführung auf einem WebSphere Application Server für z/OS enthält der Serverteil des Tracedateinamens auch die Adressraum-ID (Address Space ID) des Servants, der in das Protokoll schreibt (Beispiel: trace_asid_1.txt). Detaillierte Informationen dazu finden Sie in Protokoll- und Tracedateinamen.
maxTraceFileSize
Gibt die maximale Größe (in KB) an, die eine Tracedatei erreicht, bevor eine weitere Tracedatei geöffnet wird.

Der Wert ist eine ganze Zahl. Der Standardwert ist 10240 KB.

traceLogDirectory
Legt das zum Schreiben von Protokoll- und Traceausgaben zu verwendende Verzeichnis fest, wenn die Anwendungs-EAR-Datei implementiert wird. Wenn dieses Schlüsselwort nicht angegeben wird bzw. der angegebene Wert ungültig ist, wird das Verzeichnis logs verwendet und unterhalb des Installationsverzeichnisses der EAR-Datei angelegt. Dieser Wert wird nur verwendet, wenn die EAR-Datei in einem Anwendungsserver implementiert ist. Innerhalb der Toolkit-Umgebung hat dieser Wert keine Wirkung.
maxHODThreadManagerThreads
Legt die maximale Anzahl von Threads fest, die im Thread-Pool des Host On-Demand-Thread-Managers erstellt werden können. Hierbei können Sie einen Wert zwischen 10 und 10000 angeben. Bei Angabe eines Werts außerhalb dieses Bereichs wird die vorgenommene Einstellung ignoriert und stattdessen der Standard-HOD-Wert 10000 verwendet.

Traceoptionen

Die Werte für die Tracestufe, die von den in diesem Abschnitt beschriebenen Traceoptionen verwendet werden, stellen eine Hexadezimalziffernfolge dar. Jedes Bit der Ziffernfolge steuert einen Tracetyp für die Laufzeit. Die Standardwerte lautet:

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

Nachstehend finden Sie die Definitionen für jedes Bit in der Tracemaske:

x000001  - Informationsnachrichten
x000002  - Warnungen
x000004  - Fehlernachrichten
x000008  - Kritische Fehlernachrichten
x000010  - API-Traces
x000020  - Callback-API-Traces
x000080  - Methodeneintrag
x000100  - Methodenexit
x000200  - Ausnahmebedingungen
x000400  - Verschiedene Traces
x000800  - Objekterstellung
x001000  - Objektentsorgung
x020000  - Leistungstrace - ausschließlich diesen Wert verwenden
x040000  - Verschiedene Daten - Ebene 1
x080000  - Verschiedene Daten - Ebene 2
x100000  - Verschiedene Daten - Ebene 3

Addieren Sie zum Anpassen der Werte der Tracestufe die Hexadezimalwerte in der Tracemaske. Wenn Sie beispielsweise tracelevel.9=180 angeben und anschließend trace.RUNTIME=9 verwenden, werden nur Laufzeittraces für Methodeneinträge und Methodenexits ausgeführt.

trace.RUNTIME
Gibt die Tracestufe für die Hauptlaufzeit (RUNTIME) sowie für alle Einstellungen unter RUNTIME.* an, für die keine Tracestufe angegeben ist.

Der Wert ist eine ganze Zahl aus dem Bereich von 0-9. Der Standardwert ist 0 und bedeutet, dass kein Laufzeittrace ausgeführt wird.

trace.RUNTIME.ACTION
Gibt die Tracestufe für Ereignisaktionen an. Diese Einstellung überschreibt die Einstellung für "trace.RUNTIME".

Der Wert ist eine ganze Zahl aus dem Bereich von 0-9. Der Standardwert ist 0 und bedeutet, dass kein Ereignisaktionstrace ausgeführt wird.

trace.TRANSFORM
Gibt die Tracestufe für HATS-Umsetzungen sowie für alle Einstellungen unter TRANSFORM.* an, für die keine Tracestufe angegeben ist.

Der Wert ist eine ganze Zahl aus dem Bereich von 0-9. Der Standardwert ist 0 und bedeutet, dass kein Umsetzungstrace ausgeführt wird.

trace.TRANSFORM.COMPONENT
Gibt die Tracestufe für HATS-Komponenten an. Diese Einstellung überschreibt die Einstellung für "trace.TRANSFORM".

Der Wert ist eine ganze Zahl aus dem Bereich von 0-9. Der Standardwert ist 0 und bedeutet, dass kein Komponententracing ausgeführt wird.

trace.TRANSFORM.WIDGET
Gibt die Tracestufe für HATS-Fensterobjekte an. Diese Einstellung überschreibt die Einstellung für "trace.TRANSFORM".

Der Wert ist eine ganze Zahl aus dem Bereich von 0-9. Der Standardwert ist 0 und bedeutet, dass kein Fensterobjekttracing ausgeführt wird.

trace.INTEGRATIONOBJECT  Nur Web 
Gibt die Tracestufe für Integrationsobjekte an.

Der Wert ist eine ganze Zahl aus dem Bereich von 0-9. Der Standardwert ist 0 und bedeutet, dass kein Integrationsobjekttrace ausgeführt wird.

trace.UTIL
Gibt die Tracestufe für HATS-Laufzeitdienstprogramme an.

Der Wert ist eine ganze Zahl aus dem Bereich von 0-9. Der Standardwert ist 0 und bedeutet, dass kein Laufzeitdienstprogramm-Tracing ausgeführt wird.

trace.APPLET  Nur Web 
Gibt die Tracestufe für das Applet an.

Der Wert ist eine ganze Zahl. Dabei gilt Folgendes:

0
Es wird kein Trace ausgeführt.
3
Ein Trace mit der Mindesttracestufe wird ausgeführt.
5
Ein normaler Trace wird ausgeführt.

Der Standardwert ist 0.

Traceverarbeitung für Host On-Demand

trace.HOD.COMMEVENT
Gibt die Tracestufe für die Host On-Demand COMM-Ereignisse an.
0
Der Host On-Demand COMM-Ereignistrace ist nicht aktiviert.
1
Der Host On-Demand COMM-Ereignistrace ist aktiviert.

Der Wert ist binär. Der Standardwert ist 0.

trace.HOD.DISPLAYTERMINAL
Gibt an, ob Host On-Demand ein Terminalfenster für jede Verbindung anzeigt.
0
Host On-Demand zeigt nicht für jede Verbindung ein Terminalfenster an.
1
Host On-Demand zeigt für jede Verbindung ein Terminalfenster an.

Der Wert ist binär. Der Standardwert ist 0.

Wenn "trace.HOD.DISPLAYTERMINAL" den Wert 1 hat, erstellt HATS beim Erstellen einer Hostverbindung (z. B. als Antwort auf eine Anforderung von einer Anwendung) automatisch eine Host-Terminalanzeige. Wenn diese Eigenschaft auf den Wert 0 gesetzt wird, geschieht dies nicht. Ein HATS-Administrator kann jedoch unabhängig davon, ob die Host-Terminalanzeige bei der Erstellung der Hostverbindung automatisch erstellt wird, über die HATS-Administrationskonsole Host-Terminalanzeigen für einzelne Hostverbindungen aktivieren oder inaktivieren.

trace.HOD.DS
Gibt die Tracestufe für den Host On-Demand-Datenstromtrace an.

Der Wert ist eine ganze Zahl aus dem Bereich von 0 bis 3. Dabei gilt:

0
Es wird kein Trace ausgeführt.
1
Ein Trace mit der Mindesttracestufe wird ausgeführt.
2
Ein normaler Trace wird ausgeführt.
3
Ein Trace mit der maximalen Tracestufe wird ausgeführt.

Der Standardwert ist 0.

trace.HOD.MACRO
Gibt die Tracestufe für Host On-Demand-Makros an.

Der Wert ist eine ganze Zahl aus dem Bereich von 0 bis 2. Dabei gilt:

0
Der Host On-Demand-Makrotrace ist nicht aktiviert.
1
Der Host On-Demand-Ereignistrace ist aktiviert.
2
Der Host On-Demand-Unterstützungstrace ist aktiviert.

Der Standardwert ist 0.

trace.HOD.PS
Gibt die Tracestufe für den Host On-Demand-Darstellungsbereich an.

Der Wert ist eine ganze Zahl aus dem Bereich von 0 bis 3. Dabei gilt:

0
Es wird kein Trace ausgeführt.
1
Ein Trace mit der Mindesttracestufe wird ausgeführt.
2
Ein normaler Trace wird ausgeführt.
3
Ein Trace mit der maximalen Tracestufe wird ausgeführt.

Der Standardwert ist 0.

trace.HOD.PSEVENT
Gibt die Tracestufe für Host On-Demand PS-Ereignisse an.
0
Der Host On-Demand PS-Ereignistrace ist nicht aktiviert.
1
Der Host On-Demand PS-Ereignistrace ist aktiviert.

Der Wert ist binär. Der Standardwert ist 0.

trace.HOD.OIAEVENT
Gibt die Tracestufe für Host On-Demand OIA-Ereignisse an.
0
Der Host On-Demand OIA-Ereignistrace ist nicht aktiviert.
1
Der Host On-Demand OIA-Ereignistrace ist aktiviert.

Der Wert ist binär. Der Standardwert ist 0.

trace.HOD.SESSION
Gibt die Tracestufe für Host On-Demand-Sitzungen an.

Der Wert ist eine ganze Zahl aus dem Bereich von 0 bis 3. Dabei gilt:

0
Es wird kein Trace ausgeführt.
1
Ein Trace mit der Mindesttracestufe wird ausgeführt.
2
Ein normaler Trace wird ausgeführt.
3
Ein Trace mit der maximalen Tracestufe wird ausgeführt.

Der Standardwert ist 0.

trace.HOD.TRANSPORT
Gibt die Tracestufe für den Host On-Demand-Transport an.

Der Wert ist eine ganze Zahl aus dem Bereich von 0 bis 3. Dabei gilt:

0
Es wird kein Trace ausgeführt.
1
Ein Trace mit der Mindesttracestufe wird ausgeführt.
2
Ein normaler Trace wird ausgeführt.
3
Ein Trace mit der maximalen Tracestufe wird ausgeführt.

Der Standardwert ist 0.

trace.HOD.USERMACRO
Gibt die Tracestufe für Traceaktionen in Host On-Demand-Benutzermakros an.

Der Wert ist eine ganze Zahl aus dem Bereich von 0 bis 3. Dabei gilt:

0
Es wird kein Trace ausgeführt.
1
Ein Trace mit der Mindesttracestufe wird ausgeführt.
2
Ein normaler Trace wird ausgeführt.
3
Ein Trace mit der maximalen Tracestufe wird ausgeführt.

Der Standardwert ist 0.

Trace für die Hostsimulation

recordSimulationTrace
Gibt an, ob die Simulationstraceaufzeichnung während der Laufzeit aktiviert ist.
0
Die Traceaufzeichnung für die Hostsimulation ist nicht aktiviert.
1
Die Traceaufzeichnung für die Hostsimulation ist aktiviert.

Der Wert ist binär. Der Standardwert ist 0.

startPort
Gibt den Anfangsport des Portbereichs an, der während der Laufzeit zum Ausführen der Traceaufzeichnung für die Hostsimulation für mehrere gleichzeitig laufende Hostsitzungen verwendet werden soll. Der Standardwert für den Port ist 7021.
endPort
Gibt den Endport des Portbereichs an, der während der Laufzeit zum Ausführen der Traceaufzeichnung für die Hostsimulation für mehrere gleichzeitig laufende Hostsitzungen verwendet werden soll. Der Standardwert für den Port ist 7050.