SYS_HOST_ALIVE

Script-Funktion: Überprüft, ob ein bestimmter Agent 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-Verbindungsobjekts, mit dem die Verfügbarkeit des SAP-Systems 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 auf der Registerkarte Agent eingestellt haben. Wird ein DB Verbindungs-Objekt angegeben, ist der Parameter Host optional. Achtung! 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.

Betriebssystem-Agenten

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

ERP-Agenten

ERP-Agent PeopleSoft: Der Wert "N" wird geliefert, wenn der Agent aktiv ist, die Enterprise Business Solution aber nicht verfügbar ist.

SAP-Agenten: Es gibt zwei Optionen. Sie können den Parameter Host nur angeben, um zu prüfen, ob der SAP-Agent aktiv ist. Um zu prüfen, ob das SAP-System verfügbar ist, können Sie zusätzlich das entsprechende SAP-Verbindungsobjekt angeben.

Achtung! Beachten Sie, dass der SAP-Agent einige Verbindungen nur bei Bedarf öffnet (HTTP) oder automatisch beendet, wenn sie für eine bestimmte Zeit nicht benutzt wurden (ABAP). Eine neue Verbindung wird eingerichtet, wenn es keine Verbindung zum SAP-System gibt, wenn Sie SYS_HOST_ALIVE verwenden, um zu prüfen, ob das SAP-System zur Verfügung steht. Beachten Sie in diesem Zusammenhang folgende wichtige Hinweise:

• Das SAP-System ist nicht verfügbar: Dies kann zu einer langen Zeitüberschreitung führen.
• Es besteht eine Verbindung zum SAP-System, sie wird jedoch verwendet: Sie müssen eine neue Verbindung herstellen, um sicherzustellen, dass das SAP-System weiterhin verfügbar ist.
• 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 Verbindungsobjekts 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 Verbindungsobjekts haben Sie die Möglichkeit, zusätzlich die Verfügbarkeit der jeweiligen Datenbank zu überprüfen.

Beispiele

Das folgende Beispiel prü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 ist nicht aktiv!"
: ENDIF

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

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

Siehe auch: