X4 Produktdokumentation

Ping

Dieser Adapter pingt eine IP-Adresse über das Internet Control Message Protocol an. Dabei sendet der Adapter ICMP ECHO REQUESTs oder versucht alternativ, eine TCP-Verbindung auf Port 7 aufzubauen. Wenn über vorausgehende Requests keine Verbindung aufgebaut werden kann und der Port auf einen anderen Wert als 7 gesetzt ist, wird ein weiterer TCP-Request an den angegebenen Port gesendet. Der Adapter gibt ein XML-Dokument mit dem Ergebnis des Echos (true oder false) aus.

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Adapter durchführt.

Mögliche Werte:

  • Ping: Ping ausführen

Parameter

iPAddress

IP-Adresse, an die der Ping gesendet wird

Mögliche Werte:

  • Beliebige IP-Adresse (z. B. 127.0.0.1)

  • 0.0.0.0: Leere IP-Adresse (Standard)

timeout

Zeitbeschränkung für den Verbindungsaufbau in Millisekunden

Mögliche Werte:

  • Beliebige positive ganze Zahl

  • 0: Keine Zeitbeschränkung (Standard)

port

Port für einen erneuten Verbindungsversuch, wenn der erste ICMP-Request fehlschlägt

Mögliche Werte:

  • Beliebige positive ganze Zahl

Statuswerte

1

Die Operation wurde erfolgreich ausgeführt.

0

Die Operation wurde erfolgreich ausgeführt, jedoch ohne Ergebnis.

-1

Die Operation ist aufgrund eines technischen Fehlers fehlgeschlagen.