GET_UC_SETTING

Verwenden Sie Script-Funktion GET_UC_SETTING, um aktuelle Systemeinstellungen abzurufen.

Hinweise: Die Script-Anweisung bewirkt, dass alle offenen Transaktionen des Scripts in die AE-Datenbank geschrieben werden. Weitere Informationen finden Sie unter Script-Verarbeitung.

Syntax

GET_UC_SETTING (Einstellung, Komponente, Option)

Parameter

• GET_UC_SETTING
  Ruft eine Systemeinstellung ab

• Einstellung
  Gibt die abzurufende Einstellung an
  Format: AE-Name, Script-Literal oder Script-Variable
  Zulässige Werte:

  • QUEUE
    Queue-Objekt-Einstellungen
    Weitere Informationen finden Sie unter Queue (QUEUE).
  • SET_TRACE
    Trace-Optionen für die Arbeitsprozesse eines AE-Systems
    Hinweis: Trace-Optionen sind in der Administration-Perspektive angegeben. Weitere Informationen finden Sie unter Abschnitt "Trace Flags" und Abschnitt "Zusätzliche Trace-Optionen".
  • SERVER_MODE
    Typ des Serverprozesses
    Weitere Informationen finden Sie unter Prozesse und Auslastung.
  • SERVER_OPTIONS
    Servereinstellungen
    Hinweis: Administratoren definieren die Serveroptionen in der Variablen UC_SYSTEM_SETTINGS (Schlüssel SERVER_OPTIONS). Weitere Informationen finden Sie unter UC_SYSTEM_SETTINGS - Systemübergreifende Einstellungen
    
  • WORKLOAD_ACTUAL_FT
    Ressourcen, die derzeit vom Agenten für FileTransfers zur Verfügung gestellt werden
  • WORKLOAD_ACTUAL_JOB
    Ressourcen, die derzeit vom Agenten für Jobs zur Verfügung gestellt werden
  • WORKLOAD_MAX_FT
    Maximale Anzahl der Ressourcen, die der Agent für FileTransfers zur Verfügung stellt
  • WORKLOAD_MAX_JOB
    Maximale Anzahl der Ressourcen, die der Agent für Jobs zur Verfügung stellt

• Komponente
  Komponente, für die die Systemeinstellung abgerufen werden soll
  Format:AE-Name, Script-Literal oder Script-Variable
  Geben Sie den gewünschten Komponentennamen abhängig von der Einstellung an, die Sie abrufen möchten:

  • Name des Queue-Objekts
  • Name des Serverprozesses für SERVER_MODE.
  • Der Name des AE-Systems für SET_TRACE.
  • Geben Sie den Agentennamen an, um die folgenden Einstellungen abzurufen:
    • WORKLOAD_ACTUAL_FT
    • WORKLOAD_ACTUAL_JOB
    • WORKLOAD_MAX_FT
    • WORKLOAD_MAX_JOB
  • Für SERVER_OPTIONS ist keine Komponente erforderlich.

• Option
  (Nur QUEUE oder SET_TRACE) Gibt eine abzurufende Option oder einen abzurufenden Status an
  Format:AE-Name, Script-Literal oder Script-Variable
  Zulässige Werte mit QUEUE:

  • ACTIVE_COUNT
    Anzahl der aktuell verwendeten Queue-Slots
  • CONSIDER_ERT
    Für Ausnahmen berücksichtigte ERT
  • MAX_SLOTS
    Maximale Queue-Slots
  • PRIORITY
    Die aktuelle Priorität
    Hinweis: Dieser Wert kann sich von der Standardpriorität unterscheiden, wenn im Queue-Objekt Ausnahmen definiert wurden.
  • STATE
    Aktueller Status der Queue (aktiv oder angehalten)
    
  Zulässige Werte mit SET_TRACE:
  • MAX_BUFFER_SIZE
    Größe des zur Verfügung gestellten Speichers, der geschrieben werden soll
  • TRACE_TARGET
    Ziel, in das Traces geschrieben werden
  • SEARCH_KEY
    Text, nach dem innerhalb der Traces gesucht werden soll

Rückgabewerte

Die Script-Funktion hat die folgenden Rückgabewerte, je nach den von Ihnen festgelegten Parametern.

QUEUE

• ACTIVE_COUNT
  • Anzahl der aktuell verwendeten Queue-Slots
• CONSIDER_ERT
• 0
  ERT wird nicht berücksichtigt
• 1
  ERT wird berücksichtigt, wenn Aufgaben in Bezug auf Queue-Ausnahmen starten
• MAX_SLOTS
• Maximale Anzahl der Queue-Slots
• UNLIMITED
  Queue-Slots sind nicht begrenzt
• PRIORITY
• Aktuelle Priorität der Queue
• STATE
• 0
  GO
• 1
  STOP

SERVER_MODE

• A
  
  Java-Kommunikationsprozess (JCP)
• C
  
  Kommunikationsprozess (CP)
• D
  
  Dialogprozess (DWP)
• J
  
  Java-Arbeitsprozess (JWP)
• N
  
  Nicht unterbrochener Prozess
• P
  
  Primärer Arbeitsprozess (PWP)
• W
  
  Arbeitsprozess (WP)
• Das System gibt ein Leerzeichen zurück, wenn der Serverprozess inaktiv ist.

SERVER_OPTIONS

• Vollständiger String, der die Serveroptionen enthält
  Tipp: Verwenden Sie die Script-Elemente MID, SUBSTR oder STR_CUT, um eine bestimmte Serveroption zu lesen. Weitere Informationen finden Sie unter Script-Elemente zur Bearbeitung von Strings.
  

SET_TRACE

• Keine Option angegeben
  • 1 bis 9
    Trace-Ebene des Arbeitsprozesses
    Weitere Informationen finden Sie unter Abschnitt "Trace Flags".
  • 0
    Tracing ist deaktiviert
• TRACE_TARGET
• FILE
  
  Traces werden in eine Datei geschrieben
• MEMORY
  
  Traces werden in den Speicher geschrieben
• MAX_BUFFER_SIZE
• Größe des für das Erstellen von Traces bereitgestellten Speichers (in MB)
• SEARCH_KEY
• Suchtext

WORKLOAD_ACTUAL_FTund WORKLOAD_ACTUAL_JOB

• Ressourcen, die derzeit vom Agenten für FileTransfers und Jobs zur Verfügung gestellt werden
• UNKNOWN
  Die Ressourcen sind nicht begrenzt

WORKLOAD_MAX_FT und WORKLOAD_MAX_JOB

• Maximale Anzahl der vom Agenten bereitgestellten Ressourcen für FileTransfers und Jobs
• UNLIMITED
  Die Ressourcen sind nicht begrenzt

Beispiele

• QUEUE, MAX_SLOTS
  Das folgende Script liest die maximale Anzahl der Slots eines Queue-Objekts und schreibt den Wert in den Aktivierungsreport.

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

• QUEUE, STATE
  Das folgende Script ruft den aktuellen Status eines Queue-Objekts ab und schreibt den Status in den Aktivierungsreport. 

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

• SET_TRACE
  Das folgende Script liest die Trace-Optionen des AE-Systems AEPROD.

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

• SET_TRACE, mit zusätzlichen Optionen
  Die folgenden Scripts lesen Trace-Optionen für das aktuelle AE-System.

  :SET &TARGET# = GET_UC_SETTING(SET_TRACE, &$SYSTEM#, TRACE_TARGET)
  : PRINT "Traces werden in &TARGET# geschrieben"

  :SET &BUFFER# = GET_UC_SETTING(SET_TRACE, &$SYSTEM#, MAX_BUFFER_SIZE)
  : PRINT "Die maximale für den Speicher-Trace definierte Puffergröße beträgt: &BUFFER#"

  :SET &SEARCH# = GET_UC_SETTING(SET_TRACE, &$SYSTEM#, SEARCH_TEXT)
  : PRINT "Das AE-System sucht nach dem folgenden Text: &SEARCH#"

• SERVER_MODE
  Das folgende Script ruft den Typ des Serverprozesses AE #WP003 ab.

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

• SERVER_OPTIONS
  Das folgende Script liest die dritte Stelle der Serveroptionen. Diese Einstellung legt fest, ob die statistischen Aufzeichnungen beim Kaltstart des Systems überprüft werden.

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

• WORKLOAD_MAX_JOB
  Das folgende Script ruft die maximale Anzahl der Ressourcen ab, die der Agent WIN01 für Jobs zur Verfügung stellt, und schreibt das Ergebnis in den Aktivierungsreport.

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

Siehe auch: