STRCMNTRC

Démarrer trace communications

Start Communications Trace

En bref

La commande Démarrer la trace de communications (STRCMNTRC) lance une trace de communications pour une ligne, une interface réseau ou une description de serveur de réseau donnée. The Start Communications Trace (STRCMNTRC) command initiates a communications trace for a specified line, a network interface or a network server description.

STRCMNTRC se lit STR (Démarrer) + CMNTRC. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

STRCMNTRC CFGOBJ(…) CFGTYPE(…)

Paramètres

CFGOBJ Objet de configuration obligatoire
CFGTYPE Type obligatoire
MAXSTG Taille du tampon Buffer size
DTADIR Sens des données Data direction
TRCFULL Trace pleine
USRDTA Nombre d'octets utilisateur à tracer Number of user bytes to trace
CMNTRCOPTS Options de trace de communications Communications trace options
DDITRCOPTS Options de trace DDI DDI trace options
RMTCTL Contrôleur distant Remote controller
RMTMAC Adresse MAC distante Remote MAC address
RMTSAP SAP distant Remote SAP
LCLSAP SAP local Local SAP
IPPCLNUM Numéro de protocole IP IP protocol number
RMTIPADR Adresse IP distante Remote IP address
VRTLANID Identificateur de réseau local virtuel Virtual LAN identifier
LMITRCOPTS Options de trace LMI LMI trace options
NWSTRCOPTS Options de trace NWS NWS trace options
WCHMSG Surveiller un message Watch for message
WCHMSGQ File d'attente de messages surveillée Watched message queue
WCHJOB Travail surveillé Watched job
WCHLICLOG Surveiller une entrée du journal LIC Watch for LIC log entry
WCHPAL Surveiller une entrée PAL Watch for PAL entry
WCHTIMO Durée de la surveillance Length of time to watch
TRCPGM Programme de trace Trace program
TRCPGMITV Intervalle
RUNPTY Priorité d'exécution
TEXT Description de la trace Trace description

Astuce : dans une session 5250, tapez STRCMNTRC 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

Une trace de communications se poursuit jusqu'à ce que : A communications trace continues until:

La commande Arrêter la trace de communications (ENDCMNTRC) soit exécutée. The End Communications Trace (ENDCMNTRC) command is run.
La fonction Trace de communications de la commande Démarrer les outils de maintenance système (STRSST) soit utilisée pour arrêter la trace. The Communications Trace function of the Start System Service Tools (STRSST) command is used to end the trace.
Un incident de ligne physique mette fin à la trace. A physical line problem causes the trace to end.
TRCFULL(*STOPTRC) soit indiqué et que le tampon soit plein. TRCFULL(*STOPTRC) is specified and the buffer becomes full.
Automatiquement, par la fonction de surveillance d'événement de trace. Automatically by the watch for trace event functionality.

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.
L'utilisateur doit posséder le droit *USE sur la ligne, l'interface réseau ou le serveur de réseau à tracer. The user must have *USE authority to the line, network interface, or network server to be traced.
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.
Lorsque le paramètre Travail surveillé (WCHJOB) est indiqué, 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 si un nom d'utilisateur générique est indiqué pour le paramètre WCHJOB. When the Watched job (WCHJOB) parameter is specified, 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 if a generic user name is specified for the WCHJOB parameter.
Si vous indiquez un nom d'utilisateur générique dans le paramètre WCHJOB, vous devez posséder le droit spécial tous les objets (*ALLOBJ) ou être autorisé à la fonction Watch any job 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, permet également de modifier la liste des utilisateurs autorisés à démarrer et à arrêter des opérations de surveillance. If you specify a generic user name in the WCHJOB parameter, you must have all object (*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.
Vous devez posséder les droits d'exploitation (*OBJOPR) et d'exécution (*EXECUTE) sur le programme d'exit utilisateur s'il est indiqué dans le paramètre Programme de trace (TRCPGM), ainsi que le droit d'exécution (*EXECUTE) sur la bibliothèque dans laquelle se trouve le programme. You must have operational (*OBJOPR) and execute (*EXECUTE) authorities to the user exit program if specified in Trace program (TRCPGM) parameter, and execute (*EXECUTE) authority to the library where the program is located.
Vous devez posséder le droit d'utilisation (*USE) sur les files d'attente de messages indiquées dans le paramètre File d'attente de messages surveillée (WCHMSGQ), ainsi que le droit d'utilisation (*USE) sur la bibliothèque dans laquelle se trouve la file d'attente de messages. You must have use (*USE) authority to the message queues specified in Watched message queue (WCHMSGQ) parameter, and use (*USE) authority to the library where the message queue is located.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
CFGOBJ	Objet de configuration	Nom	Obligatoire, positionnel 1
CFGTYPE	Type	LIN, NWI, *NWS	Obligatoire, positionnel 2
MAXSTG	Taille du tamponBuffer size	Entier, MIN, MAX, 128K, 256K, 2M, 4M, 6M, 8M, 16M, 32M, 64M, 128M, 256M, 512M, 1G, 2G, 4G	Facultatif
DTADIR	Sens des donnéesData direction	SND, RCV, *BOTH	Facultatif
TRCFULL	Trace pleine	WRAP, STOPTRC	Facultatif
USRDTA	Nombre d'octets utilisateur à tracerNumber of user bytes to trace	Valeurs uniques: CALC, MAX Autres valeurs: Liste d'éléments	Facultatif
	Élément 1: Beginning bytes	Nombre décimal
	Élément 2: Ending bytes	Nombre décimal, *CALC
CMNTRCOPTS	Options de trace de communicationsCommunications trace options	ALLDTA, RMTCTL, RMTMAC, RMTSAP, LCLSAP, IPPCLNUM, RMTIPADR, VRTLANID	Facultatif
DDITRCOPTS	Options de trace DDIDDI trace options	ALLDTA, RMTCTL, RMTMAC, RMTSAP, LCLSAP, IPPCLNUM, *RMTIPADR	Facultatif
RMTCTL	Contrôleur distantRemote controller	Nom	Facultatif
RMTMAC	Adresse MAC distanteRemote MAC address	Valeur hexadécimale	Facultatif
RMTSAP	SAP distantRemote SAP	Valeur hexadécimale	Facultatif
LCLSAP	SAP localLocal SAP	Valeur hexadécimale	Facultatif
IPPCLNUM	Numéro de protocole IPIP protocol number	0-255, ICMP, IGMP, TCP, EGP, IGP, UDP, *ICMPV6	Facultatif
RMTIPADR	Adresse IP distanteRemote IP address	Valeur caractère	Facultatif
VRTLANID	Identificateur de réseau local virtuelVirtual LAN identifier	1-4094, *NONE	Facultatif
LMITRCOPTS	Options de trace LMILMI trace options	ALLDTA, NOLMI, *LMIONLY	Facultatif
NWSTRCOPTS	Options de trace NWSNWS trace options	NETBIOS, INTERNAL, *TCPIP	Facultatif
WCHMSG	Surveiller un messageWatch for message	Valeurs uniques: NONE Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Message to watch	Nom générique, nom, ALL, IMMED
	Élément 2: Donnée de comparaison	Valeur caractère, *NONE
	Élément 3: Compare against	MSGDTA, FROMPGM, *TOPGM
	Élément 4: Type de message	ALL, COMP, DIAG, ESCAPE, INFO, INQ, NOTIFY, SCOPE, *STATUS
	Élément 5: Opérateur relationnel	GE, EQ, GT, LT, *LE
	Élément 6: Code gravité	0-99, 00
WCHMSGQ	File d'attente de messages surveilléeWatched message queue	Values (jusqu'à 3 répétitions): Liste d'éléments	Facultatif
	Élément 1: File attente messages	Valeurs uniques: SYSOPR, JOBLOG, HSTLOG Autres valeurs: Nom d'objet qualifié*
	Qualificatif 1: File attente messages	Nom
	Qualificatif 2: Biblio	Nom, *LIBL
WCHJOB	Travail surveilléWatched job	Valeurs uniques: * Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments	Facultatif
	Élément 1: Travail	Nom de travail qualifié
	Qualificatif 1: Travail	Nom générique, nom
	Qualificatif 2: Utilisat	Nom générique, nom
	Qualificatif 3: Numéro	000001-999999, *ALL
WCHLICLOG	Surveiller une entrée du journal LICWatch for LIC log entry	Valeurs uniques: NONE Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Major code	Valeur caractère, *ALL
	Élément 2: Minor code	Valeur caractère, *ALL
	Élément 3: Donnée de comparaison	Valeur caractère, *NONE
	Élément 4: Compare against	ALL, TDENBR, TASKNAME, SVRTYPE, JOBNAME, JOBUSR, JOBNBR, THDID, EXCPID, MODNAME, MODRUNAME, MODEPNAME, MODOFFSET, MODTSP
WCHPAL	Surveiller une entrée PALWatch for PAL entry	Valeurs uniques: NONE Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Code SRC	Valeur caractère, *ALL
	Élément 2: Donnée de comparaison	Valeur caractère, *NONE
	Élément 3: Compare against	RSCNAME, RSCTYPE, *RSCMODEL
WCHTIMO	Durée de la surveillanceLength of time to watch	1-43200, *NOMAX	Facultatif
TRCPGM	Programme de traceTrace program	Valeurs uniques: NONE Autres valeurs: Nom d'objet qualifié*	Facultatif
	Qualificatif 1 : Programme de traceQualificatif 1: Trace program	Nom
	Qualificatif 2: Biblio	Nom, *LIBL
TRCPGMITV	Intervalle	1-9999, *NONE	Facultatif
RUNPTY	Priorité d'exécution	1-99, 25	Facultatif
TEXT	Description de la traceTrace description	Valeur caractère, *BLANK	Facultatif

Objet de configuration (CFGOBJ)

Indique l'objet de configuration à tracer. L'objet est une description de ligne, une description d'interface réseau ou une description de serveur de réseau. Specifies the configuration object to be traced. The object is either a line description, a network interface description, or a network server description.

nom: Indiquez le nom de l'objet de configuration à tracer. Specify the name of the configuration object to be traced.

Type (CFGTYPE)

Indique le type de description de configuration à tracer. Specifies the type of configuration description to trace.

*LIN: L'objet de configuration est une description de ligne. The configuration object is a line description.
*NWI: L'objet de configuration est une description d'interface réseau. The configuration object is a network interface description.
*NWS: L'objet de configuration est une description de serveur réseau. The configuration object is a network server description.

Taille du tampon (MAXSTG)Buffer size (MAXSTG)

Indique la taille du tampon de trace. Specifies the trace buffer size.

128K: Un tampon de trace de 128 kilo-octets est utilisé. A trace buffer of 128 kilobytes is used.
*MIN: La taille minimale de tampon de trace est utilisée. The minimum trace buffer size is used.
*MAX: La taille maximale de tampon de trace est utilisée. The maximum trace buffer size is used.
buffer-size: Indiquez la taille du tampon de trace. Les tailles de tampon valides peuvent être indiquées soit sous forme de nombre de kilo-octets, soit sous forme de l'une des valeurs spéciales suivantes, qui comportent un suffixe d'une lettre, 'K' pour kilo-octets, 'M' pour méga-octets ou 'G' pour giga-octets : 128K, 256K, 2M, 4M, 6M, 8M, 16M, 32M, 64M, 128M, 256M, 512M, 1G, 2G, 4G. La taille minimale du tampon de trace est de 128 kilo-octets. Specify the trace buffer size. Valid buffer sizes may be specified either as number of kilobytes, or as one of the following special values which has a one-letter suffix of 'K' for kilobytes, 'M' for megabytes, or 'G' for gigabytes: 128K, 256K, 2M, 4M, 6M, 8M, 16M, 32M, 64M, 128M, 256M, 512M, 1G, 2G, 4G. The minimum trace buffer size is 128 kilobytes.

Sens des données (DTADIR)Data direction (DTADIR)

Indique les données de communication à tracer. Specifies the communication data to trace.

Remarque :Pour les traces de description de serveur de réseau, ce paramètre est ignoré et *BOTH est utilisé. Remarque :For network server description traces, this parameter is ignored and *BOTH is used.

*BOTH: Les données envoyées et reçues par le système sont tracées. Data sent and received by the system is traced.
*SND: Les données envoyées par le système sont tracées. Data sent by the system is traced.
*RCV: Les données reçues par le système sont tracées. Data received by the system is traced.

Trace pleine (TRCFULL)

Indique l'action effectuée par le système lorsque le tampon de trace est plein de données. Specifies the action the system takes when the trace buffer is full of data.

*WRAP: La trace se poursuit et écrase les données du tampon. The trace continues and overwrites the data in the buffer.
*STOPTRC: La trace s'arrête. The trace stops.

Nombre d'octets utilisateur à tracer (USRDTA)Number of user bytes to trace (USRDTA)

Indique la quantité de données utilisateur de début et de fin à tracer. Specifies the amount of beginning and ending user data to trace.

Remarque :Pour les traces de description de serveur de réseau et les lignes synchrones binaires, ce paramètre est ignoré et *CALC est utilisé. Remarque :For network server description traces and binary synchronous lines, this parameter is ignored and *CALC is used.

Valeurs uniques

*CALC: Le système détermine le nombre d'octets de début et de fin à tracer. Pour les lignes LAN, il s'agit des 100 premiers octets. Pour les autres types de ligne, la trame entière est tracée. The system determines the number of beginning and ending bytes to be traced. For LAN lines, this is the first 100 bytes. For other line types, the whole frame is traced.
*MAX: Tracer le plus possible de trames. Pour les lignes non LAN, *MAX équivaut à *CALC. Trace as much of frames as possible. For non-LAN, *MAX will be the equivalent of *CALC.

Élément 1: Beginning bytes

decimal-number: Indiquez le nombre d'octets de données utilisateur de début à tracer. Specify the number of bytes of beginning user data to be traced.

Élément 2: Ending bytes

*CALC: Le système détermine le nombre d'octets de fin à tracer. The system determines the number of ending bytes to be traced.
decimal-number: Indiquez le nombre d'octets de données utilisateur de fin à tracer. Specify the number of bytes of ending user data to be traced.

Options de trace de communications (CMNTRCOPTS)Communications trace options (CMNTRCOPTS)

Indique le type de données à tracer. Specifies the type of data to be traced.

*ALLDTA: Toutes les données sont tracées. Aucun filtrage n'est indiqué. All data is traced. No filtering is specified.
*RMTCTL: Les données circulant vers et depuis un contrôleur distant sont tracées. The data traveling to and from a remote controller is traced.
*RMTMAC: Les données circulant vers et depuis une adresse MAC (medium access control) distante sont tracées. The data traveling to and from a remote medium access control (MAC) address is traced.
*RMTSAP: Les données circulant vers et depuis un point d'accès au service (SAP) distant sont tracées. The data traveling to and from a remote service access point (SAP) is traced.
*LCLSAP: Les données circulant vers et depuis un point d'accès au service (SAP) local sont tracées. The data traveling to and from a local service access point (SAP) is traced.
*IPPCLNUM: Les données d'un numéro de protocole Internet (IP) sont tracées. The data within an Internet Protocol (IP) number is traced.
*RMTIPADR: Les données circulant vers et depuis une adresse IP distante sont tracées. The data traveling to and from a remote IP address is traced.
*VRTLANID: Les données circulant sur un réseau local virtuel sont tracées. The data traveling on a virtual LAN is traced.

Options de trace DDI (DDITRCOPTS)DDI trace options (DDITRCOPTS)

Le paramètre DDITRCOPTS est pris en charge pour assurer la compatibilité ascendante des programmes CL qui contiennent la commande STRCMNTRC. Le paramètre CMNTRCOPTS offre toutes les fonctions de DDITRCOPTS et doit être utilisé à la place de DDITRCOPTS. The DDITRCOPTS parameter is supported for upward compatibility of CL programs which contain the STRCMNTRC command. The CMNTRCOPTS parameter provides all of the same function as DDITRCOPTS and should be used instead of DDITRCOPTS.

*ALLDTA: Toutes les données sont tracées. Aucun filtrage n'est indiqué. All data is traced. No filtering is specified.
*RMTCTL: Les données circulant vers et depuis un contrôleur distant sont tracées. The data traveling to and from a remote controller is traced.
*RMTMAC: Les données circulant vers et depuis une adresse MAC (medium access control) distante sont tracées. The data traveling to and from a remote medium access control (MAC) address is traced.
*RMTSAP: Les données circulant vers et depuis un point d'accès au service (SAP) distant sont tracées. The data traveling to and from a remote service access point (SAP) is traced.
*LCLSAP: Les données circulant vers et depuis un point d'accès au service (SAP) local sont tracées. The data traveling to and from a local service access point (SAP) is traced.
*IPPCLNUM: Les données d'un numéro de protocole Internet (IP) sont tracées. The data within an Internet Protocol (IP) number is traced.
*RMTIPADR: Les données circulant vers et depuis une adresse IP distante sont tracées. The data traveling to and from a remote IP address is traced.

Contrôleur distant (RMTCTL)Remote controller (RMTCTL)

Indique le contrôleur distant qui reçoit et envoie les données à tracer. Specifies the remote controller receiving and sending the data to be traced.

nom: Indiquez le nom du contrôleur distant. Specify the name of the remote controller.

Adresse MAC distante (RMTMAC)Remote MAC address (RMTMAC)

Indique l'adresse MAC (medium access control) distante qui reçoit et envoie les données à tracer. Specifies the remote medium access control address receiving and sending the data to be traced.

hexadecimal-value: Indiquez l'adresse MAC distante. Specify the remote medium access control address.

SAP distant (RMTSAP)Remote SAP (RMTSAP)

Indique le point d'accès au service distant qui reçoit et envoie les données à tracer. Specifies the remote service access point receiving and sending the data to be traced.

hexadecimal-value: Indiquez le point d'accès au service distant. Specify the remote service access point.

SAP local (LCLSAP)Local SAP (LCLSAP)

Indique le point d'accès au service local qui reçoit et envoie les données à tracer. Specifies the local service access point receiving and sending the data to be traced.

hexadecimal-value: Indiquez le point d'accès au service local. Specify the local service access point.

Numéro de protocole IP (IPPCLNUM)IP protocol number (IPPCLNUM)

Indique le numéro de protocole Internet (IP) à tracer. Specifies the Internet Protocol (IP) number to be traced.

*ICMP: Le groupe de messages de contrôle Internet est tracé. The Internet control message group is traced.
*IGMP: Le groupe du protocole de gestion de groupe Internet est tracé. The Internet group management protocol group is traced.
*TCP: Le groupe de contrôle de transmission est tracé. The transmission control group is traced.
*EGP: Le groupe du protocole de passerelle externe est tracé. The exterior gateway protocol group is traced.
*IGP: Un groupe de passerelle interne privé est tracé. A private interior gateway group is traced.
*UDP: Le groupe de datagrammes utilisateur est tracé. The user datagram group is traced.
*ICMPv6: Le protocole de messages de contrôle Internet pour IPv6 est tracé. The Internet control message protocol for IPv6 is traced.
0-255: Indiquez le numéro de protocole Internet (IP) à tracer. Specify the Internet Protocol (IP) number to trace.

Adresse IP distante (RMTIPADR)Remote IP address (RMTIPADR)

Indique l'adresse IP (Internet Protocol) distante à tracer. Les adresses IPv4 (Internet Protocol version 4), IPv6 (Internet Protocol version 6) et IPv6 mappées IPv4 sont prises en charge. Specifies the remote Internet Protocol (IP) address to be traced. Internet Protocol version 4 (IPv4), Internet Protocol version 6 (IPv6) and IPv4-mapped IPv6 addresses are supported.

Lorsque des adresses IPv6 ou IPv6 mappées IPv4 sont indiquées, la commande Copier la trace de communications (DMPCMNTRC) doit être utilisée pour copier les données collectées dans un fichier STREAM, suivie de la commande Imprimer la trace de communications (PRTCMNTRC). When IPv6 or IPv4-mapped IPv6 addresses are specified, Dump Communications Trace (DMPCMNTRC) command must be used to copy the collected data to a stream file, followed by Print Communications Trace (PRTCMNTRC) command.

valeur-caractère: Indiquez l'adresse IP distante à tracer. Specify the remote IP address to be traced.

Identificateur de réseau local virtuel (VRTLANID)Virtual LAN identifier (VRTLANID)

Indique l'identificateur de réseau local virtuel à tracer. Specifies the virtual LAN identifier to be traced.

1-4094: Indiquez l'identificateur de réseau local virtuel à tracer. Specify the virtual LAN identifier to be traced.
*NONE: Seules les trames ne contenant aucun identificateur de réseau local virtuel seront tracées. Only frames containing no virtual LAN identifier will be traced.

Options de trace LMI (LMITRCOPTS)LMI trace options (LMITRCOPTS)

Indique le type de données à placer dans le tampon de trace. Specifies the type of data to be placed in the trace buffer.

*ALLDTA: Toutes les données, y compris celles de l'interface de gestion locale (LMI), sont placées dans le tampon de trace. All data, including the local management interface (LMI), is placed in the trace buffer.
*NOLMI: Toutes les données, sauf les données LMI, sont placées dans le tampon de trace. All data, except LMI data, is placed in the trace buffer.
*LMIONLY: Seules les données LMI sont placées dans le tampon de trace. Only LMI data is placed in the trace buffer.

Options de trace NWS (NWSTRCOPTS)NWS trace options (NWSTRCOPTS)

Indique le type de données à placer dans le tampon de trace. Specifies the type of data to be placed in the trace buffer.

*NETBIOS: Toutes les données NetBIOS sont placées dans le tampon de trace. All NetBIOS data is placed in the trace buffer.
*INTERNAL: Les données du système d'exploitation du processeur de communications sont placées dans le tampon de trace. The communications processor operating system data is placed in the trace buffer.
*TCPIP: Toutes les données TCP/IP des applications de description de serveur de réseau sont placées dans le tampon de trace. All TCP/IP data for network server description applications is placed in the trace buffer.

Surveiller un message (WCHMSG)Watch for message (WCHMSG)

Indique jusqu'à cinq messages à surveiller. Si une valeur autre que *NONE est indiquée, vous devez indiquer dans le paramètre WCHMSGQ l'endroit où surveiller le message. Lorsque le message surveillé est ajouté à la file d'attente de messages ou au journal indiqué, le programme d'exit de trace est appelé ; si aucun programme d'exit de trace n'est défini, la trace s'arrête. Specifies up to five messages which are to be watched. If a value other than *NONE is specified, you must specify where to watch for the message on the WCHMSGQ parameter. When the watched for message is added to the specified message queue or log, the trace exit program is called; if no trace exit program is defined, the trace stops.

Remarque : Les messages déplacés et renvoyés ne seront pas surveillés. Seule l'occurrence d'origine du message peut être surveillée. Note: Moved and resent messages will not be watched. Only the original instance of the message can be watched.

Remarque : La surveillance des ID de message CPF1124 ou CPF1164 sera ignorée dans le travail QSCWCHPS (qui gère le traitement de la surveillance). Un programme d'exit utilisateur ne sera pas déclenché lorsque CPF1124 ou CPF1164 est émis dans le travail QSCWCHPS. Note: Watching for message id CPF1124 or CPF1164 will be ignored in job QSCWCHPS (which handles watch processing). A user exit program will not be triggered when CPF1124 or CPF1164 is issued in job QSCWCHPS.

Valeurs uniques

*NONE: Aucun message ne sera surveillé. No messages will be watched.

Élément 1: Message to watch

*ALL: Tous les messages doivent être surveillés. Cela comprend les messages stockés et les messages immédiats. Sachez que la surveillance de tous les messages peut dégrader les performances de votre système. Utilisez-la avec précaution. All messages are to be watched. This includes stored messages and immediate messages. Be aware that watching for all messages might cause performance degradation on your system. Use it cautiously.
*IMMED: Tous les messages immédiats ou impromptus seront surveillés. All immediate or impromptu messages will be watched.
nom-générique: Indiquez l'identificateur de message générique à surveiller. Un nom générique est une chaîne de caractères composée d'un ou plusieurs caractères suivis d'un astérisque (*) ; par exemple, ABC*. L'astérisque remplace tout caractère valide. Un nom de message générique désigne tous les messages dont l'identificateur commence par le préfixe générique. Specify the generic message identifier to be watched. 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 message name specifies all messages with message identifiers that begin with the generic prefix.
nom: Indiquez l'identificateur de message de 7 caractères à surveiller. Specify the 7-character message identifier to be watched.

Élément 2: Donnée de comparaison

Indiquez les données de comparaison à utiliser si un message correspondant au message indiqué est ajouté à la file d'attente de messages ou au journal indiqué. Si les données du message, le « programme émetteur » ou le « programme destinataire » incluent le texte indiqué, la condition surveillée est vraie. Si les données du message, le « programme émetteur » ou le « programme destinataire » ne contiennent pas le texte indiqué, la fonction de trace se poursuit. Specify comparison data to be used if a message matching the specified message is added to the specified message queue or log. If the message data, the "From program" or the "To program" includes the specified text, the watched for condition is true. If the message data, the "From program" or the "To program" does not contain the specified text, the trace function continues.

*NONE: Aucune donnée de comparaison n'est indiquée. Si un message correspondant au message indiqué est ajouté à la file d'attente de messages ou au journal indiqué, la condition surveillée est vraie. No comparison data is specified. If a message matching the specified message is added to the specified message queue or log, the watched for condition is true.
valeur-caractère: Indiquez la chaîne de texte utilisée pour la comparaison avec les données du message, le « programme émetteur » ou le « programme destinataire » du message surveillé. Ce texte est sensible à la casse et peut être placé entre guillemets pour indiquer des blancs intégrés ou de fin. Specify the text string used to compare against the message data, the "From program" or the "To program" of the watched for message. This text is case sensitive and can be quoted in order to specify imbedded or trailing blanks.

Élément 3: Compare against

Indiquez la partie du message avec laquelle les données de comparaison indiquées pour l'élément 2 doivent être comparées. Specify which part of the message the comparison data specified for element 2 is to be compared against.

*MSGDATA: Les données de comparaison seront comparées aux données de remplacement du message. The comparison data will be compared against the message replacement data.
*FROMPGM: Les données de comparaison seront comparées au nom du programme qui envoie le message, ou au nom du programme ILE qui contient la procédure qui envoie le message. The comparison data will be compared against the name of the program sending the message, or the name of the ILE program that contains the procedure sending the message.
*TOPGM: Les données de comparaison seront comparées au nom du programme auquel le message a été envoyé, ou au nom du programme ILE qui contient la procédure à laquelle le message a été envoyé. The comparison data will be compared against the name of the program the message was sent to, or the name of the ILE program that contains the procedure the message was sent to.

Élément 4: Type de message

Indiquez le type de message attribué au message à surveiller. Specify the message type assigned to the message to be watched.

*ALL: Tous les types de message doivent être surveillés. Cela comprend les types de message fin, commande, diagnostic, *ESCAPE, information, demande d'information, notification, réponse, demande, copie de l'expéditeur, portée et état. All the message types are to be watched. This includes completion, command, diagnostic, escape, informational, inquiry, notify, reply, request, sender's copy, scope and status message types.
*COMP: Un message de fin doit être surveillé. A completion message is to be watched.
*DIAG: Un message de diagnostic doit être surveillé. A diagnostic message is to be watched.
*ESCAPE: Un message *ESCAPE doit être surveillé. An escape message is to be watched.
*INFO: Un message d'information doit être surveillé. An informational message is to be watched.
*INQ: Un message de demande d'information doit être surveillé. An inquiry message is to be watched.
*NOTIFY: Un message de notification doit être surveillé. A notify message is to be watched.
*SCOPE: Un message de portée doit être surveillé. A scope message is to be watched.
*STATUS: Un message d'état doit être surveillé. A status message is to be watched.

Élément 5: Opérateur relationnel

Indiquez un opérateur relationnel avec lequel le code de gravité du message est comparé. Specify one relational operator against which the message severity code is compared.

*GE: Supérieur ou égal. Greater than or equal.
*EQ: Égal. Equal.
*GT: Supérieur. Greater than.
*LT: Inférieur. Less than.
*LE: Inférieur ou égal. Less than or equal.

Élément 6: Code gravité

Indique le code de gravité du message à surveiller. Specifies the severity code of the message to be watched.

00: Le code de gravité attribué au message surveillé est 00. The severity code assigned to the message to be watched for is 00.
Severity-code: Indiquez une valeur, comprise entre 00 et 99, comme niveau de gravité associé au message à surveiller. Specify a value, ranging from 00 through 99, as the severity level associated with the message to be watched.

File d'attente de messages surveillée (WCHMSGQ)Watched message queue (WCHMSGQ)

Indique où surveiller les messages indiqués dans le paramètre WCHMSG. Vous pouvez demander la surveillance de l'ajout du message dans la file d'attente de messages de l'opérateur système, dans l'historique, dans d'autres files d'attente de messages et dans des historiques de travail. Jusqu'à trois files d'attente de messages ou valeurs spéciales peuvent être indiquées. Specifies where to watch for the messages specified on the WCHMSG parameter. You can specify to watch the message being added to the system operator message queue, the history log, other message queues, and job logs. Up to three message queues or special values can be specified.

Élément 1: File attente messages

Valeurs uniques

*SYSOPR: Surveiller les messages ajoutés à la file d'attente de messages de l'opérateur système (file d'attente de messages QSYSOPR de la bibliothèque QSYS). Watch messages added to the system operator message queue (QSYSOPR message queue in library QSYS).
*JOBLOG: Surveiller les messages ajoutés aux historiques des travaux indiqués dans le paramètre Travail surveillé (WCHJOB). Watch messages added to the job logs of the jobs specified for the Watched job (WCHJOB) parameter.
*HSTLOG: Surveiller les messages ajoutés à l'historique (file d'attente de messages QHST de la bibliothèque QSYS). Watch messages added to the history log (QHST message queue in library QSYS).

Qualificatif 1: File attente messages

nom: Indiquez le nom de la file d'attente de messages à surveiller. Specify the name of the message queue to watch.

Qualificatif 2: Biblio

*LIBL: Toutes les bibliothèques de la liste de bibliothèques de l'unité d'exécution en cours sont recherchées jusqu'à ce que la première occurrence soit trouvée. All libraries in the library list for the current thread are searched until the first match is found.

nom: Indiquez le nom de la bibliothèque dans laquelle se trouve la file d'attente de messages. Specify the name of the library where the message queue is located.

Travail surveillé (WCHJOB)Watched job (WCHJOB)

Indique le travail dont l'historique est surveillé pour les messages indiqués dans le paramètre WCHMSG. Le travail indiqué n'est surveillé que si *JOBLOG est indiqué dans le paramètre WCHMSGQ. Jusqu'à cinq noms de travail peuvent être indiqués. Specifies the job whose job log is watched for the messages specified on the WCHMSG parameter. The specified job will only be watched if *JOBLOG is specified on the WCHMSGQ parameter. Up to five job names may be specified.

Valeurs uniques

*: Seul l'historique du travail qui a émis cette commande de trace est surveillé. Only the job log of the job that issued this trace command is watched.

Élément 1: Travail

Qualificatif 1: Travail

nom-générique: Indiquez le nom générique du travail à surveiller. Un nom générique est une chaîne de caractères composée d'un ou plusieurs caractères suivis d'un astérisque (*) ; par exemple, ABC*. L'astérisque remplace tout caractère valide. Un nom de travail générique désigne tous les travaux dont le nom commence par le préfixe générique. Specify the generic name of the job to be watched. 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 job name specifies all jobs with job names that begin with the generic prefix.
nom: Indiquez le nom du travail à surveiller. Specify the name of the job to be watched.

Qualificatif 2: Utilisat

nom-générique: Indiquez le nom générique du nom d'utilisateur du travail à surveiller. Un nom générique est une chaîne de caractères composée d'un ou plusieurs caractères suivis d'un astérisque (*) ; par exemple, ABC*. L'astérisque remplace tout caractère valide. Un nom d'utilisateur générique désigne tous les travaux portant le nom de travail indiqué et dont le nom d'utilisateur commence par le préfixe générique. Specify the generic name of the user name of the job to be watched. 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 user name specifies all jobs with the specified job name and with user names that begin with the generic prefix.
nom: Indiquez le nom d'utilisateur du travail à surveiller. Specify the user name of the job to be watched.

Qualificatif 3: Numéro

*ALL: Tous les travaux portant le nom de travail et le nom d'utilisateur indiqués sont surveillés. All jobs with the specified job name and user name are watched.
000000-999999: Indiquez le numéro de travail pour qualifier plus précisément le nom de travail et le nom d'utilisateur. Vous ne pouvez pas indiquer de numéro de travail si un qualificatif de nom de travail générique ou de nom d'utilisateur générique est indiqué. Specify the job number to further qualify the job name and user name. You cannot specify a job number if a generic job name or a generic user name qualifier is specified.

Surveiller une entrée du journal LIC (WCHLICLOG)Watch for LIC log entry (WCHLICLOG)

Indique jusqu'à cinq identificateurs d'entrée du journal du code interne sous licence (LIC) à surveiller. Chaque entrée du journal LIC contient un code majeur et un code mineur. La condition surveillée sera remplie si une entrée du journal LIC correspondant aux codes majeur et mineur indiqués et aux éventuelles données de comparaison indiquées est ajoutée. Lorsque l'entrée de journal surveillée est ajoutée au journal LIC, le programme d'exit de trace est appelé, même si les données de comparaison indiquées ne correspondent pas ; si aucun programme d'exit de trace n'est défini, la trace s'arrête. Specifies up to five licensed internal code (LIC) log entry identifiers which are to be watched for. Each LIC log entry contains a major and a minor code. The watched for condition will be met if a LIC log entry is added that matches the specified major and minor codes and any comparison data specified. When the watched for log entry is added to the LIC log, the trace exit program is called, even when the comparison data specified does not match; if no trace exit program is defined, the trace stops.

Valeurs uniques

*NONE: Aucune entrée du journal LIC ne sera surveillée. No LIC log entries will be watched for.

Élément 1: Major code

*ALL: Tout code majeur d'entrée du journal LIC sera considéré comme une correspondance. Si *ALL est indiqué pour le code majeur, vous ne pouvez pas indiquer *ALL pour le code mineur de l'entrée du journal LIC. Any LIC log entry major code will be considered to be a match. If *ALL is specified for the major code, you cannot specify *ALL for the LIC log entry minor code.
valeur-caractère: Indiquez le code majeur du journal LIC à surveiller. Vous pouvez indiquer soit un chiffre hexadécimal, soit un point d'interrogation pour chaque caractère du code à quatre chiffres. Un point d'interrogation est un caractère générique qui correspond à n'importe quel chiffre à cette position. Jusqu'à trois caractères génériques peuvent être indiqués. Specify the LIC log major code to be watched for. You can specify either a hexadecimal digit or a question mark for each character in the four-digit code. A question mark is a wildcard character that will match any digit in that position. Up to three wildcard characters can be specified.

Élément 2: Minor code

*ALL: Tout code mineur d'entrée du journal LIC sera considéré comme une correspondance. Si *ALL est indiqué pour le code mineur, vous ne pouvez pas indiquer *ALL pour le code majeur de l'entrée du journal LIC. Any LIC log entry minor code will be considered to be a match. If *ALL is specified for the minor code, you cannot specify *ALL for the LIC log entry major code.
valeur-caractère: Indiquez le code mineur du journal LIC à surveiller. Vous pouvez indiquer soit un chiffre hexadécimal, soit un point d'interrogation pour chaque caractère du code à quatre chiffres. Un point d'interrogation est un caractère générique qui correspond à n'importe quel chiffre à cette position. Jusqu'à trois caractères génériques peuvent être indiqués. Specify the LIC log minor code to be watched for. You can specify either a hexadecimal digit or a question mark for each character in the four-digit code. A question mark is a wildcard character that will match any digit in that position. Up to three wildcard characters can be specified.

Élément 3: Donnée de comparaison

Indiquez les données de comparaison à utiliser si une entrée de journal correspondant aux codes majeur et mineur indiqués est ajoutée au journal du code interne sous licence (LIC). Si ce texte est trouvé dans les zones de données de l'entrée du journal LIC surveillée, la condition surveillée est vraie. Si ce texte n'est pas trouvé dans les zones de données de l'entrée du journal LIC surveillée et qu'aucun programme d'exit n'est indiqué dans le paramètre TRCPGM, la fonction de trace se poursuit. Si l'entrée de journal correspond aux codes majeur et mineur indiqués et qu'un programme d'exit est indiqué dans le paramètre TRCPGM, mais que les données de l'entrée ne contiennent pas le texte indiqué, le programme d'exit est appelé pour déterminer si la trace doit se poursuivre ou s'arrêter. Specify comparison data to be used if a log entry matching the specified major and minor codes is added to the licensed internal code (LIC) log. If this text is found in the LIC log entry data fields of the watched for log entry, the watched for condition is true. If this text is not found in the LIC log entry data fields of the watched for log entry and no exit program is specified on the TRCPGM parameter, the trace function continues. If the log entry matches the specified major and minor codes and an exit program is specified on the TRCPGM parameter, but the entry data does not contain the specified text, the exit program is called to determine if the trace should continue or stop.

*NONE: Aucune donnée de comparaison n'est indiquée. Si une entrée du journal LIC correspondant aux codes majeur et mineur indiqués est ajoutée au journal LIC, la condition surveillée est vraie. No comparison data is specified. If a LIC log entry matching the specified major and minor codes is added to the LIC log, the watched for condition is true.
valeur-caractère: Specify the text string used to compare against the entry data of the watched for log entry. If this text is found in the LIC log entry data field specified for element 4, the watch condition is considered to be true. This text is case sensitive. If *ALL is specified in the LIC log compare against field, the LIC log fields which will be compared are TDE number, task name, server type, job name, user ID, job number, thread ID, exception ID, LIC module compile timestamp, LIC module offset, LIC module RU name, LIC module name, LIC module entry point name. The comparison data cannot be used to match across two fields, and can match an entire field or a substring of any field.
Lors de la surveillance d'un ID d'exception, les quatre chiffres hexadécimaux de l'ID d'exception doivent être indiqués. Le préfixe MCH peut également être indiqué si vous souhaitez comparer uniquement avec la zone d'ID d'exception et éviter d'éventuelles correspondances de sous-chaîne avec les autres zones. When watching for an exception ID, all four hexadecimal digits of the exception ID must be specified. Also, the prefix MCH may be specified if you want to compare only against the exception ID field and avoid possible substring matches with the other fields.

Élément 4: Compare against

Indiquez la partie du journal LIC avec laquelle les données de comparaison indiquées pour l'élément 3 doivent être comparées. Specify which part of the LIC log the comparison data specified for element 3 is to be compared against.

*ALL: Les données de comparaison du journal LIC seront comparées à toutes les zones décrites ci-dessous. The LIC log comparison data will be compared against all the fields described below.
*TDENBR: Les données de comparaison du journal LIC seront comparées au numéro de l'élément de répartition de tâche (TDE) qui a demandé l'entrée du journal LIC. The LIC log comparison data will be compared against the number of the task dispatching element (TDE) which requested the LIC log entry.
*TASKNAME: Les données de comparaison du journal LIC seront comparées au nom de la tâche qui a demandé l'entrée du journal LIC. Le nom de tâche est à blanc (hex 40) si l'entrée du journal LIC n'est pas demandée par une tâche. The LIC log comparison data will be compared against the name of the task which requested the LIC log entry. Task name is blank (hex 40s) if the LIC log entry is not requested by a task.
*SVRTYPE: Les données de comparaison du journal LIC seront comparées au type de serveur qui a demandé l'entrée du journal LIC. Le type de serveur est à blanc (hex 40) si l'entrée du journal LIC n'est pas demandée par un serveur. The LIC log comparison data will be compared against the type of server that requested the LIC log entry. Server type is blank (hex 40s) if the LIC log entry is not requested by a server.
*JOBNAME: Les données de comparaison du journal LIC seront comparées au nom du travail qui a demandé l'entrée du journal LIC. Le nom de travail LIC est à blanc (hex 40) si l'entrée du journal LIC n'est pas demandée par un travail. The LIC log comparison data will be compared against the name of the job which requested the LIC log entry. LIC job name is blank (hex 40s) if the LIC log entry is not requested by a job.
*JOBUSR: Les données de comparaison du journal LIC seront comparées au nom d'utilisateur du travail qui a demandé l'entrée du journal LIC. Le nom d'utilisateur LIC est à blanc (hex 40) si l'entrée du journal LIC n'est pas demandée par un travail. The LIC log comparison data will be compared against the user name of the job which requested the LIC log entry. LIC user name is blank (hex 40s) if the LIC log entry is not requested by a job.
*JOBNBR: Les données de comparaison du journal LIC seront comparées au numéro de travail (000000-999999) qui qualifie plus précisément le nom de travail et le nom d'utilisateur du travail qui a demandé l'entrée du journal LIC. Le numéro de travail LIC est à blanc (hex 40) si l'entrée du journal LIC n'est pas demandée par un travail. The LIC log comparison data will be compared against the job number (000000-999999) to further qualify the job name and user name of the job which requested the LIC log entry. LIC job number is blank (hex 40s) if the LIC log entry is not requested by a job.
*THDID: Les données de comparaison du journal LIC seront comparées à l'unité d'exécution qui a demandé l'entrée du journal LIC. L'identificateur d'unité d'exécution est à zéros binaires si l'entrée du journal LIC n'est pas demandée par une unité d'exécution. The LIC log comparison data will be compared against the thread which requested the LIC log entry. Thread identifier is binary zeros if the LIC log entry is not requested by a thread.
*EXCPID: Les données de comparaison du journal LIC seront comparées à l'exception qui a provoqué la demande de l'entrée du journal LIC. Il s'agit d'une zone hexadécimale de 2 octets formée en concaténant, au numéro de groupe d'exceptions de 1 octet de poids fort, un numéro de sous-type d'exception de 1 octet de poids faible. L'identificateur d'exception est à zéros binaires si l'entrée du journal LIC n'est pas demandée à la suite d'une exception. The LIC log comparison data will be compared against the exception that caused the LIC log entry to be requested. This is a 2-byte hexadecimal field formed by concatenating to the high-order 1-byte exception group number a low-order 1-byte exception subtype number. Exception identifier is binary zeros if the LIC log entry is not requested as a result of an exception.
*MODNAME: Les données de comparaison du journal LIC seront comparées au nom du module LIC qui a demandé l'entrée du journal LIC. Si le nom du module dépasse 64 caractères, le nom du module LIC est tronqué à 64 caractères. The LIC log comparison data will be compared against the LIC module name which requested the LIC log entry. If the module name is greater than 64 characters, the LIC module name is truncated to 64 characters.
*MODRUNAME: Les données de comparaison du journal LIC seront comparées au nom de l'unité de remplacement du module LIC. Le nom de l'unité de remplacement du module LIC est toujours en EBCDIC majuscules. The LIC log comparison data will be compared against the LIC module replacement unit name. LIC module RU name is always in upper case EBCDIC.
*MODEPNAME: Les données de comparaison du journal LIC seront comparées au nom du point d'entrée qui a demandé l'entrée du journal LIC. Si le nom du point d'entrée dépasse 128 caractères, le nom du point d'entrée du module LIC est tronqué à 128 caractères. The LIC log comparison data will be compared against the name of the entry point which requested the LIC log entry. If the entry point name is greater than 128 characters, the LIC module entry point name is truncated to 128 characters.
*MODOFFSET: Les données de comparaison du journal LIC seront comparées au déplacement en octets dans le texte du module LIC qui a demandé l'entrée du journal LIC. The LIC log comparison data will be compared against the byte offset into the LIC module text which requested the LIC log entry.
*MODTSP: Les données de comparaison du journal LIC seront comparées à l'horodatage de compilation du module LIC. Le format de cette zone est le format d'horodatage du système. The LIC log comparison data will be compared against the timestamp of when the LIC module was compiled. The format for this field is the system time-stamp format.

Surveiller une entrée PAL (WCHPAL)Watch for PAL entry (WCHPAL)

Indique jusqu'à cinq entrées du journal d'activité du produit (PAL) à surveiller. Lorsque le PAL surveillé se produit, le programme d'exit de trace est appelé ; si aucun programme d'exit de trace n'est défini, la trace s'arrête. Specifies up to five Product Activity Log (PAL) entries which are to be watched for. When the watched for PAL occurs, the trace exit program is called; if no trace exit program is defined, the trace stops.

Valeurs uniques

*NONE: Aucune entrée PAL ne sera surveillée. No PAL entries will be watched for.

Autres valeurs (jusqu'à 5 répétitions)

Élément 1: Code SRC

*ALL: Tout code de référence système sera considéré comme une correspondance. Any system reference code will be considered to be a match.
valeur-caractère: Indiquez le code de référence système (SRC) à surveiller. Vous pouvez indiquer soit un chiffre hexadécimal, soit un point d'interrogation pour chaque caractère du code à huit chiffres. Un point d'interrogation est un caractère générique qui correspond à n'importe quel chiffre à cette position. Jusqu'à sept caractères génériques peuvent être indiqués. Vous pouvez également indiquer un SRC générique, c'est-à-dire une chaîne de caractères composée d'un ou plusieurs caractères suivis d'un astérisque (*) ; par exemple, ABC*. L'astérisque remplace tout caractère valide. Un SRC générique désigne toutes les entrées PAL dont le code de référence système commence par le préfixe générique. Specify the system reference code (SRC) to be watched for. You can specify either a hexadecimal digit or a question mark for each character in the eight-digit code. A question mark is a wildcard character that will match any digit in that position. Up to seven wildcard characters can be specified. You can also specify a generic SRC that 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 SRC specifies all PAL entries with system reference codes that begin with the generic prefix.

Élément 2: Donnée de comparaison

Indiquez les données de comparaison à utiliser si une entrée PAL correspondant au code de référence système indiqué se produit. Si la zone indiquée à l'élément 3 correspond au texte indiqué, la condition surveillée est vraie. Si la zone indiquée à l'élément 3 ne correspond pas au texte indiqué, la fonction de surveillance se poursuit simplement. Specify comparison data to be used if a PAL entry matching the specified system reference code occurs. If the field specified in element 3 matches the specified text, the watched for condition is true. If the field specified in element 3 does not match the specified text, the watch function just continues.

*NONE

Aucune donnée de comparaison n'est indiquée. Si une entrée PAL correspondant au code de référence système indiqué se produit, la condition surveillée est vraie. No comparison data is specified. If a PAL entry matching the specified system reference code occurs, the watched for condition is true.

valeur-caractère

Specify the text string used to compare against the field specified in element 3 of the watched for PAL entry. This text is case sensitive.

Vous pouvez indiquer les caractères génériques point d'interrogation (?) et astérisque (*) dans la chaîne de texte. Un point d'interrogation est un caractère générique d'un seul caractère et correspond à n'importe quel caractère à la même position. Par exemple, '??123' correspond à toute valeur de cinq caractères se terminant par '123'. Plusieurs caractères génériques point d'interrogation peuvent être indiqués pour la valeur des données de comparaison. You can specify question mark (?) and asterisk (*) wildcard characters in the text string. A question mark is a single-character wildcard and will match any character in the same position. For example, '??123' will match any value that is five characters long and ends with '123'. Multiple question mark wildcard characters can be specified for the comparison data value.

Un astérisque est un caractère générique de plusieurs caractères. Vous pouvez indiquer un seul caractère générique astérisque à la fin de la valeur des données de comparaison. Par exemple, 'ABC*' correspond à toute valeur commençant par les lettres 'ABC'. An asterisk is a multiple-character wildcard character. You can specify a single asterisk wildcard character at the end of the comparison data value. For example, 'ABC*' will match any value that begins with the letters 'ABC'.

Élément 3: Compare against

*RSCNAME: Les données de comparaison seront comparées au nom de l'unité physique dont l'entrée figure dans le journal. Un nom de ressource est d'abord attribué par le système, mais il a pu être remplacé par une nouvelle valeur par un utilisateur. The comparison data will be compared against the name of the physical device that has the entry in the log. A resource name is assigned at first by the system, but may have been changed to a new value by a user.
*RSCTYPE: Les données de comparaison seront comparées au numéro ou au mot servant à identifier un produit. The comparison data will be compared against the number or word used to identify a product.
*RSCMODEL: Les données de comparaison seront comparées aux numéros ou aux lettres servant à identifier le niveau de fonction d'un produit d'un type donné. The comparison data will be compared against the numbers or letters used to identify the feature level of a product with a given type.

Durée de la surveillance (WCHTIMO)Length of time to watch (WCHTIMO)

Indique le délai maximal, en minutes, de surveillance d'un message, d'une entrée du journal du code interne sous licence (LIC) ou d'une entrée du journal d'activité du produit (PAL). Lorsque le délai indiqué s'est écoulé, le programme d'exit de trace est appelé (si un tel programme a été indiqué dans le paramètre TRCPGM), la trace prend fin et le message CPI3999 est envoyé à l'historique. Specifies the time limit, in minutes, for watching for a message or a licensed internal code (LIC) log entry or a Product Activity Log (PAL) entry. When the specified amount of time has elapsed, the trace exit program is called (if one was specified on the TRCPGM parameter), the trace is ended, and message CPI3999 is sent to the history log.

*NOMAX: Il n'y a pas de délai maximal de surveillance d'un message, d'une entrée du journal LIC ou d'une entrée PAL particulière. There is no time limit for watching for a particular message or LIC log entry or PAL entry.
1-43200: Indiquez le nombre de minutes pendant lesquelles la trace restera active tant qu'aucune des conditions surveillées n'a été remplie. Specify the number of minutes that the trace will remain active while none of the watched for conditions have been met.

Programme de trace (TRCPGM)Trace program (TRCPGM)

Indique le programme à appeler pour les commandes et procédures de trace définies par l'utilisateur. Specifies the program to be called for user-defined trace commands and procedures.

Le programme de trace sera appelé : The trace program will be called:

Avant le démarrage de la trace d'application. Before the application trace starts.
Après une correspondance avec un message indiqué dans le paramètre WCHMSG, une correspondance avec une entrée du journal du code interne sous licence (LIC) indiquée dans le paramètre WCHLICLOG, ou une correspondance avec une entrée du journal d'activité du produit (PAL) indiquée dans le paramètre WCHPAL. After a match of a message specified for the WCHMSG parameter, or a match of a Licensed Internal Code (LIC) log entry specified for the WCHLICLOG parameter, or a match of a Product Activity Log (PAL) entry specified for the WCHPAL parameter occurs.
Lorsque l'intervalle de temps indiqué dans le paramètre TRCPGMITV est atteint. When the time interval specified on the TRCPGMITV parameter is reached.
Lorsque la durée de surveillance indiquée dans le paramètre WCHTIMO est atteinte. When the length of time to watch specified on WCHTIMO parameter is reached.

Trois paramètres d'entrée et un paramètre de sortie sont associés au programme de trace. Les quatre paramètres sont obligatoires : There are three input parameters and one output parameter associated with the trace program. The four parameters are required:

1   Trace option setting   Input    Char(10)
2   Reserved               Input    Char(10)
3   Error detected         Output   Char(10)
4   Comparison data        Input    Char(*)

Les valeurs autorisées pour le paramètre « Trace option setting » sont : Allowed values for the "Trace option setting" parameter are:

*ON: La fonction de surveillance de trace démarre lorsque la collecte des informations de trace est lancée. The watch for trace facility is starting when the collection of trace information is started.
*MSGID: Une correspondance avec un message indiqué dans le paramètre WCHMSG s'est produite. A match on a message specified on WCHMSG parameter occurred.
*LICLOG: Une correspondance avec un journal LIC indiqué dans le paramètre WCHLICLOG s'est produite. A match on a LIC log specified on the WCHLICLOG parameter occurred.
*CMPDATA: Les codes majeur et mineur d'un journal LIC correspondaient, mais pas les données de comparaison. The major and minor code of a LIC log matched, but the comparison data did not.
*INTVAL: L'intervalle de temps indiqué dans le paramètre TRCPGMITV s'est écoulé. The time interval specified on TRCPGMITV parameter is elapsed.
*WCHTIMO: La durée de surveillance indiquée dans le paramètre WCHTIMO s'est écoulée. The length of time to watch specified on WCHTIMO parameter is elapsed.
*PAL: Une correspondance avec un PAL et avec les éventuelles données de comparaison associées indiquées dans le paramètre WCHPAL s'est produite. A match on a PAL and any associated comparison data specified on the WCHPAL parameter occurred.

Le paramètre « Reserved » doit être défini à blanc. The "Reserved" parameter must be set to blanks.

Les valeurs autorisées pour le paramètre « Error detected » sont : Allowed values for the "Error detected" parameter are:

*CONTINUE: La trace et la fonction de surveillance d'événement de trace continueront de s'exécuter. The trace and the watch for trace event facility will continue running.
*STOP: La trace et la fonction de surveillance d'événement de trace prendront fin. The trace and the watch for trace event facility will be ended.
*ERROR: Erreur détectée par le programme de trace du client. Error detected by customer trace program.

Les valeurs autorisées pour le paramètre « Comparison data » lorsque *MSGID est indiqué pour le paramètre « Trace option setting » correspondent à la structure suivante : Allowed values for the "Comparison data" parameter when *MSGID is specified for the "Trace option setting" parameter will be the following structure:

OFFSET     TYPE         FIELD
Dec Hex
 0   0     BINARY(4)    Length of trace information
 4   4     CHAR(7)      Message watched
11   B     CHAR(9)      Reserved
20  14     BINARY(4)    Offset to comparison data
24  18     BINARY(4)    Length of comparison data
 *   *     CHAR(*)      Message comparison data

Les valeurs autorisées pour le paramètre « Comparison data » lorsque *LICLOG ou *CMPDATA est indiqué pour le paramètre « Trace option setting » correspondent à la structure suivante : Allowed values for the "Comparison data" parameter when *LICLOG or *CMPDATA is specified for the "Trace option setting" parameter will be the following structure:

OFFSET     TYPE         FIELD
Dec Hex
 0   0     BINARY(4)    Length of trace information
 4   4     CHAR(4)      LIC Log major code
 8   8     CHAR(4)      LIC Log minor code
12   C     CHAR(8)      LIC Log id (keyword DMPID on PRTINTDTA)
20  14     BINARY(4)    Offset to comparison data
24  18     BINARY(4)    Length of comparison data
 *   *     CHAR(*)      LIC log comparison data

Les valeurs autorisées pour le paramètre « Comparison data » lorsque *ON, *INTVAL ou *WCHTIMO est indiqué pour le paramètre « Trace option setting » correspondent à la structure suivante : Allowed values for the "Comparison data" parameter when *ON, *INTVAL or *WCHTIMO is specified for the "Trace option setting" parameter will be the following structure:

OFFSET     TYPE         FIELD
Dec Hex
 0   0     BINARY(4)    Length of trace information (always 4).

Les valeurs autorisées pour le paramètre « Comparison data » lorsque *PAL est indiqué pour le paramètre « Trace option setting » correspondent à la structure suivante : Allowed values for the "Comparison data" parameter when *PAL is specified for the "Trace option setting" parameter will be the following structure:

OFFSET     TYPE         FIELD
Dec  Hex
  0    0   BINARY(4)    Length of watch information
  4    4   CHAR(8)      System reference code
 12    C   CHAR(10)     Device name
 22   16   CHAR(4)      Device type
 26   1A   CHAR(4)      Model
 30   1E   CHAR(15)     Serial number
 45   2D   CHAR(10)     Resource name
 55   37   CHAR(8)      Error Log id (keyword ERRLOGID on PRTERRLOG)
 63   3F   CHAR(8)      PAL timestamp
 71   47   CHAR(4)      Reference code
 75   4B   CHAR(8)      Secondary code
 83   53   CHAR(8)      Table identifier
 91   5B   CHAR(1)      Reserved
 92   5C   BINARY(4)    Sequence
 96   60   BINARY(4)    Offset to comparison data
 100  64   BINARY(4)    Length of comparison data
 104  68   CHAR(10)     PAL compare against
 *   *     CHAR(*)      PAL comparison data

For more information on the trace exit program interface, refer to the Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/)

Valeurs uniques

*NONE: Aucun programme d'exit de trace n'est défini. Si un message, une entrée du journal du code interne sous licence (LIC) ou une entrée du journal d'activité du produit (PAL) surveillé est ajouté, ou si le délai de surveillance indiqué est dépassé, la fonction de trace prend fin. No trace exit program is defined. If a watched for message or licensed internal code (LIC) log entry or Product Activity Log (PAL) entry is added, or if the specified watch time limit is exceeded, the trace function ends.

Qualificatif 1 : Programme de trace Qualificatif 1: Trace program

nom: Indiquez le nom du programme d'exit de trace. Specify the name of the trace exit program.

Qualificatif 2: Biblio

*LIBL: Toutes les bibliothèques de la liste de bibliothèques du travail sont parcourues jusqu'à la première correspondance. All libraries in the job's library list are searched until the first match is found.
nom: Indiquez le nom de la bibliothèque dans laquelle se trouve le programme d'exit utilisateur. Specify the name of the library where the user exit program is located.

Intervalle (TRCPGMITV)

Indique la fréquence d'appel du programme d'exit de trace. Specifies how often the trace exit program will be called.

*NONE: Aucun intervalle de temps n'est indiqué. Le programme d'exit de trace ne sera pas appelé du fait de l'écoulement d'un intervalle de temps. No time interval is specified. The trace exit program will not be called because a time interval has elapsed.
1-9999: Indiquez l'intervalle de temps, en secondes, qui détermine la fréquence d'appel du programme d'exit de trace. Il doit être inférieur à la durée indiquée pour le paramètre Durée de la surveillance (WCHTIMO). Specify the interval of time, in seconds, of how often the trace exit program will be called. This must be less than the amount of time specified for the Length of time to watch (WCHTIMO) parameter.

Priorité d'exécution (RUNPTY)

Indique la priorité du travail dans lequel le travail de la session de surveillance sera exécuté. Specifies the priority of the job where the watch session work will be run.

25: Une priorité de travail de 25 sera utilisée. A job priority of 25 will be used.
1-99: Indiquez la priorité d'exécution du travail. Pour plus d'informations sur la priorité d'exécution d'un travail, voir Ensemble de rubriques Gestion des travaux de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ Specify the run priority of the job. For more information on job run priority, refer to the Ensemble de rubriques Gestion des travaux de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/

Description de la trace (TEXT)Trace description (TEXT)

Indique le texte qui décrit brièvement l'objet. Specifies the text that briefly describes the object.

*BLANK: Aucun texte n'est indiqué. Text is not specified.
valeur-caractère: Indiquez un texte de 20 caractères maximum. Specify up to 20 characters of text.

Exemples

Exemple 1 : Démarrage d'une trace de communications pour une description de ligne Example 1: Start a Communications Trace for a Line Description

STRCMNTRC   CFGOBJ(*QESLINE)  CFGTYPE(*LIN)

Cette commande démarre une trace de communications de la description de ligne QESLINE. This command starts a communications trace of line description QESLINE.

Exemple 2 : Démarrage d'une trace avec surveillance d'un message pour y mettre fin Example 2: Start a Trace and Watch for a Message to End the Trace

STRCMNTRC   CFGOBJ(LINE001)  CFGTYPE(*LIN)  WCHMSG((MCH2804))
            WCHMSGQ((*SYSOPR) (*JOBLOG))
            WCHJOB((*ALL/MYUSER/MYJOBNAME))
            TRCPGM(MYLIB/TRCEXTPGM)

Cette commande démarre une trace de communications de la description de ligne LINE001. La trace prendra fin lorsque le message MCH2804 sera trouvé dans la file d'attente de messages de l'opérateur système ou dans l'historique du travail *ALL/MYUSER/MYJOBNAME. En outre, MYLIB/TRCEXTPGM est indiqué comme programme d'exit de trace. This command starts a communications trace of line description LINE001. The trace will be ended when MCH2804 message is found on the System Operator message queue or within the *ALL/MYUSER/MYJOBNAME job log. Also, MYLIB/TRCEXTPGM is specified as a trace exit program.

Exemple 3 : Démarrage d'une trace avec surveillance d'une entrée du journal LIC pour y mettre fin Example 3: Start a Trace and Watch for a LIC Log Entry to End the Trace

STRCMNTRC   CFGOBJ(LINE001)  CFGTYPE(*LIN)
            WCHLICLOG(('99??' 9932 MYJOBNAME))
            WCHTIMO(*NOMAX)

Cette commande démarre une trace de communications de la description de ligne LINE001. La trace prendra fin lorsqu'une entrée du journal du code interne sous licence (LIC) dont le code majeur commence par 99 et dont le code mineur est 9932 sera générée sur le système. En outre, les informations du journal LIC doivent contenir le texte "MYJOBNAME". *NOMAX dans le paramètre WCHTIMO indique que la trace sera active jusqu'à ce que l'événement se produise ou que la commande ENDCMNTRC soit émise manuellement. This command starts a communications trace of line description LINE001. The trace will be ended when a Licensed Internal Code (LIC) log entry that has a major code starting with 99 and a minor code of 9932 is generated on the system. Also, the LIC log information should contain the text "MYJOBNAME". *NOMAX on WCHTIMO parameter indicates that the trace will be active until the event occurs or ENDCMNTRC command is issued manually.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF2601: Description de ligne &1 introuvable.
CPF2634: Non autorisé à l'objet &1.
CPF39AA: La trace &1 de type &2 existe déjà Trace &1 type &2 already exists
CPF39AB: Les octets de début ou de fin dépassent la valeur maximale Beginning or ending bytes exceeds maximum value
CPF39AC: Le total des octets de début et de fin dépasse la valeur maximale Total of beginning and ending bytes exceeds maximum value
CPF39AD: &1 de type &2 ne peut pas être tracé &1 type &2 cannot be traced
CPF39A6: La mémoire n'a pas pu être allouée Storage could not be allocated
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
CPF39BD: Description d'interface réseau &1 introuvable Network interface description &1 not found
CPF39BF: Adresse IP distante non valide. Remote IP address not valid.
CPF39B6: La fonction de trace des communications ne peut pas être exécutée Communications trace function cannot be performed
CPF39C0: Description de contrôleur &1 introuvable. Controller description &1 not found.
CPF39C1: Description de contrôleur &1 non valide. Controller description &1 not valid.
CPF39C2: Le nombre d'octets utilisateur à tracer doit être *CALC. Number of user bytes to trace must be *CALC.
CPF39F1: Taille du tampon de trace trop grande. Trace buffer size too large.
CPF39F2: Impossible d'allouer la bibliothèque &1 Cannot allocate library &1
CPF98A2: Vous n'avez pas les droits sur la commande ou l'API &1. Not authorized to &1 command or API.