Il est possible de contrôler certaines fonctions du gestionnaire de travaux par une ligne de commande. Cela permet de déclencher en mode batch l'arrêt du gestionnaire, le démarrage d'un agent, etc.
La commande permet d'envoyer des notifications au gestionnaire.
Il est nécessaire de disposer des droits d'administration sur le gestionnaire de travaux pour utiliser cette commande.
La syntaxe de la commande est la suivante :
gsnotify.exe <FichierIniEnvironnement> [<FichierIniUtilisateur>] [ d<serveur_logique>] [ u<utilisateur> p<mot_de_passe>] " nnotification" ....
Les paramètres sont :
Nom paramètre | Description |
FichierEnvironnement | Fichier de paramètres du gestionnaire de travaux. |
FichierUtilisateur | Fichier de paramètres utilisateur (optionnel). |
-d<serveur_logique> | Serveur logique pour la connexion. |
-u<utilisateur> | Nom de l'utilisateur. |
-p<mot_de_passe> | Mot de passe de l'utilisateur. |
-n<notification> | Notification à envoyer. |
... | Paramètres supplémentaires spécifiques aux notifications. |
D'une façon générale, les notifications et leurs paramètres (nom de GTS, nom d'agent...) sont sensibles à la casse.
Le statut de la commande peut être vérifié à l'aide du niveau d'erreur ("errorlevel") :
• errorlevel 0 : aucune erreur rencontrée.
• errorlevel 1 : avertissements rencontrés, le traitement a abouti.
• errorlevel 2 : erreur rencontrée, le traitement a été interrompu.
Les notifications reconnues sont listées ci-dessous.
Notification <activate_queue>
Cette notification permet de contrôler l'activation ou la désactivation des files d'attente du GTS. Attention, Le blocage des files d'attente est immédiat.
Les paramètres sont :
Nom paramètre | Description |
-s<liste_gts> | Liste des GTS à notifier (ex : –sGTS1;GTS2). Par défaut : *ALL (tous les GTS actifs). |
-q<liste_files> | Liste des identifiants de files d'attente (ex : -q1;2). Par défaut : *ALL (toutes les files d'attente). |
-a<0|1> | Activation de la file. Par défaut : -a1. |
Par exemple :
• Désactivation globale des files d'attente
gsnotify -nactivate_queue -a0
• Activation des files 1 et 2 sur GTS1 et GTS2
gsnotify -nactivate_queue -sGTS1;GTS2 -q1;2 -a1
Notification <stop_service>
Cette notification permet de forcer l'arrêt des GTS spécifiés en paramètre.
Les paramètres sont :
Nom paramètre | Description |
-s<liste_gts> | Liste des GTS à notifier (ex : –sGTS1;GTS2). Par défaut : *ALL (tous les GTS actifs). |
Par exemple :
• Arrêt de tous les GTS :
gsnotify -nstop_service
• Arrêt des GTS GTS1 et GTS2 :
gsnotify -nstop_service -sGTS1;GTS2
Notification <kill_job>
Cette notification permet de forcer l'arrêt des travaux spécifiés.
Les paramètres sont :
Nom paramètre | Description |
-j<liste_ids_travaux> | Liste des identifiants GTS de travaux à arrêter (ex : -j2236;2238). Pas de valeur par défaut. |
Par exemple :
• Arrêt des jobs 2336 et 2337 :
gsnotify -nkill_job -j2336;2337
Notification <start_agent>
Cette notification permet de lancer les agents spécifiés en paramètre.
Les paramètres sont :
Nom paramètre | Description |
-a<liste_agents> | Liste des agents (ex : -aagent1;agent2). Valeur par défaut : *ALL (tous les agents non démarrés, non désactivés). |
Par exemple :
• Démarrage des agents "test 1" et "test 2" :
gsnotify –nstart_agent “-atest 1;test 2”
• Démarrage de tous les agents :
gsnotify –nstart_agent
Notification <stop_agent>
Cette notification permet d'arrêter les agents spécifiés en paramètre.
Les paramètres sont :
Nom paramètre | Description |
-a<liste_agents> | Liste des agents (ex : -aagent1;agent2). Valeur par défaut : *ALL (tous les agents non démarrés, non désactivés). |
-t<timeout> | Temps laissé à l'agent pour s'arrêter (ex : -t30s). Par défaut : 0 (attente indéfinie). Les valeurs possibles sont : • -1 arrêt immédiat (équivalent de la commande kill), • 0 attente indéfinie, • >0 temps d'arrêt spécifié. l'agent sera tué s'il ne s'arrête pas dans le délai spécifié. L'unité par défaut est la minute (-t5 = 5 minutes, mais il est possible de la spécifier (h/m/s) : -t5h = 5 heures, -t5s = 5 secondes). |
-wait | La commande vérifie que les notifications ont été prises en compte avant de rendre la main. Dans ce cas, la commande rendra la main si : • les agents spécifiés sont terminés, • les GTS en cause ne répondent plus (la détection peut prendre jusqu'à une minute), • une erreur se produit lors de l'interrogation du statut des agents. |
Par exemple :
• Arrêt des agents "test 1" et "test 2" avec attente indéfinie :
gsnotify –nstop_agent “-atest 1;test 2” -wait
• Arrêt de tous les agents avec un timeout de 5 minutes et attente de la prise en compte :
gsnotify –nstop_agent –t5m -wait
