Start/notes.ini Parameter/CLIENT_CLOCK

CLIENT_CLOCK

Parameter: CLIENT_CLOCK
Kurzbeschreibung: Notes-Client-Tracing: protokolliert pro NRPC-Transaktion Zeitstempel, Aufrufstack und Server-Antwortzeiten — Standard-Werkzeug zur Diagnose von langsamen Client-Operationen, Hangs und Authentifizierungsproblemen.

Steckbrief

Parameter
CLIENT_CLOCK
Kategorie
Logging / Debug
Komponente
Client, Server
Verfügbar seit
9.0.1 (und früher)
Unterstützte Versionen
9.0.1, 10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI-Entsprechung
Nur notes.ini (keine GUI)
Mögliche Werte
0 = aus (Standard) • 1 = aktiviert (Basis-Tracing) • 30 / 32 = erweitertes Tracing inkl. Call-Stack (laut HCL KB0038983)

Beschreibung

CLIENT_CLOCK aktiviert ein detailliertes NRPC-Transaktions-Tracing auf Notes-Client- bzw. Domino-Server-Seite. Für jede Transaktion zwischen Client und Server (Öffnen einer Datenbank, Lesen einer Notiz, Authentifizierung, Replikation …) wird ein Logeintrag erzeugt, der typischerweise enthält:
  • Zeitstempel von Start und Ende der Transaktion
  • die belegte Server-Antwortzeit
  • den Funktions-/Aufrufstack der auslösenden Operation (bei höheren Werten)
  • Ziel-Server-/Datenbank-Information
Der Parameter ist ein Standard-Werkzeug aus dem HCL-Support-Katalog — in KB0038983 „Debug settings for Notes Federated Login" wird CLIENT_CLOCK=32 zusammen mit DEBUG_OUTFILE=… und DEBUG_CONSOLE=1 gesetzt, um Authentifizierungs-Roundtrips eines Notes-Clients gegen den Identity Provider und Domino-Server zu vermessen. Auch zur Diagnose von Server-Hangs, langsamen „Client-Operationen", Cluster-Failover-Problemen und unerwartet langen Login-Zeiten wird der Parameter regelmäßig empfohlen.
Im Konsolen-Log/Debug-Outfile erscheinen dann Einträge wie:
CLIENT_CLOCK <transaction>: server <name> took <ms> ms

Beispiel-Konfiguration

Client-seitig (Notes Federated Login Debug — KB0038983):
CLIENT_CLOCK=32
client_clock_server_format=1
DEBUG_CONSOLE=1
DEBUG_OUTFILE=c:\debug\client_clock.txt
Server-seitig zur Diagnose von langsamen NRPC-Operationen:
CLIENT_CLOCK=1
Debug_Outfile=c:\debug\nrpc.txt
CONSOLE_LOG_MAX_KBYTES=256000
Laufzeit-Aktivierung:
set config CLIENT_CLOCK=1
Nach Abschluss der Analyse wieder deaktivieren:
set config CLIENT_CLOCK=0

Hinweise & Stolperfallen

  • Erzeugt sehr hohes Log-Volumen (jede NRPC-Transaktion erscheint im Log) — grundsätzlich Debug_Outfile=… und großzügiges CONSOLE_LOG_MAX_KBYTES setzen, niemals dauerhaft aktiv lassen.
  • Für persistente Ausgabe wird zusätzlich DEBUG_CONSOLE=1 und/oder Debug_Outfile=… benötigt.
  • client_clock_server_format=1 ergänzt CLIENT_CLOCK um eine besser parsebare Ausgabe pro Server.
  • Beeinflusst die Performance — jeder NRPC-Aufruf wird zusätzlich vermessen und geloggt.
  • Wirkt sofort über set config CLIENT_CLOCK=…; kein Neustart erforderlich.
  • Wird häufig in Kombination mit LogStatusBar=1 und DEBUG_THREADID=1 zur tieferen Client-Diagnose eingesetzt.

Quellen (HCL Product Documentation)