Gestion des requêtes
Utilisez cette fonction pour lister et suivre les requêtes envoyées au serveur batch, 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é.
Vous pouvez l’utiliser pour suspendre et relancer des tâches, ou pour lancer des abonnements.
Vous pouvez vérifier le statut du serveur batch. Un identifiant de traitement individuel est attribué à chaque tâche exécutée par le serveur batch.
Prérequis
Reportez-vous à la documentation de Mise en oeuvre
Gestion de l'écran
La fonction de gestion des requêtes permet d'afficher la liste des requêtes soumises au serveur (qu'elles aient été ou non lancées) et leur état.
Onglet Écran de saisie
Présentation
Chaque ligne de la table des résultats des requêtes correspond à une tâche (déjà lancée ou non) envoyée au serveur batch. Chaque tâche est associée à un statut et à un code couleur illustrant ce statut. Les couleurs standard sont les suivantes :
- Vert. Requête en cours d’exécution.
- Noir. Requête terminée sans erreurs.
- Rouge. Requête suspendue ou stoppée avec erreurs.
- 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. |
|
|
| 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. |
| 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). |
Bloc numéro 2
| 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
Cliquez sur Saisie des paramètres depuis l’icône Actions pour modifier les paramètres de la requête, qu’elle soit en attente de lancement, ou déjà terminée.
Interruption
Cliquez sur Interruption depuis l’icône Actions pour interrompre l’exécution de cette requête. Un message vous demande de confirmer l’interruption de la requête.
Modification
Cliquez sur Modification depuis l’icône Actions pour modifier, avant le lancement, la date et l’heure de lancement, et la priorité d’exécution de la requête.
Trace
Cliquez sur Trace depuis l’icône Actions pour afficher le fichier trace de la requête exécutée. Le fichier trace porte le préfixe ‘RQT’ suivi du numéro de requête. Ce fichier se trouve dans le répertoire TRA du répertoire SERVX3, lui-même situé dans le répertoire Runtime.
Relancer requête
Cliquez sur Relancer requête depuis l'icône Actions pour créer une nouvelle requête avec les mêmes paramètres d’exécution que cette requête d’origine.
Par défaut, la nouvelle requête est exécutée le même jour, quelques minutes après avoir sélectionné cette action. Utilisez l’action Modification pour modifier la date et l’heure du lancement de la nouvelle requête.
La tâche d’origine 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 abonnement
Cliquez sur Relancer abonnement depuis l’icône Actions pour relancer la requête en tant qu’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
Bloc numéro 3
Bloc numéro 4
Fermer Cliquez sur l'action Requête pour soumettre une nouvelle requête. |
Cliquez sur l'action Actualiser pour rafraîchir la liste des tâches et les statuts associés. Vous pouvez également appuyer sur la touche F5. |
Cliquez sur l'action Epuration pour épurer les lignes de la table. Toutes les requêtes terminées à une date donnée (définie dans un écran distinct) sont supprimées de la liste des tâches. |
Cliquez sur l’action Information pour afficher les détails du serveur batch courant. |
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 s’affiche si vous tentez de supprimer une tâche qui a été exécutée.
Pas de requête en cours
La requête d’exécution, ou la table des requêtes exécutées, sont vides. Cela peut se produire après l’épuration, ou si le serveur batch n’a pas été démarré.
Tableau plein
Il y plus de lignes que le gestionnaire de requêtes ne peut en afficher dans son tableau. Seules les premières ‘n’ lignes sont 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.
L'état du serveur est indiqué (Actif/Inactif), ainsi que le numéro de processus correspondant, s'il est actif. Le fait que le serveur soit inactif n'empêche pas de soumettre des requêtes. Cependant, elles ne seront pas exécutées immédiatement, même à l'heure de déclenchement.