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 ICS-Datenbankkonnektivitätsservice 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 ICS 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.

Sie können für die Traceerstellung die folgenden Stufen angeben:
Stufe Beschreibung
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 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
 

FLOW_MONITORING

Dieser Parameter gibt die Stufe der Traceerstellung für interne Nachrichten an.

Anmerkung:
Dieser Eintrag ist nur für Debugzwecke vorgesehen. Diese Funktion darf nicht mit der eigentlichen Ablaufüberwachung verwechselt werden.

Für die Traceerstellung können die Stufen 0 bis 5 festgelegt werden.

Sie können für die Traceerstellung die folgenden Stufen angeben:
Stufe Beschreibung
0 Es findet keine Traceerstellung statt.
1 Nachrichten werden zum Startzeitpunkt ausgegeben (an dem die Traceerstellung für eine Collaboration konfiguriert und die Konfiguration für die Datenbank angegeben wird).
2 Es werden die Nachrichten der Stufe 1 ausgegeben. Außerdem ist angegeben, welche Ereignisse aus der internen Warteschlange entfernt wurden.
3 Es werden die Nachrichten der Stufen 1 und 2 ausgegeben. Außerdem wird eine Nachricht ausgegeben, wenn ein Ereignisdatensatz über die API entfernt wird.
4 Es werden die Nachrichten der Stufen 1 bis 3 ausgegeben. Außerdem wird eine Nachricht ausgegeben, wenn ein Ereignis der internen Warteschlange zugeteilt wird.
5 Es werden die Nachrichten der Stufen 1 bis 4 ausgegeben. Außerdem werden die Schreibvorgänge für die Datenbank ausgegeben.

Beispiel: F LOW_MONITORING = 1

Standardwert

FLOW_MONITORING = 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:
Stufe Beschreibung
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 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.:

Sie können für die Traceerstellung die folgenden Stufen angeben:
Stufe Beschreibung
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. Er zeigt die Repositoryobjekte an, die 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:
Stufe Beschreibung
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
 

MIRROR_TRACE_TO_STDOUT

Mit diesem 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 der 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 Parameter gibt die Größenbegrenzung der Tracedatei an. Der Wert 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 diesen Parameter ein Wert angegeben wird, wird implizit die Tracearchivierung aktiviert.

Standardwert

Der Standardwert für diesen Parameter ist UNLIMITED.

NUMBER_OF_ARCHIVE_TRACES

Dieser 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

Die Standardanzahl für die Archive ist 5, sofern dieser Parameter nicht durch den Parameter NUMBER_OF_ARCHIVE_TRACES überschrieben oder der Parameter MAX_TRACE_FILE_SIZE nicht auf einen anderen Wert als UNLIMITED gesetzt ist.

RELATIONSHIP.CACHING

Dieser Parameter ist ein Auslöser für ICS, durch den immer dann eine Nachricht in die Tracedatei geschrieben wird, 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 einem Wert von 0 bis 4 ist diese Art der 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.

Sie können für die Traceerstellung die folgenden Stufen angeben:
Stufe Beschreibung
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 und 4 ausgegeben. Außerdem wird eine Nachricht bei der Warmstartwiederherstellung ausgegeben, die stattfindet, wenn InterChange Server nach einer unerwarteten Beendigung erneut gestartet wird. Der Server reaktiviert transaktionsbezogene Collaborations, die durch die unerwartete Beendigung unterbrochen wurden, und führt eine ROLLBACK-Operation für sie aus. Der Server liefert erst dann neue Ereignisse an die Collaboration, nachdem die Warmstartwiederherstellung abgeschlossen wurde. Bis dahin verbleiben die Ereignisse in der Warteschlange, wo sie für die Verarbeitung am Ende der Wiederherstellungsperiode verfügbar sind.

Beispiel: TRANSACTIONS = 1

Standardwert

TRANSACTIONS = 0 
 

SERVER_MEMORY

Dies ist ein Auslöser für den Server, die Speicherbelegung für durch Ereignisse ausgelöste Abläufe zu überwachen und die Speichervergrößerung durch angehaltene Adapter zu steuern.

Sie können für die Traceerstellung die folgenden Stufen angeben:
Parameter Beschreibung
MEMORY_UPPER_THRESHOLD_PCT Dieser Parameter gibt den Prozentsatz der maximalen Speicherkapazität an, bei der der Server die Adapter anhält.
MEMORY_LOWER_THRESHOLD_PCT Dieser Parameter gibt den Prozentsatz der Speicherkapazität an, bei der der Server die Nachrichtendosierung für die Empfangsprogramme (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 Adapter 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 System.
Stufe Beschreibung
0 Es findet keine Traceerstellung statt.
1 Es werden Nachrichten ausgegeben, wenn eine Komponente (z. B. ein Adapter oder eine Collaboration) zum Registry hinzugefügt oder aus ihm gelöscht wird. Außerdem werden Nachrichten ausgegeben, wenn sich der Status einer Komponente ändert, also beispielsweise ein aktiver Adapter 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. Wählen Sie hierzu die Optionen "Start > Programme > WebSphere MQ > WebSphere MQ Information Center" aus, und klicken Sie auf die Registerkarte "Suchen".

Für die Traceerstellung können Sie die folgenden Stufen angeben:
Stufe Beschreibung
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 die Datei an, an die die Tracenachrichten über WebSphere MQ bei aktivierter Tracefunktion 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 Verzeichnis PRODUKTVERZ)

Standardwert

MQSERIES_TRACE_FILE =mqseries\CwMQ.trc(im Verzeichnis PRODUKTVERZ)

Copyright IBM Corp. 1997, 2004