Traceverarbeitung

Mit den Parametern im Abschnitt TRACING der Datei können Sie die Traceerstellung für InterChange Server-Komponenten aktivieren bzw. inaktivieren und die Tracestufe angeben.

DB_CONNECTIVITY

Dieser Parameter gibt die Stufe der Traceerstellung für die Interaktionen zwischen dem Datenbankkonnektivitätsservice von InterChange Server und dem DBMS-Server an. Der Datenbankkonnektivitätsservice von InterChange Server verwendet die API von JDBC (Java Database Connectivity), um mit einem Datenbankserver zu kommunizieren.

Versuchen Sie, einen Trace für den Datenbankservice zu erstellen, wenn Sie vermuten, dass InterChange Server Probleme mit dem Zugriff auf den DBMS-Server hat. Beispielsweise kann es sinnvoll sein, die entsprechende Verbindung zu überprüfen, wenn System Manager lange für die Ausführung von eingegebenen Konfigurationsänderungen zu benötigen scheint.

Für die Traceerstellung können Sie die folgenden Stufen angeben:
0 Es findet keine Traceerstellung statt.
1 Nachrichten werden ausgegeben, wenn der Datenbankkonnektivitätsservice eine Verbindung zu einer Datenquelle herstellt oder trennt. Die Anzeige enthält die tatsächlich verwendeten SQL-Anweisungen. Außerdem werden Nachrichten ausgegeben, wenn der Datenbankkonnektivitätsservice Verbindungspools für Services von InterChange Server erstellt oder löscht.
2 Es werden die Nachrichten der Stufe 1 ausgegeben. Außerdem werden Nachrichten ausgegeben, die die erstellten und freigegebenen Verbindungen beschreiben.
3 Es werden die Nachrichten der Stufen 1 und 2 ausgegeben. Außerdem werden Nachrichten ausgegeben, die alle internen Schritte bei der Suche nach verfügbaren Verbindungen angeben. Diese Schritte umfassen auch das Durchsuchen der vorhandenen Verbindungspools nach den zuletzt verwendeten Verbindungen.
4 Es werden die Nachrichten der Stufen 1 bis 3 ausgegeben. Außerdem werden weitere Details zu den Schritten bei der Suche nach verfügbaren Verbindungen angegeben.
5 Es werden die Nachrichten der Stufen 1 bis 4 ausgegeben. Außerdem werden Nachrichten über das Schließen von inaktiven Verbindungen ausgegeben.

Beispiel: DB_CONNECTIVITY = 1

Standardwert

DB_CONNECTIVITY = 0
 

EVENT_MANAGEMENT

Dieser Parameter gibt die Stufe der Traceerstellung für den Ereignisverwaltungsservice an.

Sie können für die Traceerstellung die folgenden Stufen angeben:
0 Es findet keine Traceerstellung statt.
1 Es werden die Anforderungen des Ereignisverwaltungsservices an die Datenbank zum Speichern eines Ereignisses oder zum Ändern der Statusinformationen für ein Ereignis ausgegeben. Die Trace-Informationen geben den Connector-Controller an, der das Ereignis empfangen hat, sowie die Collaborations, an die das Ereignis gesendet wurde.
2 Es werden die Nachrichten der Stufe 1 ausgegeben. Außerdem wird der Inhalt der speicherinternen Warteschlange für laufende Prozesse der jeweiligen Collaboration ausgegeben. Die Tracenachricht enthält die Anzahl der Ereignisse in der Warteschlange für laufende Prozesse der Collaboration sowie die Anzahl der aktiven Prozesse. Auf diese Weise können Sie überprüfen, welche Einträge die Warteschlangen verlassen oder ob die Einträge lediglich hinzugefügt werden.

Beispiel: EVENT_MANAGEMENT = 1

Standardwert

EVENT_MANAGEMENT = 0
 

MESSAGING

Dieser Parameter gibt die Stufe der Traceerstellung für die Interaktionen zwischen dem Treiber der Nachrichtenübertragung von InterChange Server und dem Nachrichtenübertragungsservice an.

Er betrifft den Treiber der Nachrichtenübertragung auf der Maschine, auf der sich die Datei InterchangeSystem.cfg befindet. Der Treiber der Nachrichtenübertragung bedient InterChange Server-Komponenten, die auf dieser Maschine installiert sind, z. B.:

Für die Traceerstellung können Sie die folgenden Stufen angeben:
0 Es findet keine Traceerstellung statt.
1 Bei dieser Stufe wird der Empfang der Nachrichten vom Nachrichtenübertragungsservice durch den Treiber der Nachrichtenübertragung sowie das Senden von Nachrichten an den Service protokolliert. Die Tracenachricht gibt an, ob es sich bei der Nachricht um eine Nachricht mit Typ (Geschäftsobjekt) oder ohne Typ (Verwaltungsnachricht) handelt.
2 Es werden die Nachrichten der Stufe 1 ausgegeben. Außerdem wird der Inhalt der gesendeten und empfangenen Geschäftsobjekte ausgegeben.

Beispiel: MESSAGING = 2

Standardwert

MESSAGING = 0
 

REPOSITORY

Dieser Parameter gibt die Stufe der Traceerstellung für den Repository-Service an. Auf diese Weise können Sie ermitteln, welche Repositoryobjekte eingefügt, abgerufen und gelöscht werden.

Die Traceerstellung für den Repository-Service ist beispielsweise hilfreich, wenn Sie Probleme bei Repositoryobjekten wie den in System Manager sichtbaren Objekten feststellen.

Sie können für die Traceerstellung für das Repository die folgenden Stufen angeben:
0 Es findet keine Traceerstellung statt.
1 Es wird eine Nachricht ausgegeben, wenn der Repository-Service als Reaktion auf eine Anforderung ein Objekt (und gegebenenfalls dessen untergeordnete Objekte) aus der Datenbank abruft.
2 Es werden die Nachrichten der Stufe 1 ausgegeben. Außerdem wird eine Nachricht ausgegeben, wenn der Repository-Service erfolgreich ein neues Objekt zum Repository hinzugefügt hat.
3 Es werden die Nachrichten der Stufen 1 und 2 ausgegeben. Außerdem wird eine Nachricht ausgegeben, wenn der Repository-Service erfolgreich ein Objekt im Repository geändert hat.
4 Es werden die Nachrichten der Stufen 1 bis 3 ausgegeben. Außerdem wird eine Nachricht ausgegeben, wenn der Repository-Service erfolgreich ein Objekt aus dem Repository gelöscht hat.
5 Es werden die Nachrichten der Stufen 1 bis 4 ausgegeben. Außerdem wird eine Nachricht ausgegeben, wenn der Repository-Service ein Unterstützungsobjekt erstellt. Ein Unterstützungsobjekt ist der speicherinterne Code, der Anforderungen an den Datenbankserver absetzt und Informationen vom Datenbankserver empfängt. Für jeden Objekttyp, der im Repository gespeichert ist, gibt es ein eigenes Unterstützungsobjekt.
6 Es werden die Nachrichten der Stufen 1 bis 5 ausgegeben. Außerdem wird eine Nachricht ausgegeben, wenn InterChange Server das Datenbankschema für ein Repositoryobjekt erstellt. Diese Nachrichten werden beim Start angezeigt.
7 Es werden die Nachrichten der Stufen 1 bis 6 ausgegeben. Außerdem wird ein Trace für alle internen Repositorymethoden erstellt.

Beispiel: REPOSITORY = 3

Standardwert

REPOSITORY = 0
 

TRACE_FILE

Dieser Parameter gibt die Position an, in die InterChange Server bei aktivierter Tracefunktion die Tracenachrichten schreibt. Sie können Tracenachrichten an die Standardausgabe (STDOUT) oder an eine Datei senden, deren vollständigen Pfad Sie angeben.

Falls Sie für diesen Parameter keinen Wert definieren, schreibt InterChange Server Nachrichten an das Ziel für die Protokollierung, das durch den Wert des Parameters LOG_FILE angegeben ist.

Beispiel:

TRACE_FILE = logs/trace.log (im Verzeichnis PRODUKTVERZ)

Standardwert

TRACE_FILE = STDOUT
 

Unter UNIX wird die Protokolldatei bei Angabe von STDOUT in das Unterverzeichnis logs des Verzeichnisses PRODUKTVERZ umgeleitet.

MIRROR_TRACE_TO_STDOUT

Mit diesem optionalen Parameter können Sie das Senden von Tracenachrichten an die Standardausgabe und an eine Tracedatei aktivieren. Falls für den Parameter TRACE_FILE eine gültige Datei angegeben wurde, wird durch Angabe von MIRROR_TRACE_TO_STDOUT = TRUE die Traceausgabe zusätzlich in die Standardausgabe gespiegelt. Wenn der Parameter TRACE_FILE nicht definiert ist, wird dieser Parameter ignoriert.

Aufgrund des Leistungsaufwandes, der beim Spiegeln der Tracedatei entsteht, sollte dieser Parameter nur während der Entwicklung und beim Debug auf TRUE gesetzt werden. Während der Produktion sollte er entweder auf FALSE gesetzt oder gar nicht definiert werden (in diesem Fall wird standardmäßig die Einstellung FALSE verwendet).

Standardwert

Der Standardwert für diesen Parameter ist FALSE (inaktiviert).

MAX_TRACE_FILE_SIZE

Dieser optionale Parameter gibt die Größenbegrenzung der Tracedatei an. Die Größe kann in KB (Kilobyte), MB (Megabyte) oder GB (Gigabyte) angegeben werden. Wenn keine Einheit definiert ist, wird standardmäßig die Einheit "Byte" verwendet.

Beispiele:

MAX_TRACE_FILE_SIZE = 100 KB
  
 MAX_TRACE_FILE_SIZE = 5 MB
  
 MAX_TRACE_FILE_SIZE = 1 GB
  
 MAX_TRACE_FILE_SIZE = 8192
 

Falls für den Parameter MAX_TRACE_FILE_SIZE ein Wert angegeben wird, wird implizit die Tracearchivierung aktiviert.

Sofern die Anzahl der Archive nicht durch den Parameter NUMBER_OF_ARCHIVE_TRACES überschrieben wird, liegt sie standardmäßig bei 5, falls der Parameter MAX_TRACE_FILE_SIZE auf einen anderen Wert als UNLIMITED gesetzt ist.

Standardwert

Der Standardwert für diesen Parameter ist UNLIMITED.

NUMBER_OF_ARCHIVE_TRACES

Dieser optionale Parameter gibt die Anzahl der zu verwaltenden Archivtraces an. Die Namen der Archivierungsdateien werden aus dem angegebenen Wert des Parameters TRACE_FILE abgeleitet. Wenn der Parameter MAX_TRACE_FILE_SIZE nicht angegeben ist oder wenn TRACE_FILE=STDOUT festgelegt ist, wird dieser Parameter ignoriert.

Beispiel: Bei Angabe von

TRACE_FILE = traces/InterchangeSystem.trc im Verzeichnis PRODUKTVERZ und NUMBER_OF_ARCHIVE_TRACES = 3

werden die Archivtraces (im Verzeichnis PRODUKTVERZ) folgendermaßen benannt:

traces/InterchangeSystem_Arc_01.trc 
 traces/InterchangeSystem_Arc_02.trc
 traces/InterchangeSystem_Arc_03.trc
 

Standardwert

Der Standardwert für diesen Parameter ist 5.

RELATIONSHIP.CACHING

Dieser optionale Parameter weist ICS an, immer dann eine Nachricht in die Tracedatei zu schreiben, wenn die Beziehungstabellen einer statischen Beziehung im Speicher geladen oder entladen werden. Zur Aktivierung dieser Tracefunktion setzen Sie diesen Parameter auf den Wert 5. Bei niedrigeren Werten (0-4) ist diese Traceerstellung inaktiviert. Dieser Parameter ist nicht standardmäßig im Abschnitt TRACING der Datei InterchangeSystem.cfg enthalten. Daher ist die Traceerstellung für zwischengespeicherte Beziehungstabellen inaktiviert.

Beispiel: RELATIONSHIP.CACHING=5

Standardwert

Der Standardwert für diesen Parameter ist 0.

TRANSACTIONS

Dieser Parameter gibt die Stufe der Traceerstellung für den Transaktionsservice an.

Für die Traceerstellung können Sie die folgenden Stufen angeben:
0

Es findet keine Traceerstellung statt.

1

Es wird eine Nachricht ausgegeben, wenn die Transaktion gestartet wurde und wenn die Verarbeitung nach dem Festschreiben für die transaktionsbezogenen Warteschlangen ausgeführt wird.

2

Es werden die Nachrichten der Stufe 1 ausgegeben. Außerdem wird eine Nachricht ausgegeben, wenn der Transaktionsservice den Status eines Geschäftsobjekts in der Transaktion speichert.

3

Es werden die Nachrichten der Stufen 1 und 2 ausgegeben. Außerdem wird eine Nachricht ausgegeben, wenn eine transaktionsbezogene Collaboration festgeschrieben wird.

4

Es werden die Nachrichten der Stufen 1 bis 3 ausgegeben. Außerdem werden Nachrichten über ROLLBACK-Operationen von Collaborations ausgegeben. Eine Nachricht wird angezeigt, sobald die ROLLBACK-Operation beginnt. Beim Abschluss jedes Kompensationsschrittes wird ebenfalls eine Nachricht ausgegeben.

5

Es werden die Nachrichten der Stufen 1 bis 4 ausgegeben. Außerdem wird eine Nachricht ausgegeben, wenn beim Neustart von InterChange Server nach einer unerwarteten Beendigung eine Warmstartwiederherstellung stattfindet. Der Server reaktiviert transaktionsbezogene Collaborations, die durch die unerwartete Beendigung unterbrochen wurden, und führt eine ROLLBACK-Operation für sie aus. Der Server stellt erst dann neue Ereignisse an die Collaboration zu, nachdem die Warmstartwiederherstellung abgeschlossen wurde. Bis dahin verbleiben die Ereignisse in der Warteschlange, wo sie für die Verarbeitung nach der Wiederherstellung verfügbar sind.

Beispiel: TRANSACTIONS = 1

Standardwert

TRANSACTIONS = 0
 

FLOW_MONITORING

Dieser Parameter gibt die Stufe der Traceerstellung für den Ablaufüberwachungsservice an.

Sie können für die Traceerstellung die folgenden Stufen angeben:
0

Es findet keine Traceerstellung statt.

1

Beim Start werden Nachrichten ausgegeben, ob die Traceerstellung für eine Collaboration aktiviert ist, und die Konfiguration für die Datenbank wird angezeigt.

2

Es werden die Nachrichten der Stufe 1 ausgegeben. Außerdem werden Nachrichten ausgegeben, wenn Ereignisse aus der internen Warteschlange entfernt werden.

3

Es werden die Nachrichten der Stufen 1 und 2 ausgegeben. Außerdem werden Nachrichten ausgegeben, wenn Ereignisdatensätze über die API entfernt werden.

4

Es werden die Nachrichten der Stufen 1 bis 3 ausgegeben. Außerdem werden Nachrichten ausgegeben, wenn Ereignisse der internen Warteschlange zugeteilt werden.

5

Es werden die Nachrichten der Stufen 1 bis 4 ausgegeben. Außerdem werden die Schreibvorgänge für die Datenbank ausgegeben.

Beispiel: FLOW_MONITORING = 1

Standardwert

FLOW_MONITORING = 0 
 

SERVER_MEMORY

Dieser optionale Parameter ermöglicht es dem Server, die Speicherbelegung für durch Ereignisse ausgelöste Abläufe zu überwachen und die Speichervergrößerung durch das Anhalten von Connectors zu steuern.

Sie können für die Traceerstellung die folgenden Stufen angeben:
MEMORY_UPPER_THRESHOLD_PCT

Dieser Parameter gibt den Prozentsatz der maximalen Speicherkapazität an, bei der die Connectors durch den Server angehalten werden.

MEMORY_LOWER_THRESHOLD_PCT

Dieser Parameter gibt den Prozentsatz der Speicherkapazität an, bei der der Server die Nachrichtendosierung für die Listener startet.

MEMORY_CHECK_SLEEP

Dieser Parameter gibt an, wie häufig der Prüfprogrammthread für den Speicher die Speicherkapazität des Servers prüft.

SLEEPTIME_AFTER_MAX_THRESHOLD

Dieser Parameter gibt an, wie häufig der Prüfprogrammthread für den Speicher die Speicherkapazität des Servers prüft, nachdem die Connectors angehalten wurden.

Beispiel:

MEMORY_UPPER_THRESHOLD_PCT = 90
 MEMORY_LOWER_THRESHOLD_PCT = 75
 MEMORY_CHECK_SLEEP = 1
 SLEEPTIME_AFTER_MAX_THRESHOLD = 2
 

Standardwert

MEMORY_UPPER_THRESHOLD_PCT = 90
 MEMORY_LOWER_THRESHOLD_PCT = 80
 MEMORY_CHECK_SLEEP = 0
 SLEEPTIME_AFTER_MAX_THRESHOLD = 5
 

Um den Trace des Prüfprogrammthreads für den Speicher anzuzeigen, fügen Sie den folgenden Parameter zum Unterabschnitt [TRACING] hinzu:

SERVER_MEMORY = 1 to 3
 

DOMAIN_STATE_SERVICE

Dieser Parameter gibt die Stufe der Traceerstellung für den Domänenstatusservice an. Dieser Service protokolliert die Statuswerte aller Komponenten im InterChange Server-System.
0 Es findet keine Traceerstellung statt.
1 Es werden Nachrichten ausgegeben, wenn eine Komponente (z. B. ein Connector oder eine Collaboration) zur Registrierung hinzugefügt oder aus ihr gelöscht wird. Außerdem werden Nachrichten ausgegeben, wenn sich der Status einer Komponente ändert, also beispielsweise ein aktiver Connector gestoppt oder angehalten wird.
2 Es werden die Nachrichten der Stufe 1 ausgegeben. Außerdem wird eine Nachricht ausgegeben, wenn Methodenaufrufe erfolgen.

Beispiel: DOMAIN_STATE_SERVICE = 1

Standardwert

DOMAIN_STATE_SERVICE = 0
 

MQSERIES_TRACE_LEVEL

Dieser Parameter gibt die Stufe der Traceerstellung für das Debug der Verbindung zum Nachrichtenübermittlungssystem von WebSphere MQ an. Die Tracestufen liefern Informationen für die Verbindung von InterChange Server zum WebSphere MQ-Kanal. Weitere Angaben erhalten Sie, wenn Sie im Hilfetext von WebSphere MQ nach Informationen zu Traces suchen.

Für die Traceerstellung können Sie die folgenden Stufen angeben:
0 Es findet keine Traceerstellung statt.
1 Es werden Traces für Eingänge, Exits und Ausnahmebedingungen erstellt.
2 Es werden die Nachrichten der Stufe 1 ausgegeben. Außerdem werden Parameterinformationen bereitgestellt.
3 Es werden die Nachrichten der Stufen 1 und 2 ausgegeben. Außerdem werden übertragene und empfangene MQ-Header und -Datenblöcke bereitgestellt.
4 Es werden die Nachrichten der Stufen 1 bis 3 ausgegeben. Außerdem werden übertragene und empfangene Benutzernachrichtendaten bereitgestellt.
5 Es werden die Nachrichten der Stufen 1 bis 4 ausgegeben. Außerdem wird ein Trace der Methoden in der JVM (Java Virtual Machine) erstellt.

Standardwert

MQSERIES_TRACE_LEVEL = 0
 

MQSERIES_TRACE_FILE

Dieser Parameter gibt den Namen der Datei an, an die bei aktivierter Tracefunktion die Tracenachrichten über WebSphere MQ gesendet werden. Falls Sie für diesen Parameter keinen Wert angeben, wird der Standarddateiname PRODUKTVERZ/mqseries/CwMQ.trc verwendet.

Beispiel:

MQSERIES_TRACE_FILE = MQSeries.trace.log (im VerzeichnisPRODUKTVERZ)

Standardwert

MQSERIES_TRACE_FILE =mqseries/CwMQ.trc(im VerzeichnisPRODUKTVERZ)

Copyright IBM Corp. 1997, 2004