SYS_HOST_ALIVE

Verwenden Sie die Script-Funktion SYS_HOST_ALIVE, um zu prüfen, ob ein bestimmter Agent aktiv ist. Die Script-Funktion unterscheidet zwischen BS-Agenten, ERP-Agenten und Datenbank-Agenten und verarbeitet ihre Parameter abhängig davon, welchen Agenten Sie definieren.

Syntax

SYS_HOST_ALIVE (Host[,Verbindung])

Parameter

• SYS_HOST_ALIVE
  Prüft, ob ein bestimmter Agent aktiv ist.
• Host
  Name des Agenten, dessen Aktivitätsstatus Sie prüfen möchten
  Format: AE Name oder Script_Variable
• Verbindung
  (Optional) Name eines Verbindungsobjekts des Typs "R3" oder "DB", das Sie verwenden möchten, um die Verfügbarkeit des SAP-Systems oder der SAP-Datenbank zu prüfen. Dieser Parameter kann nur verwendet werden, wenn für Host ein SAP-Agent oder ein Datenbank-Agent angegeben wird. Das System prüft nicht, ob der Datenbank-Agent, der die SQL-Variablen auflöst, gestartet wurde. Bei SAP müssen Sie das Verbindungsobjekt eingeben, das auf der Seite "Agent" des Agentenobjekts definiert ist. Der Parameter Host ist optional, wenn Sie ein Verbindungsobjekt des Typs "DB" angeben.
  Format: AE-Name oder Script-Variable
  

Rückgabewerte

Wenn ein Host angegeben wird:

• Y
  Der Agent ist aktiv.
• N
  Der Agent ist inaktiv.

Wenn ein Host und ein Verbindungsobjekt angegeben werden:

• Y
  Der Agent ist aktiv und das SAP-System bzw. die SAP-Datenbank ist verfügbar.
• N
  Der Agent ist aktiv, kann aber keine Verbindung zum SAP-System bzw. zur SAP-Datenbank herstellen.
• ?
  Der Agent ist nicht aktiv. Daher kann das System nicht feststellen, ob das SAP-System oder die SAP-Datenbank verfügbar ist.

Hinweis: "N" wird auch zurückgegeben, wenn ein Agent nicht dem Mandanten zugeordnet ist, auf dem das Script ausgeführt wird, weil der Agent für diesen Mandanten nicht verfügbar ist. Weitere Informationen finden Sie unter Zuordnen von Mandanten zu Agenten.

Betriebssystem-Agenten

Die Script-Funktion SYS_HOST_ALIVE prüft, ob der Agent aktiv ist. Sie können den Parameter Verbindung nicht verwenden.

Beispiel

Das folgende Beispiel prüft, ob der Windows-Agent WIN21 aktiv ist. Ist der Agent inaktiv, wird eine Meldung an den Administrator gesendet.

: IF   SYS_HOST_ALIVE ( "WIN21" ) = "N"
:    SEND_MSG "ADMIN" , "AE" , "Agent WIN21 ist nicht aktiv!"
: ENDIF

ERP-Agenten

PeopleSoft-Agenten

Wenn der Agent aktiv, aber die Enterprise Business Solution nicht verfügbar ist, lautet der Rückgabewert "N".

SAP-Agenten

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

Wichtig! Der SAP-Agent öffnet einige Verbindungen nur auf Anfrage (HTTP) und beendet sie automatisch, wenn sie seit einiger Zeit nicht verwendet wurden (ABAP). Eine neue Verbindung wird eingerichtet, wenn es keine Verbindung zum SAP-System gibt, wenn Sie mit SYS_HOST_ALIVE prüfen, ob das SAP-System verfügbar ist. Beachten Sie in diesem Zusammenhang Folgendes:

• Wenn das SAP-System nicht verfügbar ist, sollten Sie eine lange Timeoutdauer erwarten.
• Wenn eine Verbindung zum SAP-System besteht, diese aber bereits ausgelastet ist, müssen Sie eine neue Verbindung herstellen, um sicherzustellen, dass das SAP-System reagieren kann.
• Das Aufbauen einer zusätzlichen Verbindung kann zu Fehlern führen, wenn z. B. das CPIC-Limit von SAP überschritten wird. In diesem Fall gibt SYS_HOST_ALIVE "N" zurück, obwohl über bestehende Verbindungen bereits Jobs ausgeführt werden.
• Wenn Sie ein Verbindungsobjekt ändern, müssen Sie den SAP-Agenten neu starten, um die Änderungen zu übernehmen.

Beispiel

Das folgende Beispiel prüft, ob das SAP-System für Agent SAP01 verfügbar ist.

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

Datenbank-Agent

Wie in SAP können Sie den Agenten oder zusätzlich ein Verbindungsobjekt des Typs "Datenbank" angeben. Mit der Definition eines Verbindungsobjekts haben Sie die Möglichkeit, zusätzlich die Verfügbarkeit der jeweiligen Datenbank zu prüfen.

Siehe auch: