:DISCONNECT

Systemzustände und -bedienung

:SHUTDOWN

---

:SET_UC_SETTING

Script-Anweisung: Ändert Systemeinstellungen im laufenden Betrieb.

Syntax

:SET_UC_SETTING Setting, Component, Value

Anmerkungen

Mit der Script-Anweisung :SET_UC_SETTING können derzeit drei Systemeinstellungen geändert werden. Die Änderungen sind solange gültig, bis ein neuer Wert zugewiesen wird bzw. die Serverprozesse oder der Agent beendet werden.

Die Berechtigung "Modifizieren zur Laufzeit" und das Privileg "Diagnoseinformationen erstellen" sind dafür erforderlich.

Das Script-Sprachmittel bewirkt, dass die offenen Transaktionen des Scripts in die Datenbank geschrieben werden.

Wenn Sie Trace-Optionen für WPs ändern, können Sie nur alle gemeinsam ändern. Es ist nicht möglich, individuelle WPs einzeln zu ändern.

Trace-Optionen für CPs sollten hingegen einzeln geändert werden.

Ändern von Trace-Optionen

Durch das Setzen der Trace-Optionen wird es möglich, aus einem Script heraus in einem Ausnahmefall das Verhalten der Arbeitsprozesse und Agenten systemnah zu protokollieren. Für den Trace müssen jene nicht beendet werden. Da aber unter Umständen umfangreiche Daten anfallen, kann es zu Performance-Verlusten kommen.
Das Setzen von Trace-Optionen sollte nur in enger Abstimmung mit Support erfolgen. 

Um die Trace-Optionen zu ändern, ist als Einstellung SET_TRACE anzugeben. Wert ist bei den Trace-Optionen ein String mit 16 Stellen. Jede Stelle entspricht einem bestimmten Traceflag, beispielsweise die erste Stelle einem TCP/IP-Trace.
Die Reihenfolge der Traceflags ist identisch mit der Reihenfolge, die im Eigenschaften-Dialog in der Systemübersicht für Serverprozesse und Agenten verwendet wird.

Wenn Sie nur einen Arbeitsprozess neu starten, wird dieser die Trace-Optionen verwenden, die in der INI-Datei festgelegt wurden. Alle anderen benutzen den mit der Script-Anweisung :SET_UC_SETTING eingestellten Wert, bis auch sie neu gestartet werden.

Beispiele

Im ersten Beispiel wird die Anzahl an Ressourcen, die der Agent WIN01 für Jobs und FileTransfers zur Verfügung stellt, auf 1000 gesetzt. Das Ergebnis wird zur Kontrolle im Aktivierungsprotokoll ausgegeben.

:SET_UC_SETTING WORKLOAD_MAX, WIN01, 1000
:SET &RET# = GET_UC_SETTING(WORKLOAD_MAX_JOB, WIN01)
:PRINT &RET#

Im zweiten Beispiel wird zuerst der Name des Automation Engine Systems ermittelt und dann der TCP/IP-Trace für dessen Arbeitsprozesse eingeschaltet.

:SET &TRC# = GET_UC_SYSTEM_NAME()
:SET_UC_SETTING SET_TRACE, &TRC#, "1000000000000000"

Im folgenden Beispiel wird der Serverprozess „AE#WP003" zu einem Dialogprozess gemacht, wenn dieser aktiv ist.

:IF SYS_SERVER_ALIVE("AE#WP003") = "Y"
:   SET_UC_SETTING "SERVER_MODE", "AE#WP003", "D"
:ELSE
:   SEND_MSG "ADMIN","AE","Work process AE#WP003 is not active!"
:ENDIF

In this example the trace options for the agent WINAGENT01 are set with the noted values, those to be found in the agent's properties dialog in the System Overview:

:SET_UC_SETTINGSET_TRACE,"WINAGENT01","2400000000000000,MEMORY,128,SIMPLE,FileTransfer * unerwartet beendet."

Siehe auch:

Script-Sprachmittel - Systemzustände und -bedienung

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung