Lecture traces
Les fonctions du progiciel susceptibles de durer un certain temps, et en particulier toutes celles qui sont susceptibles de fonctionner en batch, créent un fichier trace avec un compte-rendu détaillé incluant les erreurs s'il y en a.
Ces fichiers de trace sont créés dans le sous-répertoire TRA du répertoire du dossier, sur le serveur. Ils ont un nom composé sous la forme F#.tra, où # est un numéro séquentiel attribué à l'aide du compteur [C]NUMIMP.
La première ligne d'un fichier trace est structurée comme suit :
|
#<AdxVJ>@(#)%I% JJ-MM-AA hh:mm:ss (code utilisateur) Commentaire explicatif |
La première partie de la trace (présentée en gras) est un en-tête standard ; suivent ensuite la date et l'heure, le code de l'utilisateur ayant lancé la, fonction, et enfin un commentaire explicatif.
On trouve ensuite dans la trace des lignes créées par la fonction exécutée ; ces lignes sont préfixées par les caractères > ou <, suivies d'un numéro d'erreur, si la ligne fait référence à une erreur constatée dans la fonction.
Pré-requis
Reportez-vous à la documentation de Mise en oeuvre
Gestion de l'écran
Lorsqu'on entre dans la fonction, on saisit le nom du fichier de trace ; une fenêtre de sélection est accessible pour sélectionner les fichiers existants.
Ce choix fait, l'écran de lecture de trace s'ouvre.
Ecran de saisie
Cet écran permet d'afficher jusqu'à 1000 lignes de trace. S'il y en a davantage dans le fichier, les boutons magnétophone sont dégrisés, le fichier étant découpé en « pages » logiques de 1000 lignes. Il est alors possible d'utiliser les boutons magnétophone pour aller à la page suivante, ou précédente, ou d'aller en première ou en dernière page. Le numéro de page courante et le nombre total de pages du fichier sont affichés dans le titre du tableau des lignes.
Boutons spécifiques
Mise en oeuvre technique des traces
Le développeur gère un fichier de trace par les fonctions suivantes :
|
Call OUVRE_TRACE("COMMENTAIRE") From LECFIC |
: # Ouverture d'un fichier trace |
|
Call ECR_TRACE("TEXTE",ERREUR) From GESECRAN |
: # Ecriture d'un texte dans la trace |
|
Call FERME_TRACE From LECFIC |
: # Fermeture de la trace |
|
Call LEC_TRACE From LECFIC |
: # Lecture de la trace |