RMVTRC

Enlever une trace au débogage

En bref

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

Syntaxe minimale

RMVTRC

Paramètres

STMT Instructions trace à enlever
PGM Programme

Astuce : dans une session 5250, tapez RMVTRC 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 RMVTRC (Enlever une trace au débogage) permet de supprimer la totalité ou une partie des traces précédemment définies dans une ou plusieurs commandes ADDTRC (Ajouter une trace au débogage) pour le débogage des programmes. Cette commande ne s'applique pas aux données déjà créées par les traces à annuler. Pour supprimer ces données, vous devez utiliser la commande CLRTRCDTA (Mettre à blanc les résultats de trace). Les limites de trace définies par la commande CHGDBG (Modifier le débogage) ou STRDBG (Démarrer le débogage) ne sont pas modifiées.

Dans la commande RMVTRC (Enlever une trace du débogage), l'utilisateur indique les numéros d'instructions HLL ou les numéros d'instructions machine correspondant aux plages dont il veut annuler la trace. Pour annuler une trace, vous devez indiquer la même plage que dans la commande ADDTRC (Ajouter une trace au débogage). 5 plages de trace au maximum peuvent être définies dans une commande.

Restrictions :

Vous pouvez utiliser cette commande uniquement en mode débogage. Pour démarrer le mode débogage, utilisez la commande STRDBG.
Vous ne pouvez pas utiliser cette commande si vous faites la maintenance d'un autre travail et si celui-ci est dans une file d'attente de travaux, ou bien s'il est suspendu, interrompu ou arrêté.

Vous ne pouvez pas utiliser cette commande pour retirer une trace d'un programme lié.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
STMT	Instructions trace à enlever	Valeurs uniques: ALL Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments*	Facultatif, positionnel 1
	Élément 1: Numéro d'instruction de début	Valeur caractère
	Élément 2: Numéro d'instruction de fin	Valeur caractère
PGM	Programme	Nom, DFTPGM, ALL	Facultatif, positionnel 2

Instructions trace à enlever (STMT)

Indique les numéros d'instructions, ou les numéros d'instructions machine correspondantes, qui ne doivent plus faire l'objet d'une trace. Pour annuler une trace dans un programme, vous devez indiquer les mêmes numéros d'instructions que dans la commande ADDTRC (Ajouter une trace au débogage), sauf si *ALL a été spécifié.

La méthode de définition des instructions de trace dans la commande ADDTRC (c'est-à-dire les identificateurs d'instruction HLL par rapport aux numéros d'instruction machine) doit également être utilisée à ce stade pour supprimer les instructions.

*ALL: La trace de toutes les instructions HLL (langage évolué) et instructions machine est annulée dans les programmes indiqués, quelle que soit la définition de cette trace dans la commande ADDTRC (Ajouter une trace au débogage).
numéro-instruction-début numéro-instruction-fin: Entrez le numéro d'instruction HLL (ou le numéro d'instruction machine) de la première instruction tracée à supprimer et, le cas échéant, celui de la dernière instruction à supprimer lors des traces ultérieures. Cependant, si la dernière instruction a été définie dans la commande ADDTRC (Ajouter une trace au débogage), elle doit également être spécifiée ici. 5 plages de trace au maximum peuvent être définies dans le programme en vue de l'exécution de cette commande.
La méthode utilisée pour définir les instructions tracées dans la commande ADDTRC (Ajouter une trace au débogage) (c'est-à-dire, numéros d'instructions HLL ou d'instructions machine) doit être conservée pour la suppression de ces mêmes instructions.

Programme (PGM)

Indique le programme (ou tous les programmes) contenant les instructions tracées à supprimer lors des opérations de trace ultérieures.

*DFTPGM: Le programme précédemment défini comme programme par défaut contient les instructions ne devant plus faire l'objet d'une trace.
*ALL: Supprime toutes les plages de trace des différents programmes. Par conséquent, aucune opération de trace ne peut avoir lieu dans les programmes en mode débogage, sauf si de nouvelles traces sont définies au moyen de la commande ADDTRC (Ajouter une trace au débogage). *ALL est incompatible avec toute valeur entrée au paramètre Instructions trace à enlever (STMT).
nom: Entrez le nom du programme dont une partie ou la totalité des instructions tracées doivent être supprimées.

Exemples

RMVTRC

Cette commande permet de supprimer toutes les instructions de trace utilisées pour tracer le programme actuellement défini en tant que programme par défaut.

Messages d'erreur

Messages *ESCAPE

CPF1999: Erreurs dans la commande.