:DISCONNECT

Verwenden Sie die Script-Anweisung :DISCONNECT, um eine Verbindung zum AE-System zu trennen. Benutzer oder Benutzergruppen, die als Verbindungen definiert werden, müssen zum gleichen Mandanten wie das Objekt gehören, in dessen Script Sie diese Script-Anweisung verwenden. 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 muss. Dies führt nicht zu einem Fehler, wenn es keine aktiven Verbindungen zum AE-System gibt. Wenn Benutzer oder Benutzergruppen ungültig sind, wird die Script-Verarbeitung abgebrochen und das System sendet eine Fehlermeldung. Statt eines einzelnen Agenten kann auch eine Agentengruppe als Verbindung angegeben werden. Die Beendigung gilt für alle Agenten, die dieser Gruppe angehören.

Hinweis: Benutzer oder Agenten benötigen das Recht, Prozesse abzubrechen, da andernfalls diese Script-Anweisung nicht verarbeitet werden kann.

Syntax

: DISCONNECT Verbindung, Name

Parameter

• :DISCONNECT
  Trennt eine Verbindung zum AE-System

• Verbindung
  Verbindungstyp
  Format: Script-Literal, Script-Variable oder Zahl
  Zulässige Werte:

  • USER
    Verbindung eines Benutzers oder einer Benutzergruppe
  • HOST
    Verbindung eines Agenten
  • HOSTGROUP
    Verbindung von Agenten einer Agentengruppe

Hinweise

• Wenn :DISCONNECT zusammen mit HOST oder HOSTGROUP verwendet, wird der Agent nicht beendet, aber die Verbindung wird vorübergehend beendet. Der Agent ist wieder mit dem System verbunden, wenn er ein Signal erhält, das den Agenten prüft. Das Trennen einer Agent-Verbindung mit :DISCONNECT ist nützlich, wenn Sie einen neuen Kommunikationsprozess starten und die Agenten neu anordnen möchten.
• Um einen Agenten zu beenden, können Sie die Script-Anweisung :TERMINATE verwenden.

• Name
  Name eines Benutzers, einer Benutzergruppe, eines Agenten oder einer Agentengruppe
  Format: Script-Literal, Script-Variable oder Zahl

Beispiel

Das folgende Beispiel trennt den Benutzer SMITH/AE vom AE-System.

: DISCONNECT "USER" , "SMITH/AE"

Der Agent WIN01 ist vom AE-System getrennt.

: DISCONNECT "HOST" , "WIN01"

Das nächste Beispiel trennt alle Datenbank-Agenten.

: DISCONNECT "HOSTGROUP" , "HOSTG_DB_UNIX"

Siehe auch: