TRCCNN

La commande Tracer connexion (TRCCNN) permet de tracer les données chiffrées circulant sur des connexions IP (Internet Protocol) version 4 (IPv4) et version 6 (IPv6), TLS (Transport Layer Security) et RDMA (Remote Direct Memory Access). Des types de traces spécifiques sont démarrés et arrêtés à l'aide de cette commande. The Trace Connection (TRCCNN) command allows the tracing of encrypted data flowing over internet protocol (IP) version 4 (IPv4) and version 6 (IPv6), Transport Layer Security (TLS), and Remote Direct Memory Access (RDMA) connections. Specific types of traces are started and stopped by using this command.

TRCCNN utilise la commande Trace interne (TRCINT) pour collecter les enregistrements de trace, qui peuvent être vidés dans un fichier STREAM au format PCAP (Packet Capture) ou envoyés dans un fichier spoule. Lorsque des données TLS sont capturées, seul un fichier spoule peut être créé. TRCCNN uses the Trace Internal (TRCINT) command to collect the trace records, which can be dumped to a stream file in Packet Capture (PCAP) format or sent to a spooled file. When TLS data is captured, only a spooled file can be created.

Vous pouvez également utiliser TRCCNN avec un fichier spoule QPCSMPRT généré directement par TRCINT. TRCCNN peut extraire et mettre en forme les enregistrements de trace relatifs aux connexions IP, TLS et RDMA. Cela vous permet d'utiliser TRCINT pour collecter de nombreux types d'enregistrements de trace, puis TRCCNN pour mettre en forme le sous-ensemble d'enregistrements de trace relatifs aux connexions IP, TLS et RDMA. You can use also use TRCCNN with a QPCSMPRT spooled file generated by using TRCINT directly. TRCCNN can extract and format the IP, TLS and RDMA connection-related trace records. This allows you to use TRCINT to collect many types of trace records and then use TRCCNN to format the subset of trace records related to IP, TLS and RDMA connections.

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.
• 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

Option de trace (SET)

Indique si la trace est démarrée, arrêtée ou terminée. Vous pouvez également choisir de mettre en forme les données d'enregistrements de trace collectées précédemment à l'aide de la commande TRCCNN ou TRCINT (Trace interne). Specifies whether tracing is started, stopped or ended. Also, you can select to format trace record data collected previously using the TRCCNN or TRCINT (Trace Internal) command.

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

*ON

La collecte des enregistrements de trace interne est démarrée pour les types de trace indiqués dans le paramètre TRCTYPE. Si *GEN est indiqué dans le paramètre TRCTBL, le nom de la table de trace est QTRCCNNxxxxxx, où xxxxxx est le numéro du travail en cours. Sinon, le nom de la table de trace est celui indiqué dans le paramètre TRCTBL. The collection of internal trace records is started for the trace types specified in the TRCTYPE parameter. If *GEN is specified in the TRCTBL parameter then the trace table name will be QTRCCNNxxxxxx where xxxxxx is the job number of the current job. Otherwise the trace table name will be the name specified on the TRCTBL parameter.

*OFF

La collecte des enregistrements de trace s'arrête et la table de trace est supprimée. Un fichier STREAM ou un fichier spoule nommé peut être généré, comme indiqué par le paramètre Sortie (OUTPUT). Collection of trace records stops and the trace table is deleted. Either a stream file or a spooled file named can be generated, as indicated by Sortie (OUTPUT) parameter.

*END

La collecte des enregistrements de trace s'arrête et la table de trace est supprimée. Aucune sortie n'est générée. Collection of trace records stops and the trace table is deleted. No output is generated.

*FORMAT

Met en forme les données de trace d'un fichier spoule QPCSMPRT créé par un appel précédent de TRCCNN ou TRCINT. Les données mises en forme sont écrites dans un fichier spoule nommé QSYSPRT. Les données utilisateur du fichier spoule QSYSPRT sont 'TRCCNN'. Utilisez le paramètre TRCTYPE pour indiquer les enregistrements de trace relatifs aux connexions à mettre en forme. Utilisez les paramètres JOB, SPLNBR, JOBSYSNAME et CRTDATE pour identifier le fichier QPCSMPRT à utiliser. Formats trace data in a QPCSMPRT spooled file created by a previous invocation of TRCCNN or TRCINT. The formatted data is written to a spooled file named QSYSPRT. The user data for the QSYSPRT spooled file is 'TRCCNN'. Use the TRCTYPE parameter to specify which connection-related trace records to format. Use the JOB, SPLNBR, JOBSYSNAME and CRTDATE parameters to identify which QPCSMPRT file to use.

Type de trace (TRCTYPE)

Si SET(*ON) est indiqué, identifie les types d'enregistrements de trace dont la collecte doit démarrer. Si SET(*FORMAT) est indiqué, identifie les types d'enregistrements de trace collectés à mettre en forme. If SET(*ON) is specified, identifies the types of trace records to start collecting. If SET(*FORMAT) is specified, identifies the types of collected trace records to format.

*IP

Trace les données IP (Internet Protocol version 4 et version 6). Trace IP (internet protocol version 4 and version 6) data.

*TLS

Trace les données de connexion TLS (Transport Layer Security). Trace TLS (Transport Layer Security) connection data.

*IPV4

Trace les données IPv4 (Internet Protocol version 4). Trace IPv4 (internet protocol version 4) data.

*IPV6

Trace les données IPv6 (Internet Protocol version 6). Trace IPv6 (internet protocol version 6) data.

*RDMA

Trace les données RDMA (Remote Direct Memory Access). Trace RDMA (remote direct memory access) data.

Trace pleine (TRCFULL)

Indique si les enregistrements de trace sont écrits de manière circulaire (les plus anciens enregistrements étant remplacés par les nouveaux) ou si la trace s'arrête lorsque la table de trace est pleine. Specifies whether the trace records wrap (replace the oldest records with new records) or stop tracing when the trace table is full.

*WRAP

Lorsque la table de trace est pleine, la trace reprend au début. Les enregistrements de trace les plus anciens sont écrasés par les nouveaux au fur et à mesure de leur collecte. When the trace table is full, the trace wraps to the beginning. The oldest trace records are written over by new ones as they are collected.

*STOPTRC

La trace s'arrête lorsque la table de trace est pleine d'enregistrements de trace. Tracing is stopped when the trace table is full of trace records.

Nom de la table de trace (TRCTBL)Trace table name (TRCTBL)

Indique la table de trace qui contient les données de trace collectées. Specifies the trace table to hold the collected trace data.

*GEN

Le nom de la table de trace est QTRCCNNxxxxxx, où xxxxxx est le numéro du travail en cours. The trace table name will be QTRCCNNxxxxxx where xxxxxx is the job number of the current job.

nom

Indiquez le nom de la table de trace à utiliser. Si SET(*ON) est indiqué et que le nom indiqué ne correspond à aucune table de trace existante, une nouvelle table de trace portant le nom indiqué est créée. Specify the name of the trace table to be used. If SET(*ON) is specified and the name specified does not match an existing trace table, a new trace table by the specified name will be created.

Taille (SIZE)

Indique la taille de la table de trace. La quantité de mémoire à allouer peut être indiquée en kilooctets (*KB) ou en mégaoctets (*MB). Si la taille est indiquée en kilooctets, la quantité de mémoire allouée à la table est arrondie au mégaoctet supérieur. Les tailles de table valides vont d'un mégaoctet à 258048 mégaoctets. Specifies the size of the trace table. The amount of storage to be allocated can be specified in units of kilobytes (*KB) or megabytes (*MB). If the size is specified in kilobytes, the amount of storage allocated for the table will be rounded up to the nearest megabyte. Valid table size values range from one megabyte to 258048 megabytes.

Remarque : La quantité de mémoire indiquée par ce paramètre est immédiatement allouée à partir du pool de mémoire secondaire du système (ASP 1). Cet espace de stockage n'est pas alloué dynamiquement en fonction des besoins. Il ne sera pas disponible pour le système, sauf pour enregistrer des informations de trace. Avant d'indiquer une valeur élevée pour ce paramètre, l'espace libre de l'ASP système doit être vérifié. Utilisez la commande Gérer état du système (WRKSYSSTS) pour déterminer la quantité d'espace libre disponible dans l'ASP système. Les performances du système peuvent se dégrader si la taille de l'espace libre de l'ASP système est fortement réduite du fait de la valeur indiquée. Remarque :The amount of storage specified by this parameter is immediately allocated from the system auxiliary storage pool (ASP 1). This storage space is not dynamically allocated as it is needed. This storage space will not be available for use by the system except to record trace-related information. Before specifying a large value on this parameter, the amount of free space in the system ASP should be checked. Use the Work with System Status (WRKSYSSTS) command to determine the amount of available free space in the system ASP. System performance degradation may result if the size of the free space in the system ASP is significantly reduced as a result of the value specified.

Remarque : Si les données tracées transitent par une ligne Ethernet gigabit, la taille de la table de trace doit être supérieure à 128000 kilooctets ou 128 mégaoctets. Remarque :If tracing data over a gigabit Ethernet line the trace table size should be greater than 128000 kilobytes or 128 megabytes.

Valeurs uniques

*MAX

La table de trace est définie à sa taille maximale de 258048 mégaoctets. The trace table is set to the maximum size of 258048 megabytes.

*MIN

La table de trace est définie à sa taille minimale d'un mégaoctet. The trace table is set to the minimum size of one megabyte.

Élément 1: Nombre d'unités

16000

La taille de la table de trace est de 16000 kilooctets ou de 16000 mégaoctets, selon la valeur indiquée pour le deuxième élément de ce paramètre. The trace table size is either 16000 kilobytes or 16000 megabytes, depending on the value specified for the second element of this parameter.

1-998000

Indiquez la taille de la table de trace en kilooctets ou en mégaoctets. Specify the size of the trace table in kilobytes or megabytes.

Élément 2: Unit of measure

Indique si la valeur indiquée pour le premier élément doit être traitée comme un nombre de kilooctets ou de mégaoctets. Specifies whether the value specified for the first element should be treated as number of kilobytes or number of megabytes.

*KB

La taille de la table de trace est indiquée en kilooctets. The trace table size is specified in kilobytes.

*MB

La taille de la table de trace est indiquée en mégaoctets. The trace table size is specified in megabytes.

Sortie (OUTPUT)

Indique le fichier de sortie qui sera généré à partir des informations tracées. Specifies the output file that will be generated from the traced information.

*PRINT

Un fichier spoule nommé QSYSPRT est généré par la mise en forme de QPCSMPRT, lui-même généré par la commande TRCINT. Les données utilisateur du fichier spoule QSYSPRT sont 'TRCCNN'. A spooled file named QSYSPRT is generated by formatting QPCSMPRT, which is generated by the TRCINT command. The user data for the QSYSPRT spooled file is 'TRCCNN'.

*STMF

Vide les données tracées au format PCAP (Packet Capture) dans le fichier STREAM indiqué dans le paramètre Options de fichier STREAM (TOSTMF). Le format PCAP est utilisé par les analyseurs de protocoles réseau d'autres systèmes d'exploitation, tels que Linux et AIX. Un fichier STREAM ne peut être créé qu'avec des données de trace autres que TLS. Dumps the traced data in Packet Capture (PCAP) format to the stream file specified in the Stream file options (TOSTMF) parameter. PCAP format is used by network protocol analyzers in other operating systems, such as Linux and AIX. A stream file can only be created with trace data different than TLS.

Données de trace à mettre en forme (FMTDTA)Trace data to be formatted (FMTDTA)

Indique le nombre d'octets de données tracées à mettre en forme. Specifies the number of bytes of traced data to be formatted.

*CALC

Le système détermine le nombre d'octets de données à mettre en forme. The system determines the number of bytes of data to be formatted.

72-99999

Indiquez le nombre d'octets de données à mettre en forme. Specify the number of bytes of data to be formatted.

Identificateur de jeu de caractères codés (CCSID)Coded character set identifier (CCSID)

Indique si le code de caractères EBCDIC (extended binary-coded decimal interchange code, *EBCDIC- 37), ASCII (American National Standard Code for Information Interchange, *ASCII- 819) ou tout autre est utilisé pour la sortie mise en forme. Specifies whether the extended binary-coded decimal interchange code (*EBCDIC- 37) or the American National Standard Code for Information Interchange (*ASCII- 819) character code or any other is used for the formated output.

*EBCDIC

Le code de caractères EBCDIC (37) est utilisé. The EBCDIC (37) character code is used.

*ASCII

Le code de caractères ASCII (819) est utilisé. The ASCII (819) character code is used.

1-65533

Indiquez la valeur d'identificateur de jeu de caractères codés (CCSID) à utiliser lors de la mise en forme des données de trace. Specify the coded character set identifier (CCSID) value to be used when formatting the trace data.

Travail (JOB)

Indique le nom ou le nom qualifié du travail qui a créé le fichier spoule QPCSMPRT en entrée (paramètre SPLNBR). Ce paramètre n'est valide que si SET(*FORMAT) est indiqué. Specifies the name or qualified name of the job that created the input QPCSMPRT spooled file (SPLNBR parameter). This parameter is valid only if SET(*FORMAT) is specified.

Valeurs uniques

*

Le travail qui a émis cette commande est le travail qui a créé le fichier spoule QPCSMPRT en entrée. The job that issued this command is the job that created the input QPCSMPRT spooled file.

Qualificatif 1: Travail

nom

Indiquez le nom du travail qui a créé le fichier spoule QPCSMPRT en entrée. Specify the name of the job that created the input QPCSMPRT spooled file.

Qualificatif 2: Utilisat

nom

Indiquez le nom d'utilisateur qui identifie le profil utilisateur sous lequel s'est exécuté le travail qui a créé le fichier spoule QPCSMPRT en entrée. Specify the user name that identifies the user profile under which the job was run that created the input QPCSMPRT spooled file.

Qualificatif 3: Numéro

000000-999999

Indiquez le numéro de travail attribué par le système au travail qui a créé le fichier spoule QPCSMPRT en entrée. Specify the system-assigned job number of the job that created the input QPCSMPRT spooled file.

Numéro de fichier spoule (SPLNBR)

Indique le numéro de fichier du fichier spoule QPCSMPRT du travail (paramètre JOB) qui a créé le fichier spoule. Ce paramètre n'est valide que si SET(*FORMAT) est indiqué. Specifies the file number of the QPCSMPRT spooled file from the job (JOB parameter) that created the spooled file. This parameter is valid only if SET(*FORMAT) is specified.

*LAST

Le fichier spoule nommé QPCSMPR portant le numéro le plus élevé créé par le travail indiqué est utilisé. The highest-numbered spooled file named QPCSMPR created by the specified job is used.

*ONLY

Un seul fichier spoule nommé QPCSMPRT a été créé par le travail indiqué ; le numéro du fichier spoule n'est donc pas nécessaire. Si *ONLY est indiqué et que plusieurs fichiers spoule du travail indiqué se nomment QPCSMPRT, un message d'erreur est émis. Only one spooled file named QPCSMPRT was created by the specified job; therefore, the number of the spooled file is not necessary. If *ONLY is specified and more than one spooled file for the specified job is named QPCSMPRT, an error message is issued.

1-999999

Indiquez le numéro du fichier spoule QPCSMPRT créé par le travail indiqué. Specify the number of the QPCSMPRT spooled file created by the specified job.

Nom de système de travail (JOBSYSNAME)

Indique le nom du système sur lequel le travail qui a créé le fichier spoule (paramètre JOB) s'est exécuté. Ce paramètre est pris en compte une fois satisfaites les exigences des paramètres nom de travail, nom d'utilisateur, numéro de travail, nom du fichier spoule et numéro du fichier spoule. Specifies the name of the system where the job that created the spooled file (JOB parameter) ran. This parameter is considered after the job name, user name, job number, spooled file name and spooled file number parameter requirements have been met.

*ONLY

Il n'existe qu'un seul fichier spoule portant le nom de travail, le nom d'utilisateur, le numéro de travail, le nom de fichier spoule, le numéro de fichier spoule et la date et l'heure de création du fichier spoule indiqués. There is only one spooled file with the specified job name, user name, job number, spooled file name, spooled file number and spooled file creation date and time.

*CURRENT

Le fichier spoule créé sur le système en cours avec le nom de travail, le nom d'utilisateur, le numéro de travail, le nom de fichier spoule, le numéro de fichier spoule et la date et l'heure de création indiqués est utilisé. The spooled file created on the current system with the specified job name, user name, job number, spooled file name, spooled file number and creation date and time is used.

*ANY

Le nom de système du travail n'est pas utilisé pour déterminer le fichier spoule à utiliser. Utilisez cette valeur lorsque le paramètre de date et d'heure de création du fichier spoule doit avoir priorité sur le nom de système du travail lors de la sélection d'un fichier spoule. The job system name is not used to determine which spooled file is used. Use this value when the spooled file creation date and time parameter is to take precedence over the job system name when selecting a spooled file.

nom

Indiquez le nom du système sur lequel s'est exécuté le travail qui a créé le fichier spoule. Specify the name of the system where the job that created the spooled file ran.

Fichier spoule créé (CRTDATE)

Indique la date et l'heure de création du fichier spoule. Ce paramètre est pris en compte une fois satisfaites les exigences des paramètres nom de travail, nom d'utilisateur, numéro de travail, nom du fichier spoule, numéro du fichier spoule et nom de système du travail. Specifies the date and time the spooled file was created. This parameter is considered after the job name, user name, job number, spooled file name, spooled file number and job system name parameter requirements have been met.

Valeurs uniques

*ONLY

Il n'existe qu'un seul fichier spoule portant le nom de travail, le nom d'utilisateur, le numéro de travail, le nom de fichier spoule, le numéro de fichier spoule et le nom de système du travail indiqués. There is only one spooled file with the specified job name, user name, job number, spooled file name, spooled file number and job system name.

*LAST

Le fichier spoule ayant les date et heure de création les plus récentes parmi ceux portant le nom de travail, le nom d'utilisateur, le numéro de travail, le nom de fichier spoule, le numéro de fichier spoule et le nom de système du travail indiqués est utilisé. The spooled file with the latest creation date and time of the specified job name, user name, job number, spooled file name, spooled file number and job system name is used.

Élément 1: Date de création

date

Indiquez la date de création du fichier spoule. Specify the date the spooled file was created.

Élément 2: Heure de création

*ONLY

Il n'existe qu'un seul fichier spoule portant le nom de travail, le nom d'utilisateur, le numéro de travail, le nom de fichier spoule, le numéro de fichier spoule, le nom de système du travail et la date de création du fichier spoule indiqués. There is only one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, job system name, and spooled file creation date.

*LAST

Le fichier spoule ayant l'heure de création la plus récente parmi ceux portant le nom de travail, le nom d'utilisateur, le numéro de travail, le nom de fichier spoule, le numéro de fichier spoule, le nom de système du travail et la date de création du fichier spoule indiqués est utilisé. The spooled file with the latest creation time of the specified job name, user name, job number, spooled file name, spooled file number,job system name, and spooled file creation date is used.

time

Indiquez l'heure de création du fichier spoule. Specify the time the spooled file was created.

Données TCP/IP (TCPDTA)TCP/IP data (TCPDTA)

Indique si un sous-ensemble des données de trace TCP/IP, TLS ou RDMA doit être collecté. Chaque élément du paramètre est facultatif ; si aucune valeur n'est indiquée pour un élément, aucun filtrage des données de trace n'est effectué pour cet élément. Par exemple, si *TCP est indiqué pour l'élément 1, seuls les enregistrements de trace dans lesquels le protocole TCP est utilisé sont collectés. Si aucune valeur n'est indiquée pour l'élément 1, les enregistrements de trace utilisant tous les protocoles sont collectés. Specifies whether a subset of TCP/IP, TLS or RDMA trace data should be collected. Each parameter element is optional; if no element value is specified, no filtering of trace data is done for that element. For example, if *TCP is specified for element 1, only trace records where the TCP protocol is used are collected. If no value is specified for element 1, trace records using all protocols are collected.

Élément 1: Protocol

Indiquez un protocole TCP/IP à tracer. Specify a TCP/IP protocol to be traced.

Remarque : Cet élément n'est pas utilisé lorsque TRCTYPE est *RDMA. Remarque :This element is not used when TRCTYPE is *RDMA.

*TCP

Active la trace pour le protocole TCP (Transmission Control Protocol). Enable trace for transmission control protocol.

*UDP

Active la trace pour le protocole UDP (User Datagram Protocol). Enable trace for user datagram protocol.

*ICMP

Active la trace pour le protocole ICMP (Internet Control Message Protocol). Enable trace for internet control message protocol.

*IGMP

Active la trace pour le protocole IGMP (Internet Group Management Protocol) Enable trace for internet group management protocol

*ICMP6

Active la trace pour le protocole ICMP version 6 (Internet Control Message Protocol version 6). Enable trace for internet control message protocol version 6.

Élément 2: Local port

1-65535

Indiquez un ou deux numéros de port local pour lesquels les données de trace sont collectées. Specify one or two local port numbers for which trace data is collected.

Élément 3: Remote port

1-65535

Indiquez un ou deux numéros de port distant pour lesquels les données de trace sont collectées Specify one or two remote port numbers for which trace data is collected

Élément 4: Local IP address

valeur-caractère

Indiquez une adresse IP (Internet Protocol) locale. Specify a local internet protocol address.

Élément 5: Remote IP address

valeur-caractère

Indiquez une adresse IP (Internet Protocol) distante. Specify a remote internet protocol address.

Élément 6: Description de ligne

Remarque : Cet élément n'est pas utilisé lorsque TRCTYPE est *TLS. Remarque :This element is not used when TRCTYPE is *TLS.

nom

Indiquez le nom d'une description de ligne pour laquelle les données de trace doivent être collectées. Specify the name of a line description for which the trace data is to be collected.

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

Indiquez la partie de l'entrée PAL avec laquelle les données de comparaison indiquées pour l'élément 2 doivent être comparées. Specify which part of the PAL entry the comparison data specified for element 2 is to be compared 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/

Options de fichier STREAM (TOSTMF)Stream file options (TOSTMF)

Indique le fichier STREAM dans lequel les données sont copiées et si le fichier doit être remplacé s'il existe. Specifies the stream file to which data is copied and whether the file should be replaced if it exists.

Élément 1: Stream file

chemin-d'accès

Indiquez le chemin d'accès du fichier STREAM à utiliser. Tous les répertoires du chemin d'accès doivent exister. Les nouveaux répertoires ne sont pas créés. Specify the path name for the stream file to be used. All directories in the path name must exist. New directories are not created.

Élément 2: Remplacer fichier

*NO

Aucun enregistrement n'est copié et un message d'erreur est signalé si le fichier existe déjà. No records are copied and an error message is signaled if the file already exists.

*YES

Les enregistrements de données de trace remplacent les enregistrements du fichier STREAM existant. The trace data records replace the existing stream file records.

Exemples

Exemple 1 : Démarrer des traces TLS Example 1: Starting TLS Traces

TRCCNN   SET(*ON)  TRCTYPE(*TLS)

Cette commande démarre la trace des connexions TLS (Transport Layer Security). This command starts tracing for Transport Layer Security (TLS) connections.

Exemple 2 : Démarrer des traces IP Example 2: Starting IP Traces

TRCCNN   SET(*ON)  TRCTYPE(*IP)

Cette commande démarre la trace des connexions au niveau IP (Internet Protocol) version 4 (IPv4) et version 6 (IPv6). This command starts tracing for connections at the internet protocol (IP) version 4 (IPv4) and version 6 (IPv6) level.

Exemple 3 : Arrêter les traces et libérer la mémoire de trace Example 3: Stopping Traces and Clearing Trace Storage

TRCCNN   SET(*END)

Cette commande arrête toutes les traces et supprime la table de trace. Aucune sortie spoule n'est générée. This command stops all traces and deletes the trace table. No spooled output is generated.

Exemple 4 : Imprimer les traces Example 4: Printing Traces

TRCCNN   SET(*OFF)

Cette commande arrête toutes les traces et génère un fichier spoule (QPCSMTRC) qui contient les enregistrements de trace collectés par la commande TRCINT (Trace interne), ainsi qu'un fichier spoule (QSYSPRT) qui contient les données de trace mises en forme. This command stops all traces and generates a spooled file (QPCSMTRC) that contains the trace records collected by the TRCINT (Trace Internal) command, and a spooled file (QSYSPRT) that contains the formatted trace data.

Exemple 5 : Mettre en forme les données de trace de la commande TRCINT Example 5: Formatting Trace Data from TRCINT Command

TRCINT   SET(*ON)  TRCTYPE(*SCK)
TRCINT   SET(*OFF)
TRCCNN   SET(*FORMAT)  TRCTYPE(*TLS)  JOB(*)  SPLNBR(*LAST)

Les commandes TRCINT (Trace interne) servent à démarrer la collecte des enregistrements de trace relatifs à toute l'utilisation des sockets, puis à arrêter la collecte des enregistrements de trace et à créer un fichier spoule nommé QPCSMPRT. La commande TRCCNN utilise les informations de trace du dernier fichier spoule nommé QPCSMPRT du travail en cours et met en forme les enregistrements de trace relatifs à TLS (Transport Layer Security) dans un fichier spoule nommé QSYSPRT. The TRCINT (Trace Internal) commands are used to start collecting trace records related to all usage of sockets, and to stop collecting trace records and create a spooled file named QPCSMPRT. The TRCCNN command will use the trace information in the last spooled file named QPCSMPRT for the current job, and format the trace records related to TLS (Transport Layer Security) in a spooled file named QSYSPRT.

Exemple 6 : Indiquer une table de trace Example 6: Specifying a Trace Table

TRCCNN   SET(*ON)  TRCTYPE(*IP)  TRCTBL(USER)

Cette commande démarre la trace des connexions au niveau IP (Internet Protocol) version 4 (IPv4) et version 6 (IPv6) et stocke les données de trace dans la table de trace USER. This command starts tracing for connections at the internet protocol (IP) version 4 (IPv4) and version 6 (IPv6) level and stores the trace data in the USER trace table.

Exemple 7 : Indiquer une taille de table de trace en mégaoctets Example 7: Specifying a Trace Table Size in Megabytes

TRCCNN   SET(*ON)  TRCTYPE(*IPV6)  SIZE(20000 *MB)

Cette commande démarre la trace des connexions au niveau IP (Internet Protocol) version 6 (IPv6) et stocke les données dans une table de trace de 20000 mégaoctets. This command starts tracing for connections at the internet protocol version 6 (IPv6) level and stores the data in a 20000-megabyte trace table.

Exemple 8 : Indiquer un CCSID pour les données de trace Example 8: Specifying a CCSID for Trace Data

TRCCNN   SET(*OFF)  CCSID(*ASCII)

Cette commande arrête toutes les traces et génère un fichier spoule (QSYSPRT). Le CCSID ASCII (819) est utilisé pour la mise en forme des données de trace. This command stops all traces and generates a spooled file (QSYSPRT). ASCII (819) CCSID will be used when formatting the trace data.

Exemple 9 : Démarrer une trace et surveiller un message pour l'arrêter Example 9: Start a Trace and Watch for a Message to End the Trace

TRCCNN   SET(*ON) TRCTYPE(*IPV4)  WCHMSG((MCH2804))
         WCHMSGQ((*SYSOPR) (*JOBLOG))
         WCHJOB((*ALL/MYUSER/MYJOBNAME))
         TRCPGM(MYLIB/TRCEXTPGM)

Cette commande démarre la trace des connexions au niveau IP (Internet Protocol) version 4 (IPv4). La trace sera arrêtée 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. De plus, MYLIB/TRCEXTPGM est indiqué comme programme d'exit de trace. This command starts tracing for connections at the internet protocol version 4 (IPv4) level. 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 10 : Démarrer une trace et surveiller une entrée du journal LIC pour l'arrêter Example 10: Start a Trace and Watch for a LIC Log Entry to End the Trace

TRCCNN   SET(*ON) TRCTYPE(*IPV4)
         WCHLICLOG(('99??' 9932 MYJOBNAME))
         WCHTIMO(*NOMAX)

Cette commande démarre la trace des connexions au niveau IP (Internet Protocol) version 4 (IPv4). La trace sera arrêtée lorsqu'une entrée du journal du code interne sous licence (LIC) dont le code majeur commence par 99 et le code mineur est 9932 sera générée sur le système. De plus, les informations du journal LIC doivent contenir le texte "MYJOBNAME". *NOMAX pour le paramètre WCHTIMO indique que la trace reste active jusqu'à ce que l'événement se produise ou que la commande TRCCNN soit émise manuellement pour arrêter la trace. This command starts tracing for connections at the internet protocol version 4 (IPv4) level. 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 TRCCNN command is issued manually to end the trace.

Exemple 11 : Envoyer la trace dans un fichier STREAM Example 11: Sending the Trace to a Stream File

TRCCNN   SET(*OFF) OUTPUT(*STMF)
         TOSTMF('/user/Test.stmf' *YES)

Cette commande arrête toutes les traces et vide les informations dans le fichier STREAM /user/Test.stmf au format PCAP. Si le fichier STREAM existe, il est remplacé. Notez que les données TLS ne peuvent pas être vidées dans un fichier STREAM au format PCAP. This command stops all traces and dumps the information to stream file /user/Test.stmf in PCAP format. If the stream file exists, it will be replaced. Please note that TLS data cannot be dumped to a stream file in PCAP format.

Exemple 12 : Démarrer une trace RDMA pour une description de ligne spécifique Example 12: Starting RDMA Trace for a specific line description

TRCCNN SET(*ON) TRCTYPE(*RDMA)
       TCPDTA(*N () () *N *N LINERDMA1)

Cette commande démarre la trace RDMA (Remote Direct Memory Access) et sélectionne uniquement la trace des données de tous les protocoles, de tous les ports et de toutes les adresses IP sur la description de ligne LINERDMA1. This command starts tracing for remote direct memory access (RDMA) and only select to trace data for all protocols, all ports and all IP addresses on line description of LINERDMA1.

Messages d'erreur