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

:TERMINATE

Script-Anweisung: Beendet einen Agenten, die Agenten einer AgentenGruppe, einen Arbeits- oder Kommunikationsprozess.

Syntax

:TERMINATE [Connection], Name

Syntax	Beschreibung/Format
Verbindung	Art der Verbindung. Format: AE-Name, Script-Literal oder Script-Variable Erlaubte Werte: "HOST" (Standardwert), "HOSTGROUP" und "SERVER" "HOST" = Agent "HOSTGROUP" = Agenten einer AgentenGruppe "SERVER" = Arbeits- bzw. Kommunikationsprozess.
Name	Name eines Agenten, einer AgentenGruppe, eines Arbeits- oder Kommunikationsprozesses. Format: Script-Literal oder Script-Variable

Syntax

Beschreibung/Format

Verbindung

Art der Verbindung.
Format: AE-Name, Script-Literal oder Script-Variable

Erlaubte Werte: "HOST" (Standardwert), "HOSTGROUP" und "SERVER"
"HOST" = Agent
"HOSTGROUP" = Agenten einer AgentenGruppe
"SERVER" = Arbeits- bzw. Kommunikationsprozess.

Name

Name eines Agenten, einer AgentenGruppe, eines Arbeits- oder Kommunikationsprozesses.
Format: Script-Literal oder Script-Variable

Kommentare

Mit der Script-Anweisung können Agenten sowie Arbeits- und Kommunikationsprozesse beendet werden. Der Parameter Verbindung muss nicht angegeben werden, wenn das Ende eines Agenten eingeleitet werden soll. Es ist jedoch das Komma für den nicht verwendeten Parameter zu setzen.

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.

Soll die Verbindung zu einem Agenten nur kurzzeitig getrennt werden, empfiehlt es sich, das Script-Sprachmittel :DISCONNECT zu verwenden. Hier verbindet sich der Agent wieder zum Server, sobald das nächste Signal zur Überprüfung der Agenten gesendet wird. Mit :SHUTDOWN können alle Arbeits- und Kommunikationsprozesse des Automation Engine Systems beendet werden.

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

Beispiele

Im Beispiel wird ein Arbeitsprozess beendet.

:TERMINATE SERVER,"AE#WP001"

In diesem Beispiel wird der Agent "WIN21" beendet. Auf die Angabe der Verbindungsart wird dabei verzichtet.

:TERMINATE ,"WIN21"

Siehe auch:

Script-Sprachmittel/Script-Funktion	Beschreibung
:DISCONNECT	Trennt eine Verbindung zum Automation Engine System.
:SHUTDOWN	Beendet ein Automation Engine System.
MODIFY_SYSTEM	Führt ServiceManager-Aktionen oder Queue-Modifikationen durch.

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