Aller au contenu

TRCREX

Tracer REXX

Trace REXX

En bref

La commande Tracer REXX (TRCREX) permet d'activer ou de désactiver la fonction de l'interpréteur à partir de la ligne de commande ou au niveau de la programmation en langage de commande (CL). The Trace REXX (TRCREX) command is used to turn the interpreter function on or off from command entry or from control language (CL) programming level.

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

Syntaxe minimale

TRCREX

Paramètres

  • SET Option de trace

Astuce : dans une session 5250, tapez TRCREX 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 Tracer REXX (TRCREX) permet d'activer ou de désactiver la fonction de l'interpréteur à partir de la ligne de commande ou au niveau de la programmation en langage de commande (CL). The Trace REXX (TRCREX) command is used to turn the interpreter function on or off from command entry or from control language (CL) programming level.

Paramètres

Mot-clé Description Valeurs possibles Remarques
SET Option de trace *RESULTS, *ALL, *COMMANDS, *ERROR, *FAILURE, *INTERMEDIATES, *LABELS, *NORMAL, *OFF Facultatif, positionnel 1

Option de trace (SET)

Indique le paramètre de trace initial pour la prochaine procédure REXX exécutée. Ce paramètre reste en vigueur sauf s'il est modifié par l'instruction REXX TRACE. Specifies the initial trace setting for the next REXX procedure that is run. This setting remains in effect unless changed through the REXX TRACE instruction.

*RESULTS
Toutes les clauses sont tracées avant leur traitement. La trace fonctionne comme si l'instruction TRACE ?R était utilisée à l'intérieur de la procédure REXX. All clauses are traced before processing. Tracing operates as if the TRACE ?R instruction was used from within the REXX procedure.
*ALL
Toutes les clauses sont tracées avant leur traitement. La trace fonctionne comme si l'instruction TRACE ?A était utilisée à l'intérieur de la procédure REXX. All clauses are traced before processing. Tracing operates as if the TRACE ?A instruction was used from within the REXX procedure.
*COMMANDS
Toutes les commandes hôte sont tracées avant leur traitement et tout code retour d'erreur est affiché. La trace fonctionne comme si l'instruction TRACE ?C était utilisée à l'intérieur de la procédure REXX. All host commands are traced before processing and any error return code is displayed. Tracing operates as if the TRACE ?C instruction was used from within the REXX procedure.
*ERROR
Toute commande hôte donnant lieu à un code retour d'erreur est tracée après son traitement. La trace fonctionne comme si l'instruction TRACE ?E était utilisée à l'intérieur de la procédure REXX. Any host command resulting in an error return code is traced after processing. Tracing operates as if the TRACE ?E instruction was used from within the REXX procedure.
*FAILURE
Toute commande hôte en échec est tracée après son traitement avec le code retour de la commande. La trace fonctionne comme si l'instruction TRACE ?F était utilisée à l'intérieur de la procédure REXX. Any host command resulting in a failure is traced after processing together with the return code from the command. Tracing operates as if the TRACE ?F instruction was used from within the REXX procedure.
*INTERMEDIATES
Toutes les clauses sont tracées avant leur traitement. Les résultats intermédiaires lors de l'évaluation des expressions et les noms substitués sont également tracés. La trace fonctionne comme si l'instruction TRACE ?I était utilisée à l'intérieur de la procédure REXX. All clauses are traced before processing. Intermediate results during evaluation of expressions and substituted names are also traced. Tracing operates as if the TRACE ?I instruction was used from within the REXX procedure.
*LABELS
Les étiquettes rencontrées pendant le traitement sont tracées. La trace fonctionne comme si l'instruction TRACE ?L était utilisée à l'intérieur de la procédure REXX. Labels passed during processing are traced. Tracing operates as if the TRACE ?L instruction was used from within the REXX procedure.
*NORMAL
Toute commande hôte en échec est tracée après son traitement. La trace fonctionne comme si l'instruction TRACE ?N était utilisée à l'intérieur de la procédure REXX. Il s'agit de la valeur par défaut. Any failing host command is traced after processing. Tracing operates as if the TRACE ?N instruction was used from within the REXX procedure. This is the default setting.
*OFF
Rien n'est tracé. La trace fonctionne comme si l'instruction TRACE O était utilisée à l'intérieur de la procédure REXX. Nothing is traced. Tracing operates as if the TRACE O instruction was used from within the REXX procedure.

Exemples

Exemple 1 : Trace des commandes hôte Example 1: Tracing Host Commands

TRCREX   SET(*COMMANDS)

Cette commande provoque l'affichage de toutes les commandes de la procédure REXX avant leur exécution. This command causes all commands in by the REXX procedure to be shown before they are to be run.

Exemple 2 : Trace des commandes hôte en échec Example 2: Tracing Failing Host Commands

TRCREX   SET(*NORMAL)

Cette commande provoque l'affichage de toutes les commandes qui aboutissent à une condition FAILURE. Cette commande montre le paramètre normal de l'opération de trace REXX. This command causes all commands that result in a FAILURE condition to be shown. This command shows the normal setting for the REXX tracing operation.

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