CHKCMNTRC

Vérifier trace communications

Check Communications Trace

En bref

La commande Vérifier la trace des communications (CHKCMNTRC) renvoie l'état de la trace des communications pour une ligne donnée, une description d'interface réseau, une description de serveur réseau, ou pour toutes les traces d'un type donné présentes sur le système. The Check Communications Trace (CHKCMNTRC) command returns the communications trace status for a specific line, a network interface description, a network server description, or for all of the traces of a specific type that exist on the system.

CHKCMNTRC se lit CHK (Vérifier) + CMNTRC. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CHKCMNTRC CFGOBJ(…) CFGTYPE(…)

Paramètres

CFGOBJ Objet de configuration obligatoire
CFGTYPE Type obligatoire

Astuce : dans une session 5250, tapez CHKCMNTRC 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 Vérifier la trace des communications (CHKCMNTRC) renvoie l'état de la trace des communications pour une ligne donnée, une description d'interface réseau, une description de serveur réseau, ou pour toutes les traces d'un type donné présentes sur le système. L'état est renvoyé par un message. The Check Communications Trace (CHKCMNTRC) command returns the communications trace status for a specific line, a network interface description, a network server description, or for all of the traces of a specific type that exist on the system. The status is returned through a message.

Restrictions:

Cette commande est livrée avec le droit public d'exclusion (*EXCLUDE), et le profil utilisateur QSRV est livré avec un droit privé d'utilisation de cette commande. This command is shipped with exclude (*EXCLUDE) public authority and the QSRV user profile is shipped with private authority to use this command.
Pour utiliser cette commande, vous devez posséder le droit spécial de service (*SERVICE), ou être autorisé à la fonction de trace 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_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 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
CFGOBJ	Objet de configuration	Nom, *ALL	Obligatoire, positionnel 1
CFGTYPE	Type	LIN, NWI, *NWS	Obligatoire, positionnel 2

Objet de configuration (CFGOBJ)

Indique le nom de la description de configuration à vérifier. La description de configuration est soit une description de ligne, soit une description d'interface réseau. Specifies the name of the configuration description to check. The configuration description is either a line description or a network interface description.

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

*ALL: L'état de la trace des communications est renvoyé pour toutes les traces d'un type donné. The communications trace status is returned for all of the traces of a specific type.
nom: Indiquez le nom de la description de configuration à vérifier. Specify the name of the configuration description to be checked.

Type (CFGTYPE)

Indique le type d'objet de la description de configuration à vérifier. Specifies the object type of the configuration description to check.

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

*LIN: L'état des lignes est affiché. Status for lines is shown.
*NWI: L'état des interfaces réseau est affiché. Status for network interfaces is shown.
*NWS: L'état des serveurs réseau est affiché. Status for network servers is shown.

Exemples

Exemple 1 : Vérification de toutes les traces Example 1: Checking All Traces

CHKCMNTRC   CFGOBJ(*ALL)  CFGTYPE(*NWI)

Cette commande affiche l'état de la trace des communications de toutes les traces d'interface réseau. This command shows the communications trace status of all network interface traces.

Exemple 2 : Vérification d'une trace individuelle Example 2: Checking An Individual Trace

CHKCMNTRC   CFGOBJ(QESLINE)  CFGTYPE(*LIN)

Cette commande affiche l'état de la trace des communications de la ligne QESLINE. This command shows the communications trace status of line QESLINE.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF39A7: Mémoire de trace non disponible dans le processeur de communications Trace storage not available in communications processor
CPF39A8: Non autorisé à utiliser l'outil de service de trace des communications Not authorized to communications trace service tool
CPF39A9: Une erreur s'est produite pendant la fonction de trace des communications Error occurred during communications trace function
CPF39BE: Il n'existe aucune trace des communications de type &1 No communications traces of type &1 exist
CPF39B0: Il n'existe aucune trace des communications. No communications traces exist.
CPF39B1: La trace &1 de type &2 n'existe pas Trace &1 type &2 does not exist
CPF39B6: La fonction de trace des communications ne peut pas être exécutée Communications trace function cannot be performed
CPF98A2: Vous n'avez pas les droits sur la commande ou l'API &1. Not authorized to &1 command or API.