Aller au contenu

DSPTRC

Afficher une trace

En bref

la commande DSPTRC (Afficher l'environnement de trace) permet de d'afficher toutes les informations relatives aux traces définies pour les programmes indiqués dans cette commande, à savoir :

DSPTRC se lit DSP (Afficher) + TRC. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

DSPTRC

Paramètres

Astuce : dans une session 5250, tapez DSPTRC puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

la commande DSPTRC (Afficher l'environnement de trace) permet de d'afficher toutes les informations relatives aux traces définies pour les programmes indiqués dans cette commande, à savoir :

  • les plages d'instructions programme ou machine au sein du programme indiqué,
  • le nom ou les numéros MI ODV de toutes les variables de programme associées aux instructions de trace,
  • les conditions d'enregistrement des variables (chaque fois que l'instruction à tracer est traitée ou uniquement lorsque la valeur de ces variables change).

Restriction : Cette commande ne peut être utilisée qu'en mode débogage.

Paramètres

Mot-clé Description Valeurs possibles Remarques
OUTPUT Sortie *, *PRINT Facultatif, positionnel 1
PGM Programme Valeurs uniques: *DFTPGM, *ALL
Autres valeurs (jusqu'à 20 répétitions): Nom
Facultatif

Sortie (OUTPUT)

Indique si la sortie générée par la commande doit être affichée sur le poste de travail demandeur, ou imprimée avec la sortie spoule du travail.

*
La sortie est affichée dans le cas d'un travail interactif ou imprimée avec la sortie spoule du travail dans le cas d'un travail par lots.
*PRINT
Le résultat est placé dans un fichier spoule de la file d'attente en sortie du travail.

Programme (PGM)

Désigne les programmes en mode débogage dont les instructions à tracer et les variables de programme associées doivent être affichées.

*DFTPGM
Affiche uniquement les instructions à tracer du programme par défaut.
*ALL
Affiche toutes les instructions à tracer de tous les programmes actuellement en mode débogage.
nom
Indiquez les noms des programmes (20 au maximum) dont les instructions à tracer doivent être affichées. Ces programmes doivent déjà être en mode débogage.

Exemples

DSPTRC

Cette commande permet d'afficher toutes les plages d'instructions de données de trace actuellement définies dans le programme par défaut de cette session de débogage. S'affichent également les variables de programme (excepté leurs valeurs) associées aux instructions de données de trace.

Messages d'erreur

Messages *ESCAPE

CPF1999
Erreurs dans la commande.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.