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 unterUC_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:

seealso

Script-Elemente für Systembedingungen und -einstellungen