:DISCONNECT

Script-Statement: Trennt eine Verbindung zum AE-System

Syntax

:DISCONNECT Connection, Name

Syntax	Beschreibung/Format
Connection	Art der Verbindung Format: Script-Literal, Script-Variable oder Zahl Erlaubte Werte: "USER", "HOST" und "HOSTGROUP" "USER" = Verbindung eines Benutzers oder einer Benutzergruppe "HOST" = Verbindung eines Agenten "HOSTGROUP" = Verbindung von Agenten einer Agentengruppe
Name	Name eines Benutzers, einer Benutzergruppe, eines Agenten oder einer Agentengruppe Format: Script-Literal, Script-Variable oder Zahl

Mit dem Script-Statement können Verbindungen zum AE-System getrennt werden.

Benutzer oder Benutzergruppen müssen dem gleichen Mandanten angehören wie das Objekt, in dessen Script dieses Script-Statement verwendet wird. Der Benutzer wird durch eine Automic Web Interface-Meldung darauf aufmerksam gemacht, dass die Verbindung zur Automation Engine zwischenzeitlich unterbrochen war und er sich neu anmelden müsse. 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 zur 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 zum Beenden eines Agenten das Script-Sprachmittel :TERMINATE.

Anstatt 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 dieses Script-Statement 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: