Exploitation > Serveur batch > 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

    SEEREFERTTO 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.

     

    Champs

    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.

    Ce champ indique le dossier depuis lequel l’exécution de la requête a été demandée.

    Ce code identifie la tâche lancée.

    Ce champ définit la langue dans laquelle une tâche est exprimée.

    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 :

    • Attente. La requête n’a encore démarré.
    • En cours. La requête est en cours d’exécution.
    • Terminée. La requête s'est terminée sans erreurs.
    • Bloquée. La requête fait partie d'un groupe en cours d'exécution, ou elle est bloquée manuellement par une interruption.
    • A tuer. Un utilisateur a demandé l'arrêt de la requête.
    • Annulée. La requête a été interrompue.
    • Erreur. La requête s'est terminée sur une erreur.
    • Hors délai. La requête a dépassé le délai. Elle est immédiatement soumise au traitement, en utilisant un fichier comme intermédiaire.
    • Avertissement. La tâche s'est terminée sur un code erreur non bloquant (variable GERRBATCH<100)

    • 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.

    • 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.

    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.

     

    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.

     

     

    Boutons spécifiques

    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.

    Les champs suivants sont présents dans la fenêtre ouverte par ce bouton :

    Bloc numéro 1

    Utilisez ce champ pour définir le code du dossier depuis lequel cette requête de soumission doit être lancée.

    Utilisez ce champ pour définir le code de l’utilisateur qui a soumis cette requête. Ce champ est obligatoire.

    • Mot de passe (champ PASSE)

    Utilisez ce champ pour saisir le mot de passe de l’utilisateur qui a soumis cette requête.

    Bloc numéro 2

    Définit un groupe de tâches à lancer.

    Définit le code de la tâche qui sera lancée automatiquement par le serveur batch.

    Utilisez ce champ pour définir le code de la langue lancée automatiquement par le serveur batch.

    • Date (champ DAT)

    Ce champ identifie 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.

    • Modèle (champ JOBMOD)

    Si cette case est activée, un fichier contenant les paramètres saisis pour la requête sera généré dans le répertoire des fichiers modèles (paramètres serveur batch) et la requête ne sera pas soumise au serveur. Le nom du fichier se compose du code de la tâche et du suffixe ‘.mod’. Le fichier peut ainsi être utilisé comme modèle pour créer les fichiers .job permettant la création des requêtes batch.

    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 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.

    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.

    Tables mises en œuvre

    SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre