Automation Engine Script-Leitfaden > Funktionelle Gliederung > Systemzustände und -bedienung > :DISCONNECT

:DISCONNECT

Script-Anweisung: Trennt eine Verbindung zum Automation Engine System.

Syntax

:DISCONNECT Connection, Name

Syntax	Beschreibung/Format
Verbindung	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

Syntax

Beschreibung/Format

Verbindung

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

Kommentare

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

Benutzer oder BenutzerGruppe müssen dem gleichen Mandanten angehören wie das Objekt, in dessen Script diese Script-Anweisung verwendet wird. Der Benutzer wird durch eine Meldung im UserInterface 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 Automation Engine System, führt dies nicht zu einem Fehler. Sind hingegen Benutzer oder BenutzerGruppe 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 Beendigung 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

Im Beispiel wird der Benutzer "MEIER/AE" vom AE-System getrennt.

:DISCONNECT "USER", "SMITH/AE"

Hier wird der Agent WIN01 vom Automation Engine System getrennt.

:DISCONNECT "HOST", "WIN01"

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

:DISCONNECT "HOSTGROUP", "HOSTG_DB_UNIX"

Siehe auch:

Script-Sprachmittel	Beschreibung
:TERMINATE	Beendet einen Agenten, einen Arbeits- oder Kommunikationsprozess.
:SHUTDOWN	Beendet ein Automation Engine System.

Script-Sprachmittel - Systemzustände und -bedienung

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support