WRKWCH

Gérer surveillances

Work with Watches

En bref

La commande Gérer les surveillances (WRKWCH) permet d'afficher un écran contenant la liste des surveillances actives sur le système. The Work with Watches (WRKWCH) command can be used to show a panel with the list of active watches around the system.

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

Syntaxe minimale

WRKWCH WCH(…)

Paramètres

WCH Surveillance Watch obligatoire

Astuce : dans une session 5250, tapez WRKWCH 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 surveillances (WRKWCH) permet d'afficher un écran contenant la liste des surveillances actives sur le système. Une surveillance active peut être une surveillance démarrée par les commandes Trace interne (TRCINT), Démarrer la trace (STRTRC), Tracer une connexion (TRCCNN), Tracer une application TCP/IP (TRCTCPAPP) et Démarrer la trace des communications (STRCMNTRC) avec des paramètres de surveillance, ou une session démarrée à l'aide de la commande Démarrer la surveillance (STRWCH) ou de l'API Démarrer la surveillance (QSCSWCH). The Work with Watches (WRKWCH) command can be used to show a panel with the list of active watches around the system. An active watch can be a watch started issuing Trace Internal (TRCINT), Start Trace (STRTRC), Trace Connection (TRCCNN), Trace TCP/IP Application (TRCTCPAPP), and Start Communications Trace (STRCMNTRC) commands specifying watches parameters, or a session started using Start Watch (STRWCH) command, or using Start Watch (QSCSWCH) API.

Lorsque vous exécutez cette commande, l'écran Gérer les surveillances s'affiche. À partir de cet écran, vous pouvez arrêter une surveillance active ou en démarrer une nouvelle. Les surveillances en cours d'arrêt sont également affichées. When you run this command, the Work with Watches panel is shown. From this display you can end an active watch or start a new one. Also the watches being ended are shown.

La vue QSYS2.WATCH_INFO et la fonction de table QSYS2.WATCH_DETAIL renvoient des informations similaires. The QSYS2.WATCH_INFO view and QSYS2.WATCH_DETAIL table function return similar information.

Restrictions:

Pour utiliser cette commande, vous devez posséder le droit spécial de service (*SERVICE) ou être autorisé à la fonction Service trace et à la fonction Service watch 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 les ID de fonction QIBM_SERVICE_TRACE et QIBM_SERVICE_WATCH, 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 and Service watch function of IBM i through System i Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_TRACE and QIBM_SERVICE_WATCH, 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
WCH	SurveillanceWatch	Valeurs uniques: ALL Autres valeurs (jusqu'à 3 répétitions): SRVMON, STRWCH, TRCCMD	Obligatoire, positionnel 1

Surveillance (WCH)Watch (WCH)

Indique les surveillances à afficher sur l'écran Gérer les surveillances. Specifies the watches to be shown on the Work with Watches panel.

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

Valeurs uniques

*ALL: Toutes les surveillances actives sont affichées sur l'écran Gérer les surveillances. All active watches are shown in the Work with Watches panel.

Autres valeurs

*SRVMON: Les surveillances actives démarrées à l'aide de la fonction Service Monitor du système d'exploitation sont affichées. Active watches started using the Service Monitor function of the operating system are shown.
*STRWCH: Les surveillances actives démarrées à l'aide de la commande Démarrer la surveillance (STRWCH) ou de l'API Démarrer la surveillance (QSCSWCH) sont affichées. Active watches started using the Start Watch (STRWCH) command or the Start Watch (QSCSWCH) API are shown.
*TRCCMD: Les surveillances actives démarrées à l'aide des commandes Démarrer la trace des communications (STRCMNTRC), Démarrer la trace (STRTRC), Trace interne (TRCINT), Tracer une connexion (TRCCNN) et Tracer une application TCP/IP (TRTCPAPP) sont affichées. Active watches started using Start Communications Trace (STRCMNTRC), Start Trace (STRTRC), Trace Internal (TRCINT), Trace Connection (TRCCNN) and Trace TCP/IP Application (TRTCPAPP) commands are shown.

Exemples

WRKWCH   WCH(*TRCCMD)

Cette commande affiche l'écran Gérer les surveillances, avec toutes les sessions de surveillance démarrées via les paramètres de surveillance indiqués dans les commandes Trace interne (TRCINT), Tracer une connexion (TRCCNN), Démarrer la trace des communications (STRCMNTRC), Tracer une application TCP/IP (TRCTCPAPP) et Démarrer la trace (STRTRC). This command displays the Work with Watches panel, showing all watch sessions started via watches parameters specified in Trace Internal (TRCINT), Trace Connection (TRCCNN), Start Communications Trace (STRCMNTRC), Trace TCP/IP Application (TRCTCPAPP) and Start Trace (STRTRC) commands.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF39E6: L'utilisateur ne possède pas le droit requis. The user does not have the required authority.
CPF98A2: Vous n'avez pas les droits sur la commande ou l'API &1. Not authorized to &1 command or API.