:DISCONNECT

Script-Anweisung: Trennt eine Verbindung zum AE-System

Syntax

:DISCONNECTVerbindung, Name

Syntax	Beschreibung/Format
Verbindung	Verbindungstyp Format: Script-Literal, Script-Variable oder Zahl Zulässige Werte: "USER", "HOST" und "HOSTGROUP" "USER" = Verbindung eines Benutzers oder einer Benutzergruppe "HOST" = Verbindung eines Agenten "HOSTGROUP" = Verbindung von Agenten, die zu einer Agentengruppe gehören
Name	Name eines Benutzers, einer Benutzergruppe, eines Agenten oder einer Agentengruppe Format: Script-Literal, Script-Variable oder Zahl

Mit der Script-Anweisung können Verbindungen zum AE-System getrennt werden.

Benutzer oder Benutzergruppen müssen zum gleichen Mandanten gehören wie das Objekt, in dessen Script diese Script-Anweisung verwendet wird. Eine Automic Web Interface-Meldung informiert den Benutzer darüber, dass die Verbindung zur Automation Engine unterbrochen wurde, und dass eine erneute Anmeldung erforderlich ist. Bestanden keine aktiven Verbindungen der Benutzer zum AE-System, führt dies nicht zu einem Fehler. Sind hingegen Benutzer oder Benutzergruppen ungültig, wird die Script-Verarbeitung mit einer Fehlermeldung abgebrochen.

:DISCONNECT in Verwendung mit "HOST" oder "HOSTGROUP" beendet einen Agenten nicht, sondern trennt nur temporär die Verbindung. Der Agent verbindet sich wieder mit der Automation Engine, sobald das nächste Signal zur Überprüfung der Agenten gesendet wird. Das Trennen der Verbindung zu einem Agenten ist beispielsweise dann sinnvoll, wenn ein neuer Kommunikationsprozess gestartet wird und die Agenten sich umverteilen sollen. Verwenden Sie die Script-Anweisung :TERMINATE, um einen Agenten zu beenden.

Statt eines einzelnen Agenten kann auch eine Agentengruppe angegeben werden. Die Trennung der Verbindung wird für alle Agenten, die dieser Gruppe angehören, durchgeführt.

 Um diese Script-Anweisung ausführen zu können, benötigt ein Benutzer das Recht "Abbrechen" für den Benutzer bzw. Agenten.

Beispiel

Dieses Beispiel trennt den Benutzer "SMITH/AE" vom AE-System.

:DISCONNECT "USER", "SMITH/AE"

Der Agent WIN01 ist vom AE-System getrennt.

:DISCONNECT "HOST", "WIN01"

Alle Datenbank-Agenten sind im folgenden Beispiel von der Trennung betroffen.

:DISCONNECT "HOSTGROUP", "HOSTG_DB_UNIX"

Siehe auch: