Instruction de script : Déconnecte une connexion au système AE.
Syntaxe
:DISCONNECT Connection, Name
|
Syntaxe |
Description / format |
|---|---|
|
Connection |
Type de connexion. Valeurs autorisées : "USER", "HOST" et "HOSTGROUP" |
|
Name |
Nom d'un utilisateur, d'un groupe d'utilisateurs, d'un agent ou d'un groupe d'agents. |
Cette instruction de script permet de se déconnecter du système AE.
Les utilisateurs ou les groupes d'utilisateurs doivent appartenir au même client que l'objet dans lequel l'instruction de script est utilisée. Un message Interface Web Automic informe l'utilisateur que la connexion à Automation Engine a été interrompue et qu'une reconnexion est nécessaire. Ceci ne génère pas d'erreur si aucune connexion au système AE n'est active. Si des utilisateurs ou des groupes d'utilisateurs ne sont pas valides, le traitement du script s'interrompt et un message d'erreur est envoyé.
:DISCONNECT, utilisé avec "HOST" ou "HOSTGROUP", n'arrête pas l'agent mais interrompt temporairement la connexion. L'agent se reconnecte à Automation Engine dès que le prochain signal de vérification des agents est envoyé. L'arrêt de la connexion d'un agent est utile si un nouveau processus de communication est démarré et que les agents doivent être redistribués. Pour arrêter un agent, utilisez le script :TERMINATE.
Au lieu de spécifier des agents individuels, vous pouvez également indiquer un groupe d'agents. La déconnexion se fait pour tous les agents de ce groupe.
Cette instruction de script ne peut être exécutée que si l'utilisateur ou l'agent dispose du droit d'interrompre un processus.
Exemple
Cet exemple déconnecte l'utilisateur "SMITH/AE" du système AE.
:DISCONNECT "USER", "SMITH/AE"
L'agent WIN01 est déconnecté du système AE.
:DISCONNECT "HOST", "WIN01"
Dans l'exemple suivant, tous les agents de base de données sont déconnectés.
:DISCONNECT "HOSTGROUP", "HOSTG_DB_UNIX"
Voir aussi :