Gestion des requêtes
Cette fonction permet de lister et suivre les requêtes envoyées au serveur de tâches, soit par la fonction de soumission des requêtes, soit par la dépose de fichiers de requête dans un répertoire dédié.
Le progiciel intègre en effet un serveur batch permettant l'exécution de tâches (y compris des éditions) et de groupes de tâches en mode différé. Ces tâches peuvent être lancées directement ou abonnées pour un lancement régulier.
Ce serveur batch est implémenté par l'intermédiaire d'une application SERVX3, dans laquelle se trouve un traitement qui scrute périodiquement une table des requêtes se trouvant dans le dossier superviseur. Lorsque des tâches doivent être déclenchées, elles sont lancées sous la forme de processus adonix séparés dans le dossier de lancement.
Le traitement du serveur batch est à même de lancer et d'arrêter une tâche, et de contrôler le nombre de tâches simultanément actives en limitant leur nombre.
La fonction de gestion de requêtes permet à tout moment de connaître l'état du serveur de requêtes qui peut être dans l'état :
- actif (le numéro de processus est alors affiché)
- en cours d'arrêt
- inactif
Pré-requis
Reportez-vous à la documentation de Mise en oeuvre
Gestion de l'écran
Ecran de saisie
Présentation
La fonction de gestion des requêtes permet de faire apparaître, dans un écran unique, la liste des requêtes soumises au serveur (qu'elles aient été ou non lancées) et leur état.
Selon l'état de la requête, la ligne apparaît en noir (requête terminée sans erreur), en rouge (requête interrompue ou terminée avec des erreurs), en vert (requête en cours d'exécution), ou en bleu (requête en attente d'exécution).
Fermer
Champs
Les champs suivants sont présents dans cet onglet :
Tableau Requêtes
| Ce numéro unique identifie la requête. Il est attribué en partant d'un numéro initial défini dans les paramètres du serveur batch. |
| Définit le dossier dans lequel l'exécution de la tâche a été demandée. |
| Code identifiant la tâche lancée. |
| Définit le code de l'utilisateur ayant lancé la requête. |
| Définit la date et l'heure prévue de lancement de la tâche. |
|
|
| Définit la priorité de lancement (au niveau système) du processus lancé pour exécuter la tâche. |
| Si le champ vaut Oui, la tâche ne peut être exécutée qu'en mode mono-utilisateur sur le dossier. |
| Cet indicateur d'état des requêtes en cours peut prendre les valeurs définies par le menu local 21 : Attente : la requête n'a pas encore été lancée
|
| Définit la date et l'heure de fin d'exécution de la tâche. Ces informations ne sont renseignées que si la tâche a déjà été lancée est si elle est terminée. |
|
|
| Défini par le menu local 20, ce champ détermine si la tâche lancée est un traitement adonix ou un script (shellscript ou fichier de commande) exécuté sur le serveur de traitement. |
| Définit le code du traitement ou du script, lorsque la tâche lancée ne correspond pas à une fonction de base du progiciel. |
| Chaque requête est exécutée par un processus adonix donné sur le serveur d'application. Ce champ identifie le numéro de processus (nommé en général process id, ou pid). |
| Lorsque ce champ n'est pas nul, il définit une durée de time-out, c'est-à-dire une limite de temps au delà de laquelle la tâche est automatiquement arrêtée si elle tourne encore. |
| Définit le numéro de service utilisé pour la connexion à adonix. Lorsqu'il n'est pas spécifié, c'est le numéro de service courant. |
| Lorsque la tâche fait partie d'un groupe de tâches lancé, on retrouve dans le tableau un numéro commun à toutes les tâches du groupe, et un numéro d'ordre dans le groupe (ces champs sont vides si la requête ne fait pas partie d'un groupe). |
|
|
| Lorsque la tâche batch est lancée en fréquence toutes les N minutes, cette colonne précise la valeur de N. |
| Lorsqu'une tâche est abonnée pour être exécutée en fréquence, une seule ligne apparaît pour signaler son exécution, mais à chaque fois qu'elle est relancée, on ajoute 1 à cette colonne. Ainsi, on peut savoir combien de fois elle a été exécutée. |
| Lorsque la tâche a été lancée par l'intermédiaire d'un fichier job (cf. l'annexe technique correspondante), on retrouve ici le nom du fichier qui a été soumis (sans l'extension). |
Serveur
| Cet indicateur, dont les valeurs sont définies par le menu local 8, permet de connaître l'état du serveur batch, et peut prendre les valeurs suivantes :
|
| Identifie le numéro de processus du serveur batch lui-même (nommé en général process id, ou pid). |
| Affiche le numéro de page courante dans le tableau, ainsi que le nombre total de pages. |
Fermer
Icône Actions
Saisie des paramètres
permet de modifier les paramètres d'une requête (qu'elle soit en attente de lancement ou déjà terminée).
Interruption
permet de demander au serveur batch d'interrompre l'exécution d'une tâche.
Modification
permet de modifier la date, l'heure de lancement et la priorité d'exécution d'une requête non encore lancée.
Trace
permet d'afficher la trace d'exécution d'une requête déjà exécutée (elle se trouve dans le répertoire TRA du répertoire SERVX3, lui-même situé dans le répertoire Runtime, et son nom est RQT suivi du numéro de requête)
Relancer
permet de créer une nouvelle tâche, avec les mêmes paramètres de lancement que la précédente. Par défaut, l'exécution est demandée le jour même, dans 5 minutes (ce qui laisse le temps de modifier sa date et son heure de lancement grâce à l'action de Modification). La tâche à relancer doit avoir été lancée sur le dossier courant. Elle peut avoir été lancée par un autre utilisateur, mais sa relance va se faire sur le compte de l'utilisateur courant, après vérification de ses droits.
Relancer groupe
Relancer abonnement
Fermer
Boutons spécifiques
Les champs suivants sont présents dans la fenêtre ouverte par ce bouton : Bloc numéro 1
Bloc numéro 2
Fermer permet de soumettre une nouvelle requête. |
permet de rafraîchir la liste des requêtes et des états correspondants. Cette fonction est aussi accessible via la touche de raccourci |
déclenche l'épuration des lignes du tableau. Les requêtes terminées à une date donnée (saisie dans un écran qui s'ouvre alors) sont supprimées de la liste des tâches. |
Messages d'erreur
Outre les messages génériques, les messages d'erreur suivants peuvent apparaître lors de la saisie :
La requête n'est plus en attente d'exécution
Annulation impossible
Ce message est affiché lorsqu'on tente d'effacer une requête dont l'exécution a déjà eu lieu.
Pas de requête en cours
Le tableau des requêtes à exécuter ou exécuter est vide (ceci peut arriver après une épuration, ou si le serveur batch n'a jamais été lancé).
Tableau plein
Il y plus de lignes que le gestionnaire de requêtes ne peut en afficher dans son tableau : seules les premières lignes seront visibles.
Cette tâche doit être activée depuis le dossier XXXX
On a tenté de relancer une tâche sur un dossier autre que le dossier courant.
En bas de l'écran, l'état du serveur apparaît (Actif/Inactif), ainsi que le numéro de processus correspondant, s'il est actif. Le fait que le serveur est inactif n'empêche pas de soumettre des requêtes (mais par contre, elles ne seront pas exécutées immédiatement même si l'heure de déclenchement est arrivée).