Automation Engine Script Guide > Ordered by Function > System Conditions and Settings > :DISCONNECT

:DISCONNECT

Script statement: Disconnects a connection to the AE system

Syntax

:DISCONNECT Connection, Name

Syntax

Description/Format

Connection

Type of connection
Format: script literal, script variable or number

Allowed values: "USER", "HOST" and "HOSTGROUP"
"USER" = Connection of a user or user group
"HOST" = Connection of an agent
"HOSTGROUP" = Connection of agents belonging to an agent group

Name

Name of a user, user group, agent or agent group
Format: script literal, script variable or number

Comments

This script statement can be used to disconnect connections to the AE system.

Users or user groups must belong to the same client as the object in whose script this script statement is used. A UserInterface message informs the user that the connection to the Automation Engine 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 process 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 group.

 This script statement can only be processed if the user or agent is authorized to "cancel" processes.

Example

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

:TERMINATE

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