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

SYS_INFO

Script-Funktion: Liest Informationen über das Automation Engine System aus.

Automation Engine-Version

[Automation Engine-Version] [Auslastung]

Syntax

SYS_INFO(component, VERSION, [ type ], [component name]) 

Syntax

Beschreibung/Format

Komponente

Komponente deren Version ermittelt werden sollen.
Format: Script-Literal oder Script-Variable

Erlaubte Werte: "SERVER" und "INITIALDATA"

VERSION

Liefert die Automation Engine-Version der Komponente
Art

Angabe, welcher Teil der Version ausgelesen werden soll.
Format: AE-Name, Script-Variable oder Script-Literal

Erlaubte Werte:
"MAJOR" - Major Version (Hauptversion)
"MINOR" - Minor Version (untergeordnete Version)
"PATCH" - Service-Pack-Nummer
"RELEASE_IDENTIFIER" - Art des Builds und Buildnummer
"ALL" (Standardwert) - Vollständige Version.
Komponenten-Name

Name des Agenten, dessen Version ermittelt werden soll.
Format: AE-Name, Script-Variable oder Script-Literal

Rückgabewerte

Entsprechende Automation Engine-Version der gewünschten Komponente

"20291" - Der angegebene Agent wurde nicht gefunden.
"20680" - Unbekannter Wert für den Versions-Teil.
"20863" - Für die Komponente wurde ein ungültiger Wert angegeben.
"20864" - Der zweite Parameter lautet nicht VERSION.

Anmerkungen

Die Script-Funktion ermittelt die Version der Automation Engine, eines Agenten oder der Initialdaten der Datenbank. Mehr Informationen zum Aufbau der Versionsnummer finden Sie im Kapitel Automation EngineBezeichnung der AE-Versionen.

Um die Version eines Agenten auszulesen, ist der Parameter Komponente auf den Wert "AGENT" zu setzen und bei Komponenten-Name der Name des Agenten anzugeben.

Die Automation Engine-Version setzt sich aus verschiedenen Informationen zusammen (Major-Version, Minor-Version, ...). Um nur einen bestimmten Teil der Versionen auszulesen, kann der Parameter Typ verwendet werden.

Beispiele

Im ersten Beispiel wird die Version der Automation Engine ausgelesen.

:SET  &VERSION# = SYS_INFO(SERVER, VERSION)

Das zweite Beispiel ermittelt die Version der Initialdaten der Datenbank.

:SET  &VERSION# = SYS_INFO(INITIALDATA, VERSION)

  Im dritten Beispiel wird die Version des Agenten WIN01 ausgelesen:

:SET  &VERSION# = SYS_INFO(AGENT, VERSION,,"WIN01")

Das vierte Beispiel ermittelt die einzelnen Teile der Version der Automation Engine (Major-, Minor-, Service-Pack - Version und Build-Nummer) und gibt diese im Aktivierungsreport aus. Im Anschluss wird auch die vollständige Versionsnummer ausgegeben.

:SET  &VERSION# = SYS_INFO(SERVER, VERSION,MAJOR)
:PRINT "Automation Engine - Major Version: &VERSION#"
:SET  &VERSION# = SYS_INFO(SERVER, VERSION,MINOR)
:PRINT "Automation Engine - Minor Version: &VERSION#"
:SET  &VERSION# = SYS_INFO(SERVER, VERSION,PATCH)
:PRINT "Automation Engine - Service Pack: &VERSION#"
:SET  &VERSION# = SYS_INFO(SERVER, VERSION,RELEASE_IDENTIFIER)
:PRINT "Automation Engine - Build: &VERSION#"
:SET  &VERSION# = SYS_INFO(SERVER, VERSION,ALL)
:PRINT "Automation Engine - Version: &VERSION#"

Beispiel für die Ausgabe im Aktivierungsprotokoll:

2013-05-07 16:16:52 - U0020408 Automation Engine - Major Version: 10
2013-05-07 16:16:52 - U0020408 Automation Engine - Minor Version: 0
2013-05-07 16:16:52 - U0020408 Automation Engine - Patch: 0
2013-05-07 16:16:52 - U0020408 Automation Engine - Build: -dev+build.954
2013-05-07 16:16:52 - U0020408 Automation Engine - Version: 10.0.0-dev+build.954

Auslastung

[Automation Engine-Version] [Auslastung]

Syntax

SYS_INFO(MQPWP, BUSY, Period)
SYS_INFO(Message queue, COUNT)
SYS_INFO(Message queue, LENGTH, Period)

Syntax

Beschreibung/Format

Nachrichten-Warteschlange

Nachrichten-Warteschlange, zu der Informationen ermittelt werden sollen.
Format: Script-Literal oder Script-Variable

Erlaubte Werte: "MQPWP", "MQWP" , "MQDWP", "MQOWP" und "MQRWP"

"MQPWP" - Nachrichten-Warteschlange des primären Arbeitsprozesses.
"MQWP" - Nachrichten-Warteschlange der Arbeitsprozesse.
"MQDWP" - Nachrichten-Warteschlange der Dialogprozesse.
"MQOWP" - Nachrichten-Warteschlange für Outputs.
"MQRWP" - Nachrichten-Warteschlange für Ressource-Berechnungen.
BUSY

Liefert die prozentuale Auslastung der Automation Engine.
COUNT Liefert die Anzahl der Nachrichten in der Warteschlange.
LENGTH Liefert die durchschnittliche Dauer für die Abarbeitung der Nachrichten-Warteschlange.
Periode

Zeitspanne, die bei der Berechnung der Auslastung bzw. der durchschnittlichen Abarbeitungszeit herangezogen wird.
Format: Script-Literal oder Script-Variable

Erlaubte Werte: "01", "10" und "60"

"01" - Die letzte Minute.
"10" - Die letzten 10 Minuten.
"60" - Die letzte Stunde.


Rückgabewerte

"20877" - Die Nachrichten-Warteschlange existiert nicht.
"20864" - Der zweite Parameter ist ungültig.
"20877" - Der Zeitraum entspricht nicht den erlaubten Werten.

Bei BUSY:
Prozentuale Auslastung der Automation Engine

Bei COUNT:
Anzahl der Nachrichten in der Warteschlange

Bei LENGTH:
Durchschnittliche Dauer für die Abarbeitung der Nachrichten-Warteschlange

Anmerkungen

Die Script-Funktion ermittelt Daten zu den Nachrichten-Warteschlangen.

Die prozentuale Auslastung der Automation Engine kann nicht nur mit dem Schlüsselwort BUSY abgefragt werden, sondern auch mit den Script-Funktionen SYS_BUSY_01, SYS_BUSY_10 und SYS_BUSY_60.

Beispiele

Das erste Beispiel fragt die Auslastung der Automation Engine während der letzten 10 Minuten ab. Liegt sie über 80%, wird eine Meldung an einen Benutzer geschickt.

:IF SYS_INFO(MQPWP, BUSY, "10") > 80
:   SEND_MSG SMITH,AE,"Workload of Automation Engine is above 80%"  
:ENDIF

Das zweite Beispiel liest die Anzahl der Nachrichten aus, die sich in der Warteschlange der Dialogprozesse befinden.

:SET  &NUMBER# = SYS_INFO(MQDWP, COUNT)

Das dritte Beispiel liefert die aktuelle Abarbeitungszeit der Nachrichten-Warteschlange der Arbeitsprozesse während der letzten Stunde.

:SET &DURATION# = SYS_INFO(MQWP, LENGTH, "60")

 

Siehe auch:

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