ENDWCH

La commande Arrêter la surveillance (ENDWCH) arrête une session de surveillance démarrée par une commande STRWCH (Démarrer la surveillance) ou par l'API Start Watch (QSCSWCH). Les sessions de surveillance démarrées par des commandes de trace (STRTRC, TRCINT, TRCCNN, STRCMNTRC, TRCTCPAPP) seront arrêtées, mais la trace associée restera active. The End Watch (ENDWCH) command ends a watch session that was started by a STRWCH (Start Watch) command or by Start Watch (QSCSWCH) API. Watch sessions started by trace commands (STRTRC, TRCINT, TRCCNN, STRCMNTRC, TRCTCPAPP) will be ended but the associated trace will remain active.

Restrictions:

• Pour utiliser cette commande, vous devez posséder le droit spécial service (*SERVICE) ou être autorisé à la fonction de surveillance de service 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_WATCH, peut également être utilisée pour modifier la liste des utilisateurs autorisés à démarrer et à arrêter des opérations de surveillance. To use this command, you must have service (*SERVICE) special authority, or be authorized to the 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_WATCH, can also be used to change the list of users that are allowed to start and end watch operations.
• Pour arrêter une session de surveillance qui surveille un message dans un historique du travail, l'émetteur de la commande doit s'exécuter sous un profil utilisateur identique à l'identité utilisateur du travail surveillé, ou sous un profil utilisateur possédant le droit spécial contrôle des travaux (*JOBCTL). Le droit spécial contrôle des travaux (*JOBCTL) est également requis pour arrêter une session dans laquelle des travaux dont le nom d'utilisateur est générique sont surveillés. If ending a watch session that is watching for a message within a job log, the issuer of the command must be running under a user profile which is the same as the job user identity of the job being watched, or the issuer of the command must be running under a user profile which has job control (*JOBCTL) special authority. Job control (*JOBCTL) special authority is also required when ending a session where jobs with a generic user name are being watched.
• Pour arrêter une session de surveillance démarrée en indiquant *ALL pour le nom de travail surveillé, ou un nom d'utilisateur générique, vous devez posséder le droit spécial *ALLOBJ ou être autorisé à la fonction de surveillance de n'importe quel travail 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_WATCH_ANY_JOB, peut également être utilisée pour modifier la liste des utilisateurs autorisés à démarrer et à arrêter des opérations de surveillance. If ending a watch session that was started specifying *ALL for the watch job name, or a generic user name, you must have *ALLOBJ special authority, or be authorized to the Watch any job function of IBM i through System i Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_WATCH_ANY_JOB, can also be used to change the list of users that are allowed to start and end watch operations.

Paramètres

ID de session (SSNID)Session ID (SSNID)

Indique un identificateur de session pour la surveillance à arrêter. Ce nom doit correspondre à l'identificateur de session d'une session de surveillance précédemment démarrée et toujours active. Specifies a session identifier for the watch to be ended. This name must match the session identifier of a watch session that had been previously started and is still active.

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

*PRV

La session de surveillance la plus récemment démarrée par le même utilisateur que celui qui exécute cette commande ENDWCH sera arrêtée. Par exemple, si le travail qui exécute la commande ENDWCH s'exécute sous le profil utilisateur BOB, la dernière session de surveillance démarrée sous le profil utilisateur BOB est arrêtée. The watch session most recently started by the same user who is running this ENDWCH command will be ended. For example, if the job running the ENDWCH command is running under user profile BOB, the last watch session started under user profile BOB is ended.

*ALL

Toutes les sessions de surveillance actives doivent être arrêtées. All active watch sessions are to be ended.

nom-générique

Indiquez la ou les sessions de surveillance génériques à arrêter. Un nom générique est une chaîne d'un ou plusieurs caractères suivis d'un astérisque (*) ; par exemple, ABC*. L'astérisque remplace tous les caractères valides. Un nom générique désigne toutes les sessions dont les identificateurs commencent par le préfixe générique. Specify the generic watch session(s) to be ended. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all sessions with identifiers that begin with the generic prefix.

nom

Indiquez l'identificateur de session de la surveillance à arrêter. Specify the session identifier of the watch to be ended.

Exemples

Exemple 1 : Arrêt de la surveillance démarrée le plus récemment Example 1: End Most Recently Started Watch

ENDWCH   SSNID(*PRV)

Cette commande arrête la session de surveillance démarrée le plus récemment par le même utilisateur que celui qui exécute la commande ENDWCH. This command ends the watch session started most recently by the same user who is running the ENDWCH command.

Exemple 2 : Arrêt d'une session de surveillance précise Example 2: End a Specific Watch Session

ENDWCH   SSNID(MYSESSION)

Cette commande arrête la session de surveillance MYSESSION. This command ends the watch session MYSESSION.

Exemple 3 : Arrêt d'une session de surveillance générique Example 3: End a Generic Watch Session

ENDWCH   SSNID(SSN0*)

Cette commande arrête toutes les sessions de surveillance actives dont l'identificateur commence par le préfixe SSN0. This command ends all active watch sessions whose identifier starts with the prefix SSN0.

Exemple 4 : Arrêt de toutes les sessions de surveillance Example 4: End All Watch Sessions

ENDWCH   SSNID(*ALL)

Cette commande arrête toutes les sessions de surveillance actives sur le système. This command ends all the watch sessions active on the system.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF39E1

Session de surveillance &1 introuvable. Watch session &1 not found.

CPF39E2

Il n'existe aucune session de surveillance active pour le profil utilisateur en cours. There is no active watch session for current user profile.

CPF39E6

L'utilisateur ne possède pas le droit requis. The user does not have the required authority.

CPF39E8

Droits insuffisants pour surveiller les opérations. Not enough authority to watch operations.

CPF39E9

Le droit spécial *JOBCTL est obligatoire. *JOBCTL special authority required.

CPF39EE

&1 sessions de surveillance arrêtées. &2 non arrêtées. &1 watch sessions ended. &2 not ended.

CPF39EF

Aucune session de surveillance ne correspond aux critères &1. No watch sessions matching the &1 criteria.

CPF9899

Erreur lors du traitement de la commande.