Script statement: Disconnects a connection to the AE system
:DISCONNECT Connection, Name
This script statement can be used to disconnect connections to the AE system.
Users or user groups must belong to the same clientA closed environment within an Automation Engine system where you can create and run objects. A client name consists of a 4-digit number that must be indicated when a user logs on to the Automation Engine system. Users and their rights are also defined in clients. A particular Automation Engine object type. as the objectAutomation Engine controlled activities and processes are structured in the form of objects. See also: Task in whose script this script statement is used. A UserInterfaceThis is the Automation Engine's graphical user interface. [Formerly called the "Rich Client", "RichGUI" and "Dialog Client."] message informs the user that the connection to the Automation EngineThis component drives an Automation Engine system and consists of different types of server processes. has been interrupted and that logging on again is required. This does not result in an error if there were no active connections to the AE system. If users or user groups are invalid, script processing is aborted and an error message is sent.
:DISCONNECT used in combination with "HOST" or "HOSTGROUP" does not terminate the agent but ends the connection temporarily. The agent reconnects to the Automation Engine as soon as the next signal which checks the agents is sent. Disconnecting an agent connection is useful when a new communication processA communication process is part of the component Automation Engine. It is responsible for connecting the components. starts and the agents rearrange. Use the script element :TERMINATE to end an agent.
Instead of specifying individual agents, you can also indicate an agent group. The termination then applies to all agents that belong to this groupAn Automation Engine object type that integrates tasks so that they can be processed together..
This
script statement can only be processed if the user or agent is authorized
to "cancel" processes.
This example disconnects the user "SMITH/AE" from the AE system.
:DISCONNECT "USER", "SMITH/AE"
The agent WIN01 is disconnected from the AE system.
:DISCONNECT "HOST", "WIN01"
Below, all databaseA database is an organized collection of data including relevant data structures. agents are disconnected.
:DISCONNECT "HOSTGROUP", "HOSTG_DB_UNIX"
See also:
Script element | Description |
---|---|
Ends an agent, a work or communication process | |
:SHUTDOWN | Ends an AE system |
Script Elements - System Conditions and Settings
About Scripts
Script Elements - Alphabetical Listing
Script Elements - Ordered by Function
Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support |
Copyright © 2016 Automic Software GmbH |