SYS_INFO

Script-Funktion: Liest AE-Systeminformationen

Automation Engine Version

Syntax

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

Syntax	Beschreibung/Format
component	Komponente deren Version ermittelt werden sollen. Format: Script-Literal oder Script-Variable Erlaubte Werte: „SERVER“ und „INITIALDATA“
VERSION	Dieses Schlüsselwort bewirkt, dass die Automation Engine-Version der Komponente abgerufen wird.
type	Hier wird der Teil der Version angegeben, der gelesen werden soll. Format: AE-Name, Script-Literal oder Script-Variable Erlaubte Werte: „MAJOR“ - Hauptversion „MINOR“ - Nebenversion „PATCH“ - Service-Paketnummer „RELEASE_IDENTIFIER„ - Art und Nummer des Builds „ALL“ (Standard) - Die vollständige Version.
component name	Name des Agenten, dessen Version ermittelt werden soll. Format: AE-Name, Script-Literal oder Script-Variable

Rückgabewerte
Die Automation Engine-Version der erforderlichen 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.

Rückgabewerte

Die Automation Engine-Version der erforderlichen 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.

Diese Script-Funktion ruft die Version der Automation Engine, eines Agenten oder der Initialdaten der AE-Datenbank ab.

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.

Eine Automation Engine-Version besteht aus verschiedenen Informationen (Hauptversion, Nebenversion usw.). Um nur einen bestimmten Teil der Versionen auszulesen, kann der Parameter Typ verwendet werden.

Beispiele

Im folgenden Beispiel wird die Version der Automation Engine ausgelesen:

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

Das zweite Beispiel ruft die Version der Initialdaten der AE-Datenbank ab.

: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, wie zum Beispiel Major-, Minor-, Service-Pack - Versions- 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 Aktivierungsreport:

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

Workload

Syntax

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

Syntax	Beschreibung/Format
Nachrichtenwarteschlange	Die Nachrichtenwarteschlange, über die Informationen abgerufen werden sollen. Format: Script-Literal oder Script-Variable Erlaubte Werte: „MQPWP“, „MQWP“, „MQDWP“, „MQOWP“ und „MQRWP“ „MQPWP“ - Nachrichtenwarteschlange des primären Arbeitsprozesses. „MQWP“ - Nachrichtenwarteschlange der Arbeitsprozesse. „MQDWP“ - Nachrichtenwarteschlange der Dialogprozesse. „MQOWP“ - Nachrichtenwarteschlange für Outputs. „MQRWP“ - Nachrichtenwarteschlange für Ressource-Berechnungen
BUSY	Liefert die prozentuale Auslastung der Automation Engine.
ANZAHL	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-Lateral oder Script-Variable Erlaubte Werte: „01“, „10“ und „60“ „01“ - Die letzte Minute. „10“ - Die letzten 10 Minuten. „60“ - Die letzte Stunde.

Rückgabewerte
„20876“ - Die Nachrichtenwarteschlange existiert nicht. „20864“ - Der zweite Parameter ist ungültig. „20877“ - Der Zeitraum entspricht nicht den erlaubten Werten. BUSY: Die Automation Engine-Auslastung in Prozent. ANZAHL: Anzahl der Nachrichten in der Warteschlange. LENGTH: Durchschnittliche Dauer für die Abarbeitung der Nachrichtenwarteschlange

Rückgabewerte

„20876“ - Die Nachrichtenwarteschlange existiert nicht.
„20864“ - Der zweite Parameter ist ungültig.
„20877“ - Der Zeitraum entspricht nicht den erlaubten Werten.

BUSY:
Die Automation Engine-Auslastung in Prozent.

ANZAHL:
Anzahl der Nachrichten in der Warteschlange.

LENGTH:
Durchschnittliche Dauer für die Abarbeitung der Nachrichtenwarteschlange

Die Script-Funktion ermittelt Daten zu den Nachrichtenwarteschlangen.

Tipp: Sie können den Prozentsatz der Systemlastkapazität, die die Automation Engine verwendet, mit dem Schlüsselwort BUSY oder mit den folgenden Script-Funktionen abrufen:

Beispiele

Das erste Beispiel ruft die Arbeitslast 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