Automation Engine Script-Leitfaden > Funktionelle Gliederung > Systemzustände und -bedienung > GET_UC_SETTING

GET_UC_SETTING

Script-Funktion: Liest aktuelle Systemeinstellungen.

Syntax

GET_UC_SETTING(Setting, Component, Option)

Syntax

Beschreibung/Format

Einstellung

Systemeinstellung, welche gelesen werden soll.
Format: AE-Name, Script-Literal oder Script-Variable

Erlaubte Werte: "WORKLOAD_ACTUAL_FT", "WORKLOAD_ACTUAL_JOB", "WORKLOAD_MAX_FT", "WORKLOAD_MAX_JOB", "SET_TRACE", "SERVER_MODE", "SERVER_OPTIONS"

"WORKLOAD_ACTUAL_FT" = Gerade belegte Anzahl der Ressourcen, die der Agent für FileTransfers bereitstellt.
"WORKLOAD_ACTUAL_JOB" = Gerade belegte Anzahl der Ressourcen, die der Agent für Jobs bereitstellt
"WORKLOAD_MAX_FT" = Maximale Anzahl an Ressourcen, die der Agent für FileTransfers bereitstellt
"WORKLOAD_MAX_JOB" = Maximale Anzahl an Ressourcen, die der Agent für Jobs bereitstellt
"SET_TRACE" = Trace-Optionen für die Arbeitsprozesse eines Automation Engine Systems
"SERVER_MODE" = Typ des Serverprozesses
"SERVER_OPTIONS" = Einstellungen am Server 

Komponente

Komponente, deren Systemeinstellung in Abhängigkeit von der Parameter-Einstellung gelesen werden soll.
Format: AE-Name, Script-Literal oder Script-Variable

Für "WORKLOAD_ACTUAL_FT", "WORKLOAD_ACTUAL_JOB", "WORKLOAD_MAX_FT" und "WORKLOAD_MAX_JOB": Name des Agenten.
Bei "SET_TRACE": Name des Automation Engine Systems
Für SERVER_MODE: Name des Serverprozesses.
Bei SERVER_OPTIONS: wird keine Komponente angegeben.
Option

Option / Zustand des angegebenen Queue-Objektes, deren Wert gelesen werden soll.
Format: AE-Name, Script-Literal oder Script-Variable

Dieser Parameter ist nur anzugeben, wenn der Wert eines Queue-Objektes gelesen werden soll (Einstellung = QUEUE).

Erlaubte Werte: "ACTIVE_COUNT", "CONSIDER_ERT", "MAX_SLOTS", "PRIORITY", "STATE"

"ACTIVE_COUNT" = Anzahl der aktuell belegten Queue-Slots
"CONSIDER_ERT" = Berücksichtigung der ERT für Ausnahmen
"MAX_SLOTS" = Queue-Slot Maximum
"PRIORITY" = Aktuelle Priorität (bei Ausnahmen kann der Wert von der Standard-Priorität abweichen)
"STATE" = Aktueller Queue-Status

Rückgabewerte

Bei "WORKLOAD_ACTUAL_FT" und "WORKLOAD_ACTUAL_JOB":
Gerade belegte Anzahl der Ressourcen, die der Agent für FileTransfers bzw. Jobs bereitstellt.
"UNKNOWN" - Für den Agenten gibt es keine Beschränkung der Ressourcen.

Bei "WORKLOAD_MAX_FT" und "WORKLOAD_MAX_JOB":
Maximale Anzahl an Ressourcen, die der Agent für FileTransfers bzw. Jobs bereitstellt
"UNLIMITED" - Die Ressourcen sind unbegrenzt.

Bei "SET_TRACE":
Trace-Optionen des Arbeitsprozesses.
"0" - Es wurden keine Trace-Optionen gesetzt.

Für SERVER_MODE:
"C" - Kommunikationsprozess (CP)
"P" - Primärer Arbeitsprozess (PWP)
"W" - Arbeitsprozess (WP)
"D" - Dialogprozess (DWP)
"N" - NonStopprozess (NWP)
" " - Der Serverprozess ist nicht aktiv.

Bei SERVER_OPTIONS:
Zeichenkette, welche die Server-Optionen enthält.

Bei "QUEUE" - "ACTIVE_COUNT":
Anzahl der verwendeten Queue-Slots

Bei "QUEUE" - "CONSIDER_ERT":
"1" - ERT wird beim Start von Aufgaben im Bezug auf Queue-Ausnahmen berücksichtigt
"2" - ERT wird nicht berücksichtigt

Bei "QUEUE" - "MAX_SLOTS":
Anzahl der maximalen Queue-Slots
"UNLIMITED" - Queue-Slots sind unbegrenzt

Bei "QUEUE" - "PRIORITY":
Aktuell Queue-Priorität

Bei "QUEUE" - "STATE":
"0" = GO
"1" = STOP

Anmerkungen

Die Trace-Optionen können in der Kategorie "Server" der Systemübersicht eingestellt werden. Hierfür stehen 16 Bereiche (z.B. TCP/IP) zur Verfügung. Die Script-Funktion liefert eine 16-stellige Zahl als Rückgabewert, wobei jede Nummer einem dieser Bereiche entspricht.

Die Server-Optionen werden vom Administrator in der Variablen UC_SYSTEM_SETTINGS mit dem Key SERVER_OPTIONS definiert. GET_UC_SETTING liefert Ihnen die gesamte Zeichenkette. Verwenden Sie das Script-Sprachmittel MID, SUBSTR oder STR_CUT, um eine spezielle Server-Option auszulesen.

GET_UC_SETTING bewirkt, dass die offenen Transaktionen des Scripts in die AE-Datenbank geschrieben werden.

Beispiele

Im Beispiel wird die maximale Anzahl der Ressourcen, die der Agent WIN01 für Jobs bereitstellt, ermittelt. Das Ergebnis wird im Aktivierungsprotokoll ausgegeben.

:SET &RET# = GET_UC_SETTING(WORKLOAD_MAX_JOB, "WIN01")
:PRINT &RET#

Im zweiten Beispiel werden die Trace-Optionen der Arbeitsprozesse des Automation Engine Systems namens "DEVPROD" ausgelesen.

:SET &RET# = GET_UC_SETTING(SET_TRACE, "AEPROD")

Im folgenden Beispiel wird der Typ des Serverprozesses "AE#WP003" ermittelt.

:SET &RET# = GET_UC_SETTING(SERVER_MODE, "AE#WP003")

Die folgenden Scriptzeilen lesen aus den Server-Optionen die dritte Einstellung ab. Sie legt fest ob Statistiksätze beim Kaltstart geprüft werden sollen.

:SET &RET# = GET_UC_SETTING(SERVER_OPTIONS)
:SET &OPTION# = SUBSTR(&RET#,3,1)

Folgendes Beispiel zeigt die Ermittlung des aktuellen Status eines Queue-Objektes und gibt diesen im Aktivierungsprotokoll aus:

:SET &RET# = GET_UC_SETTING(QUEUE,QUEUE.JOBS,STATE)
:IF &RET# = 0
: PRINT "QUEUE.JOBS - Status = GO"
:ELSE
: PRINT "QUEUE.JOBS - Status = STOP"
:ENDIF

Im folgenden Beispiel wird das aktuelle Slot-Maximum aus einem Queue-Objekt gelesen und in den Aktivierunsreport geschrieben.

:SET &RET# = GET_UC_SETTING(QUEUE,QUEUE.JOBS,MAX_SLOTS)
: PRINT "Queue QUEUE.JOBS - Max Slots: &RET#"

 

Siehe auch:

Script-Sprachmittel Beschreibung

:SET_UC_SETTING

Ändert Systemeinstellungen im laufenden Betrieb.

Script-Sprachmittel - Systemzustände und -bedienung

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

 

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

 Copyright © 2016 Automic Software GmbH