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
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.
Les champs suivants sont présents dans cet onglet:
Tableau Requêtes
Numéro (champ NUMREQ) |
Ce numéro identifie la requête. Il s'agit d'un numéro séquentiel affecté automatiquement à partir d'un numéro initial défini dans les paramètres du serveur batch. |
Dossier (champ DOSSIER) |
Ce champ indique le dossier depuis lequel l’exécution de la requête a été demandée. |
Code tâche (champ TACHE) |
Ce code identifie la tâche lancée. |
Langue (champ LAN) |
Ce champ définit la langue dans laquelle une tâche est exprimée. |
Util (champ USER) |
Ce champ définit le code de l'utilisateur qui a lancé la tâche. |
Date (champ DAT) |
Ce champ indique la date de début prévue de la requête. |
Heure (champ HEURE) |
Ce champ détermine l’heure de début prévue de la requête à la date indiquée. |
Mono (champ MONO) |
Ce champ peut avoir pour valeur ‘Oui’ ou ‘Non’. Si le champ a pour valeur ‘Oui’, la requête ne peut être exécutée qu'en mode mono-utilisateur sur le dossier. |
Etat (champ FLAG) |
Ce champ affiche le statut courant de la requête. Les valeurs, définies dans le menu local 21 - Etat avancement requête, sont les suivantes :
|
Heure de fin (champ HFIN) |
Ce champ définit l’heure d’exécution de la requête à la date indiquée. Ce champ est uniquement affiché si la requête a été lancée et que l’exécution est terminée. |
Date de fin (champ DFIN) |
Ce champ définit la date d’exécution de la requête. Ce champ est uniquement affiché si la requête a été lancée et que l’exécution est terminée. |
Type tâche (champ TYPTAC) |
Les valeurs possibles de ce champ sont définies dans le menu local 20 - Type de tâches batch. Il indique si la tâche a été lancée en tant que ‘Script X3’ ou ‘Script Shell’ depuis le serveur batch. |
Script (champ ETAT) |
Ce champ indique le code du traitement ou du script, lorsque la tâche lancée ne correspond pas à une fonction de base. |
Serveur (champ SERVER) |
Ce champ affiche le numéro du serveur affecté à cette requête. |
Port (champ PORT) |
Ce champ affiche le numéro de port de la requête sur le serveur indiqué. |
Identifiant entité session (champ SESSIONID) |
Ce champ affiche le numéro unique attribué au serveur à cette tâche. |
No processus (champ PROCESS) |
Chaque requête est exécutée par un processus sur le serveur d'application. Ce champ identifie le numéro de processus (nommé en général process ID, ou PID) de la requête. |
Balise d'éxecution (champ RTTAG) |
Time-out (champ TIMOUT) |
Ce champ indique la durée de time-out (temps mort), c'est-à-dire la limite de temps au-delà de laquelle la tâche est automatiquement arrêtée. |
Groupe (champ GRP) |
Ce champ est alimenté si la tâche appartient à un groupe de tâches lancées. Ce code, si affiché, est commun à toutes les tâches du groupe. |
No d'ordre (champ NUMGRP) |
Ce champ est alimenté si la tâche appartient à un groupe de tâches lancées. Cette valeur, si affichée, est commune à toutes les tâches du groupe. |
Séquence (champ SEQGRP) |
Ce champ est alimenté si la tâche appartient à un groupe de tâches lancées. Ce numéro, si affiché, correspond au compteur de la tâche dans le groupe. |
Fréquence (mn) (champ FRQ) |
Lorsque la tâche batch est lancée en fréquence toutes les N minutes, cette colonne précise la valeur de N. |
Relance (champ IMPETX) |
Ce champ est alimenté si cette requête est exécutée de façon périodique (abonnement). A chaque fois que la requête est lancée, cette colonne est incrémentée de 1. La valeur affichée représente le nombre de fois où la tâche a été exécutée. |
Fichier batch (champ JOB) |
Ce champ est alimenté si la tâche a été lancée à partir d'un fichier job (se reporter à l’annexe technique correspondante). Il affiche le nom du fichier soumis, sans l’extension. |
Bloc numéro 2
champ PAGCUR |
Ce champ affiche le numéro de la page courante, ainsi que le nombre total de pages. |
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. |
Boutons spécifiques
Supprimer |
Cliquez sur l’action Supprimer pour supprimer la requête en sélectionnée. Cette action est uniquement disponible pour les requêtes en attente d’exécution. Utilisez l'action Arrêter si la requête est en cours. Utilisez l’action Epuration si la requête est terminée. |
Requête |
Cliquez sur l'action Requête pour soumettre une nouvelle requête. |
Actualiser |
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. |
Trace |
Cliquez sur l’action Trace afficher le fichier de trace générale du serveur (heure de démarrage, lancement des requêtes, fin de requêtes…). Le fichier trace s'appelle server.tra. Ce fichier se trouve dans le répertoire TRA du répertoire SERVX3, lui-même situé dans le répertoire Runtime. |
Epuration |
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. |
Information |
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.
Tables mises en œuvre
Reportez-vous à la documentation de Mise en oeuvre