CHANGE_LOGGING

Script-Funktion: Bewirkt, dass die Logdatei gewechselt wird

Syntax

CHANGE_LOGGING (Komponente)

Syntax

Beschreibung/Format

Komponente

Name der Komponente, deren Logdatei geändert werden soll
Format:AE Name oder Script-Variable

Sie können folgende Komponenten angeben:

  • Kommunikationsprozess
  • Arbeitsprozess
  • Agent
  • Agentengruppe

Rückgabewert

"0" - Die Logdatei wurde erfolgreich geändert.
20223 - Die angegebene Agentengruppe ist nicht vorhanden.
20722 - Der angegebene Serverprozess, Agent oder die Agentengruppe ist nicht vorhanden oder inaktiv.

Mit dieser Script-Funktion kann ein Wechsel der Log-Datei erzwungen werden.

In der Variablen UC_SYSTEM_SETTINGS kann der Administrator systemweite Vorgaben für die Anzahl der Tage oder die Größe der Log-Datei (in MB) machen. Die Log-Datei wird geändert, wenn die angegebenen Werte erfüllt sind. Ein temporärer Wechsel der Log-Datei ist auf der Registerkarte "Eigenschaften" der Systemübersicht möglich. Dies erfolgt auf der Registerkarte Eigenschaften der Administration-Perspektive. Der Speicherort für die Log-Dateien wird in der INI-Datei des Servers bzw. des Agenten festgelegt.

Wenn eine Agentengruppe angegeben wird, ändern sich die Log-Dateien aller entsprechenden Agenten. Sie erhalten keine Fehlernummer als Rückgabewert, wenn einer der Agenten nicht aktiv ist und ein Wechsel der Log-Datei daher nicht vorgenommen werden kann.

Achtung! Beachten Sie, dass die Änderung der Protokollierung eines Arbeitsprozesses automatisch für alle Arbeitsprozesse gilt.

Beispiel

Im Beispiel wird ein Logging-Wechsel für alle Arbeitsprozesse veranlasst.

:SET &RET# = CHANGE_LOGGING ("AE#WP001")

Siehe auch: