SYS_INFO

Verwenden Sie die Script-Funktion SYS_INFO, um Versionsinformationen aus der Automation Engineabzurufen, oder Informationen zu einer Meldungs-Queue.

Versionsinformationen

Mit dem Schlüsselwort VERSION können Sie die Version von Folgendem abrufen:

• Automation Engine
• Agent
• Anfängliches Datum der Automation Engine-Datenbank

Syntax

SYS_INFO (Komponente,VERSION, [ Typ ], [Komponentenname]) 

Parameter

• SYS_INFO
  Ruft Systeminformationen aus der AE ab

• Komponente
  Gibt an, welcher Typ Versionsinformationen abgerufen werden soll
  Format: Script-Literal oder Script-Variable
  Zulässige Werte:

  • AGENT
    Ruft Versionen eines Agenten ab
    Hinweis: Geben Sie den Agentennamen als den Komponentennamen an
  • SERVER
    Ruft Versionsinformationen zur Automation Engine ab
  • INITIALDATA
    Ruft Versionsinformationen zum anfänglichen Datum der Automation Engine-Datenbank ab

• VERSION
  Schlüsselwort zum Abruf von Versionsinformationen

• Typ
  (Optional) Gibt den Teil der abzurufenden Automation Engine-Version an
  Weitere Informationen finden Sie unter Release-Richtlinie.
  Format: AE-Name, Script-Literal oder Script-Variable
  Zulässige Werte:

  • MAJOR
    Hauptversionsnummer
  • MINOR
    Nebenversionsnummer
  • PATCH
    Service Pack-Nummer
  • RELEASE_IDENTIFIER
    Build-Typ und Nummer
  • ALL (Standard)
    Vollständige Versionsnummer
    

• Komponentenname
  (Nur Agent) Name des Agenten, dessen Version abgerufen werden soll
  Format:AE-Name, Script-Literal oder Script-Variable

Rückgabewerte

Die Script-Funktion hat bei Verwendung des Schlüsselworts VERSION die folgenden Rückgabewerte:

• 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

Beispiele

Im folgenden Beispiel wird die Version der Automation Engine ausgelesen:

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

Das folgende Beispiel ruft die Version der Initialdaten der AE-Datenbank ab:

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

  Das folgende Beispiel liest die Version des Agenten WIN01 aus:

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

Im folgenden Beispiel werden die Teile der Automation Engine-Version (Hauptversion, Nebenversion, Service Pack-Version und Build-Nummer) sowie die vollständige Versionsnummer abgerufen und einzeln in den Aktivierungsreport geschrieben:

: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#"

Die Ausgabe im Aktivierungsreport sieht wie folgt aus:

2019-01-07 14:03:32 - U00020408 Automation Engine - Hauptversion: 12

2019-01-07 14:03:32 - U00020408 Automation Engine - Nebenversion: 3

2019-01-07 14:03:32 - U00020408 Automation Engine - Service Pack: 0

2019-01-07 14:03:32 - U00020408 Automation Engine - Build: +low.build.20821

2019-01-07 14:03:32 - U00020408 Automation Engine - Version: 12.3.0+low.build.20821

Workload

Mit den Meldungs-Queue-Parametern können Sie die folgenden Informationen abrufen:

• Workload der Automation Engine in Prozent
• Anzahl an Meldungen in der Queue
• Durchschnittliche Zeit für die Verarbeitung einer Meldungs-Queue

Syntax

SYS_INFO (MQPWP, BUSY, Periode)
SYS_INFO (Meldungs-Queue, COUNT)
SYS_INFO (Meldungs-Queue, LENGTH, Periode)

• SYS_INFO
  Ruft Systeminformationen aus der AE ab

• Meldungs-Queue
  Gibt die Meldungs-Queue an, über die Informationen abgerufen werden sollen
  Format: Script-Literal oder Script-Variable
  Zulässige Werte:

  • MQPWP
    Meldungs-Queue des primärem Arbeitsprozesses
    
  • MQWP
    Meldungs-Queue des Arbeitsprozesses
  • MQDWP
    Meldungs-Queue des Dialogprozesses
  • MQOWP
    Meldungs-Queue für die Ausgabe
  • MQRWP
    Meldungs-Queue für Ressourcen-Berechnungen

• BUSY
  Schlüsselwort, um die Arbeitslast der Automation Engine in Prozent abzurufen
  Tipp:Sie können auch die folgenden Script-Funktionen verwenden, um den Auslastungsprozentsatz abzurufen:

  • SYS_BUSY_01
  • SYS_BUSY_10
  • SYS_BUSY_60

• COUNT
  Schlüsselwort, um die Anzahl der Nachrichten in der Queue abzurufen

• LENGTH
  Schlüsselwort, um die durchschnittliche Dauer für die Verarbeitung der Meldungs-Queue abzurufen

• Periode
  Zeitperiode, die für die Berechnung der Auslastung oder des durchschnittlichen Verarbeitungszeit verwendet wird
  Format: Script-Literal oder Script-Variable
  Zulässige Werte:

  • 01
    Letzte Minute
  • 10
    Letzte 10 Minuten
  • 60
    Letzte Stunde

Rückgabewerte

Die Script-Funktion gibt die folgenden Werte zurück, wenn Sie diese Schlüsselwörter angeben:

• BUSY: die Auslastung der Automation Engine in Prozent
• COUNT: die Anzahl der Nachrichten in der Queue
• LENGTH: die durchschnittliche Zeit, die benötigt wird, um die Meldungs-Queue zu verarbeiten, angegeben in Sekunden
  Hinweis: Unter normalen Bedingungen ist die durchschnittliche Zeit 0, da die Meldungs-Queue sofort verarbeitet wird. Informationen zu Leistung und Feineinstellung finden Sie unter Automic Automation Systemanforderungen und Dimensionierung.

Die Script-Funktion hat die folgenden Rückgabewerte, wenn Sie die Meldungs-Queue-Parameter verwenden:

• 20876
  Die angegebene Meldungs-Queue existiert nicht
• 20864
  Der zweite Parameter ist ungültig
• 20877
  Die Periode entspricht nicht den zulässigen Werten

Beispiele

Im folgenden Beispiel wird die Arbeitslast der Automation Engine in den letzten 10 Minuten abgerufen. Wenn die Auslastung 80 % überschreitet, wird eine Meldung an einen Benutzer gesendet.

:IF SYS_INFO(MQPWP, BUSY, "10") > 80
:   SEND_MSG SMITH,AE,"Arbeitslast der Automation Engine liegt über 80 %"  
:ENDIF

Das folgende Beispiel liest die Anzahl der Nachrichten aus, die sich in der Queue für die Dialogprozesse befinden.

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

Im folgenden Beispiel wird die durchschnittliche Verarbeitungszeit der Meldungs-Queue des Arbeitsprozesses für die letzte Stunde zurückgegeben. Der Wert wird in den Aktivierungsreport ausgegeben.

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

:PRINT "Aktuelle durchschnittliche Verarbeitungszeit: &DURATION#"

Unter normalen Bedingungen würde dieses Script den Wert 0 abrufen und die folgende Zeile in den Aktivierungsreport ausgeben:

2019-01-08 13:10:01 - U00020408 Aktuelle durchschnittliche Verarbeitungszeit: 0000000000000000

Siehe auch: