IPS_EnableDebug

 bool IPS_EnableDebug (int $InstanzID, int $Dauer) 

Parameterliste

Rückgabewert

Konnte die Funktion erfolgreich ausgeführt werden, liefert sie als Ergebnis TRUE, andernfalls FALSE.

Beschreibung

Die Funktion aktiviert für die Instanz mit der ID InstanzID für Dauer Sekunden die Weiterleitung von Debug-Meldungen. Debug-Meldungen, welche die Instanz in dieser Zeit sendet (z.B. über SendDebug), werden als Nachricht KL_DEBUG (10206) verteilt. Die Verwaltungskonsole nutzt die Funktion für die Anzeige im Debug-Fenster der Instanz.

Ein erneuter Aufruf setzt die Dauer ab dem aktuellen Zeitpunkt neu. Nach Ablauf der Dauer werden keine Debug-Meldungen mehr weitergeleitet. Mit IPS_DisableDebug kann die Weiterleitung vorzeitig beendet werden. Unabhängig davon können Debug-Meldungen mit IPS_EnableDebugFile in eine Datei geschrieben werden.

Ist InstanzID ein über Sync Remote gespiegeltes Objekt, meldet die Funktion den Fehler "Remote instances cannot be debugged". Debug-Meldungen gespiegelter Instanzen können nur direkt auf dem entfernten System angezeigt werden.

Diese Option ist flüchtig. Nach einem Neustart des IP-Symcon Diensts ist die Weiterleitung der Debug-Meldungen automatisch wieder deaktiviert.

Beispiel

// Debug-Meldungen der Instanz 12345 für 5 Minuten aktivieren
IPS_EnableDebug(12345, 300);