WRKTRC

Gérer traces

Work with Traces

En bref

La commande Gérer les traces (WRKTRC) permet d'afficher un écran contenant la liste des traces de communications, traces de travaux, traces du code interne sous licence (LIC) et traces Performance Explorer (PEX) existantes sur le système. The Work with Traces (WRKTRC) command can be used to show a panel with the list of existing communications traces, job traces, licensed internal code (LIC) traces and performance explorer (PEX) traces around the system.

WRKTRC se lit WRK (Gérer) + TRC. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

WRKTRC TRC(…)

Paramètres

TRC Trace obligatoire

Astuce : dans une session 5250, tapez WRKTRC 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 Gérer les traces (WRKTRC) permet d'afficher un écran contenant la liste des traces de communications, traces de travaux, traces du code interne sous licence (LIC) et traces Performance Explorer (PEX) existantes sur le système. Vous pouvez gérer les traces existantes ou démarrer une nouvelle trace. Lorsque vous exécutez cette commande, l'écran Gérer les traces s'affiche. The Work with Traces (WRKTRC) command can be used to show a panel with the list of existing communications traces, job traces, licensed internal code (LIC) traces and performance explorer (PEX) traces around the system. You can work with the existing traces or start a new trace. When you run this command, the Work with Traces panel is shown.

Restrictions:

Pour utiliser cette commande, vous devez posséder le droit spécial de service (*SERVICE) ou être autorisé à la fonction Service trace d'IBM i via la prise en charge de l'administration des applications de System i Navigator. La commande Modifier l'utilisation d'une fonction (CHGFCNUSG), avec l'ID de fonction QIBM_SERVICE_TRACE, peut également servir à modifier la liste des utilisateurs autorisés à effectuer des opérations de trace. To use this command, you must have service (*SERVICE) special authority, or be authorized to the Service trace function of the IBM i through System i Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_TRACE, can also be used to change the list of users that are allowed to perform trace operations.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
TRC	Trace	Valeurs uniques: ALL Autres valeurs (jusqu'à 4 répétitions): CMN, JOB, LIC, *PEX	Obligatoire, positionnel 1

Trace (TRC)

Indique le type de traces à afficher sur l'écran Gérer les traces. Specifies the type of traces to be shown on the Work with Traces panel.

Ce paramètre est obligatoire. This is a required parameter.

Valeurs uniques

*ALL: Toutes les traces de communications, traces de travaux, traces du code interne sous licence (LIC) et traces Performance Explorer (PEX) sont listées sur l'écran Gérer les traces. All communications traces, job traces, licensed internal code (LIC) traces and performance explorer (PEX) traces are listed in the Work with Traces panel.

Autres valeurs

*CMN: Toutes les traces de communications sont affichées sur l'écran Gérer les traces. All communications traces are shown in the Work with Traces panel.
*JOB: Tous les identificateurs de session de trace de travaux sont affichés sur l'écran Gérer les traces. Cela comprend les sessions de trace démarrées par la commande Démarrer la trace (STRTRC) et par la commande Tracer une application TCP/IP (TRCTCPAPP) avec le paramètre Traces supplémentaires (ADLTRC). All job trace session identifiers are shown in the Work with Traces panel. This includes trace sessions started by the Start Trace (STRTRC) command and the Trace TCP/IP Application (TRCTCPAPP) command specifying the Additional traces (ADLTRC) parameter.
*LIC: Toutes les traces LIC sont affichées sur l'écran Gérer les traces. Cela comprend les traces démarrées par la commande Trace interne (TRCINT), la commande Tracer une connexion (TRCCNN), la commande Tracer une application TCP/IP (TRCTCPAPP) avec le paramètre Traces supplémentaires (ADLTRC), la commande Démarrer les outils de service système (STRSST) ou la commande Démarrer DST (STRDST). All LIC traces are shown in the Work with Traces panel. This includes traces started by the Trace Internal (TRCINT) command, the Trace Connection (TRCCNN) command, the Trace TCP/IP Application (TRCTCPAPP) command specifying the Additional traces (ADLTRC) parameter, the Start System Service Tools (STRSST) command, or the Start DST (STRDST) command.
*PEX: Toutes les traces PEX sont affichées sur l'écran Gérer les traces. All PEX traces are shown in the Work with Traces panel.

Exemples

WRKTRC   TRC(*LIC)

Cette commande affiche l'écran Gérer les traces, avec toutes les traces démarrées par la commande Trace interne (TRCINT), la commande Tracer une connexion (TRCCNN), la commande Tracer une application TCP/IP (TRCTCPAPP) avec le paramètre Traces supplémentaires (ADLTRC), la commande Démarrer les outils de service système (STRSST) et la commande Démarrer DST (STRDST). This command displays the Work with Traces panel, showing all traces started issuing the Trace Internal (TRCINT) command, the Trace Connection (TRCCNN) command, the Trace TCP/IP Application (TRCTCPAPP) command specifying the Additional traces (ADLTRC) parameter, the Start System Service Tools (STRSST) command, and Start DST (STRDST) command.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF98A2: Vous n'avez pas les droits sur la commande ou l'API &1. Not authorized to &1 command or API.