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.
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
DB_CONNECTIVITY = 0
Dieser Parameter gibt die Stufe der Traceerstellung für den Ereignisverwaltungsservice an.
Sie können für die Traceerstellung die folgenden Stufen angeben:
Beispiel: EVENT_MANAGEMENT = 1
EVENT_MANAGEMENT = 0
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:
Beispiel: MESSAGING = 2
MESSAGING = 0
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
REPOSITORY = 0
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)
TRACE_FILE = STDOUT
Unter UNIX wird die Protokolldatei bei Angabe von STDOUT in das Unterverzeichnis logs des Verzeichnisses PRODUKTVERZ umgeleitet.
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).
Der Standardwert für diesen Parameter ist FALSE (inaktiviert).
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.
Der Standardwert für diesen Parameter ist UNLIMITED.
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
Der Standardwert für diesen Parameter ist 5.
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
Der Standardwert für diesen Parameter ist 0.
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
TRANSACTIONS = 0
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
FLOW_MONITORING = 0
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
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
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
DOMAIN_STATE_SERVICE = 0
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. |
MQSERIES_TRACE_LEVEL = 0
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)
MQSERIES_TRACE_FILE =mqseries/CwMQ.trc(im VerzeichnisPRODUKTVERZ)