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

SYS_HOST_ALIVE

Script-Funktion: Überprüft, ob ein bestimmter Host aktiv ist.

Syntax

SYS_HOST_ALIVE(Host, [Verbindung])

Syntax	Beschreibung/Format
Host	Name des Agenten dessen Aktivität überprüft werden soll. Format: AE-Name oder Script-Variable.
Verbindung	Name eines R3 oder DB Verbindungs-Objektes mit dem die Verfügbarkeit des SAP-Systemes bzw. der Datenbank überprüft werden soll. Format: AE-Name oder Script-Variable Geben Sie bei SAP ein Verbindungs-Objekt an, das Sie im Agent-Objekt in der Registerkarte Agent eingestellt haben! Wird ein DB Verbindungs-Objekt angegeben, ist der Parameter Host optional! Dieser Parameter kann nur verwendet werden, wenn für Host entweder ein SAP-Agent oder ein Datenbank-Agent angegeben wird! Dabei wird nicht geprüft, ob der Datenbank-Agent für die Auflösung von SQL-Variablen gestartet wurde.

Syntax

Beschreibung/Format

Host

Name des Agenten dessen Aktivität überprüft werden soll.
Format: AE-Name oder Script-Variable.

Verbindung

Name eines R3 oder DB Verbindungs-Objektes mit dem die Verfügbarkeit des SAP-Systemes bzw. der Datenbank überprüft werden soll.
Format: AE-Name oder Script-Variable

Geben Sie bei SAP ein Verbindungs-Objekt an, das Sie im Agent-Objekt in der Registerkarte Agent eingestellt haben!

Wird ein DB Verbindungs-Objekt angegeben, ist der Parameter Host optional!

Dieser Parameter kann nur verwendet werden, wenn für Host entweder ein SAP-Agent oder ein Datenbank-Agent angegeben wird! Dabei wird nicht geprüft, ob der Datenbank-Agent für die Auflösung von SQL-Variablen gestartet wurde.

Rückgabewerte
Bei der Angabe eines Hosts: "Y" - Der Agent ist aktiv. "N" - Der Agent ist nicht aktiv. Bei der zusätzlichen Angabe eines Verbindungs-Objektes: "Y" - Der Agent ist aktiv und das SAP-System bzw. die Datenbank ist verfügbar. "N" - Der Agent ist aktiv. Er kann allerdings keine Verbindung zum SAP-System bzw. zur Datenbank aufbauen. "?" - Der Agent ist nicht aktiv. Es kann nicht ermittelt werden, ob das SAP-System bzw die Datenbank verfügbar ist.

Rückgabewerte

Bei der Angabe eines Hosts:

"Y" - Der Agent ist aktiv.
"N" - Der Agent ist nicht aktiv.

Bei der zusätzlichen Angabe eines Verbindungs-Objektes:

"Y" - Der Agent ist aktiv und das SAP-System bzw. die Datenbank ist verfügbar.
"N" - Der Agent ist aktiv. Er kann allerdings keine Verbindung zum SAP-System bzw. zur Datenbank aufbauen.
"?" - Der Agent ist nicht aktiv. Es kann nicht ermittelt werden, ob das SAP-System bzw die Datenbank verfügbar ist.

Anmerkungen

Betriebssystem-Agenten

Die Script-Funktion prüft, ob der Agent aktiv ist. Der Parameter Verbindung kann nicht angegeben werden.

ERP-Agenten

Für die ERP-Agenten Peoplesoft, OracleApplications und Siebel: wird auch dann der Wert "N" zurückgeliefert, wenn der Agent zwar aktiv, die Enterprise Business Solution jedoch nicht verfügbar ist.

Bei SAP-Agenten haben Sie die Wahl. Geben Sie nur den Parameter Host an, wenn Sie überprüfen möchten, ob der SAP-Agent aktiv ist.Benötigen Sie die Information, ob eine das SAP-System erreichbar ist, können Sie das zugehörige SAP Verbindungs-Objekt angeben.

Beachten Sie, dass der SAP-Agent manche Verbindungen erst bei Bedarf öffnet (HTTP) oder nach längerer Nichtbenutzung automatisch schließt (ABAP). Existiert beim Aufruf von SYS_HOST_ALIVE keine Verbindung zum SAP-System, so wird eine neue Verbindung aufgebaut, damit geprüft werden kann, ob das SAP-System erreichbar ist. Beachten Sie in diesem Zusammenhang folgende wichtige Hinweise:

Ist das SAP-System nicht erreichbar, müssen Sie möglicherweise auf ein langes Timeout warten.
Besteht zwar eine Verbindung zum SAP-System muss trotzdem eine neue Verbindung aufgebaut werden, wenn diese gerade verwendet wird. Damit wird sichergestellt, ob das SAP-System tatsächlich noch reagiert.
Das zusätzliche Aufbauen einer Verbindung kann auch zu Fehlern führen, wenn z.B: das CPIC-Limit bei SAP überschritten wird. In diesem Fall liefert SYS_HOST_ALIVE den Rückgabewert "N", obwohl über bereits bestehende Verbindungen Jobs ausgeführt werden.
Die Änderung eines Verbindungs-Objektes wirkt sich erst nach einem Neustart des SAP-Agenten aus!

Datenbank-Agent

Wie bei SAP haben Sie die Möglichkeit, nur den Agenten oder zusätzlich ein Verbindungs-Objekt (Typ: DB) anzugeben. Mit der Angabe eines Verbindungs-Objekt an, haben Sie die Möglichkeit zusätzlich die Verfügbarkeit der jeweiligen Datenbank zu überprüfen.

Beispiele

Im Beispiel wird geprüft, ob der Windows-Agent "WIN21" aktiv ist. Ist der Agent nicht aktiv, wird eine Meldung an den Administrator geschickt.

:IF SYS_HOST_ALIVE("WIN21") = "N"
: SEND_MSG "ADMIN","AE","Agent WIN21 is not active!"
:ENDIF

Das zweite Beispiel ermittelt, ob der Agent SAP01 das SAP-System erreichen kann.

:SET &STATUS# = SYS_HOST_ALIVE("SAP01", "CONN.R3.ECC.ABAP")

Siehe auch:

Script-Sprachmittel	Beschreibung
SYS_ACT_HOST	Ermittelt den Namen des Hosts.

Script-Sprachmittel - Systemzustände und -bedienung

Beispielsammlung:
Darstellungen mittels Cockpit

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