PRTCMNTRC

La commande Imprimer la trace des communications (PRTCMNTRC) transfère les données de trace des communications de la ligne, de la description d'interface réseau ou de la description de serveur de réseau indiquée vers un fichier spoule ou un fichier de sortie. The Print Communications Trace (PRTCMNTRC) command transfers the communications trace data for the specified line, network interface description, or network server description to a spooled file or an output file.

La commande PRTCMNTRC peut également servir à mettre en forme des données de trace des communications précédemment vidées dans un fichier STREAM à l'aide de la commande Vider la trace des communications (DMPCMNTRC). The PRTCMNTRC command can also be used to format communications trace data that was previously dumped to a stream file using the Dump Communications Trace (DMPCMNTRC) command.

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.
• 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 Modification de l'utilisation d'une fonction (CHGFCNUSG), avec l'ID de fonction QIBM_SERVICE_TRACE, permet également de modifier la liste des utilisateurs autorisés à effectuer des opérations de trace. 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.
• Les données de trace des traces de description de serveur de réseau ne peuvent être transférées que vers un fichier spoule. Les données de trace ne peuvent pas être transférées vers un fichier de sortie. Aucune option de mise en forme n'est disponible. The trace data for network server description traces can only be transferred to a spooled file. The trace data cannot be transferred to an output file. There are no formatting options available.

Paramètres

Objet de configuration (CFGOBJ)Configuration object (CFGOBJ)

Indique l'objet de configuration tracé. L'objet doit être une description de ligne, une description d'interface réseau ou une description de serveur de réseau. Specifies the configuration object being traced. The object must be a line description, a network interface description, or a network server description.

Les paramètres CFGOBJ et CFGTYPE, ou le paramètre FROMSTMF, doivent être indiqués. Either the CFGOBJ and CFGTYPE parameters or the FROMSTMF parameter must be specified.

nom

Indiquez le nom de l'objet de description de configuration. Specify the name of the configuration description object.

Fichier STREAM d'origine (FROMSTMF)

Indique le chemin d'accès du fichier STREAM à partir duquel les données de trace des communications sont mises en forme. Ce fichier doit avoir été créé en exécutant la commande CL Vider la trace des communications (DMPCMNTRC). Les paramètres CFGOBJ et CFGTYPE, ou le paramètre FROMSTMF, doivent être indiqués. Specifies the path name of the stream file from which communications trace data is formatted. This file must have been created by running the Dump Communications Trace (DMPCMNTRC) CL command. Either the CFGOBJ and CFGTYPE parameters or the FROMSTMF parameter must be specified.

chemin-d'accès

Indiquez le chemin d'accès du fichier STREAM créé par la commande DMPCMNTRC. Specify the path name of the stream file created by the DMPCMNTRC command.

Type (CFGTYPE)

Indique le type de description de configuration qui a été tracé. Specifies the type of configuration description that was traced.

Les paramètres CFGOBJ et CFGTYPE, ou le paramètre FROMSTMF, doivent être indiqués. Either the CFGOBJ and CFGTYPE parameters or the FROMSTMF parameter must be specified.

*LIN

Le type d'objet de configuration est une description de ligne. The type of configuration object is a line description.

*NWI

Le type d'objet de configuration est une description d'interface réseau. The type of configuration object is a network interface description.

*NWS

Le type d'objet de configuration est une description de serveur réseau. The type of configuration object is a network server description.

Sortie (OUTPUT)

Indique si la sortie de la commande est imprimée avec la sortie spoule du travail ou envoyée vers un fichier de base de données. Specifies whether the output from the command is printed with the job's spooled output or sent to a database file.

Remarque :Pour les traces de description de serveur de réseau, *PRINT doit être indiqué pour ce paramètre. Remarque :For network server description traces, *PRINT must be specified for this parameter.

*PRINT

La sortie est imprimée avec la sortie spoule du travail. The output is printed with the job's spooled output.

*OUTFILE

La sortie est dirigée vers le fichier de base de données indiqué pour le paramètre Fichier devant recevoir la sortie (OUTFILE). The output is directed to the database file specified for the File to receive output (OUTFILE) parameter.

Fichier recevant la sortie (OUTFILE)

Indique le fichier de base de données vers lequel la sortie de la commande est dirigée. Si le fichier n'existe pas, cette commande crée un fichier de base de données dans la bibliothèque indiquée. Si le fichier est créé, les droits publics sur le fichier sont identiques aux droits de création indiqués pour la bibliothèque dans laquelle le fichier est créé. Utilisez la commande Afficher la description de bibliothèque (DSPLIBD) pour afficher les droits de création de la bibliothèque. Specifies the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library. If the file is created, the public authority for the file is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority.

Qualificatif 1: Fichier devant recevoir la sortie Qualificatif 1: File to receive output

nom

Indiquez le nom du fichier de base de données vers lequel la sortie de la commande est dirigée. Specify the name of the database file to which the command output is directed.

Qualificatif 2 : Bibliothèque Qualificatif 2: Library

*LIBL

La liste de bibliothèques est utilisée pour localiser le fichier. Si le fichier est introuvable, un fichier est créé dans la bibliothèque en cours. S'il n'existe pas de bibliothèque en cours, le fichier est créé dans la bibliothèque QGPL. The library list is used to locate the file. If the file is not found, one is created in the current library. If no current library exists, the file will be created in the QGPL library.

*CURLIB

La bibliothèque en cours de l'unité d'exécution est utilisée pour localiser le fichier. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours de l'unité d'exécution, la bibliothèque QGPL est utilisée. The current library for the thread is used to locate the file. If no library is specified as the current library for the thread, the QGPL library is used.

nom

Indiquez le nom de la bibliothèque à rechercher. Specify the name of the library to be searched.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre de fichier de base de données vers lequel la sortie est dirigée lorsque *OUTFILE est indiqué pour le paramètre Sortie (OUTPUT). Specifies the name of the database file member to which the output is directed when *OUTFILE is specified for the Output (OUTPUT) parameter.

Élément 1: Member to receive output

*FIRST

Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et que le membre n'existe pas, le système crée un membre portant le nom du fichier indiqué pour le paramètre Fichier devant recevoir la sortie (OUTFILE). The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the File to receive output (OUTFILE) parameter.

nom

Specify the name of the file member that receives the output. If OUTMBR(member-name) is specified and the member does not exist, the system creates it.

Si le membre existe, vous pouvez ajouter des enregistrements à la fin du membre existant ou effacer le membre existant et y ajouter les enregistrements. If the member exists, you can add records to the end of the existing member or clear the existing member and add the records.

Élément 2: Replace or add records

*REPLACE

Les enregistrements existants du membre de fichier de base de données indiqué sont remplacés par les nouveaux enregistrements. The existing records in the specified database file member are replaced by the new records.

*ADD

Les nouveaux enregistrements sont ajoutés aux informations existantes du membre de fichier de base de données indiqué. The new records are added to the existing information in the specified database file member.

Code caractères (CODE)

Indique si le code de caractères *EBCDIC (extended binary-coded decimal interchange code) ou *ASCII (American National Standard Code for Information Interchange) est utilisé sur la ligne. Specifies whether the extended binary-coded decimal interchange code (*EBCDIC) or the American National Standard Code for Information Interchange (*ASCII) character code is used on the line.

*CALC

Le système détermine s'il faut mettre en forme les données utilisateur en EBCDIC ou en ASCII, selon le type de contrôleur utilisé. The system determines whether to format the user data in EBCDIC or ASCII, based on the type of controller that is used.

*ASCII

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

*EBCDIC

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

Description de ligne (SLTLIND)

Indique s'il faut mettre en forme les données de toutes les lignes ou d'une ligne précise communiquant sur le réseau pendant une trace. Specifies whether to format data for all lines or a specific line communicating on the network during a trace.

*ALL

Met en forme les données de toutes les lignes. Formats the data for all lines.

nom

Indiquez le nom de la ligne dont les données de trace sont mises en forme. Specify the name of the line for which trace data is formatted.

Description de contrôleur (SLTCTLD)

Indique s'il faut mettre en forme les données de tous les contrôleurs ou d'un contrôleur précis communiquant sur le réseau pendant une trace. Specifies whether to format data for all controllers or a specific controller communicating on the network during a trace.

*ALL

Met en forme les données de tous les contrôleurs. Formats data for all controllers.

controller-name

Indiquez le nom du contrôleur dont les données de trace sont mises en forme. Specify the name of the controller for which trace data is formatted.

Mettre en forme uniquement les données SNA (FMTSNA)Format SNA data only (FMTSNA)

Indique s'il faut mettre en forme les données de protocole de ligne ou les données SNA (Systems Network Architecture). Les données de protocole de ligne comprennent SDLC, X.25, CSMA/CD (Carrier Sense Multiple Access with Collision Detection), Ethernet DIX V2, DDI, sans fil et IBM Token-Ring Network (TRLAN). Specifies whether line protocol data or Systems Network Architecture (SNA) data is formatted. Line protocol data includes SDLC, X.25, Carrier Sense Multiple Access with Collision Detection (CSMA/CD), Ethernet DIX V2, DDI, wireless, and IBM Token-Ring Network (TRLAN).

*NO

Seules les données de protocole de ligne sont mises en forme. Only line protocol data is formatted.

*YES

Seules les données SNA sont mises en forme. Only SNA data is formatted.

Mettre en forme les commandes RR, RNR (FMTRR)Format RR, RNR commands (FMTRR)

Indique si les commandes récepteur prêt (RR) et récepteur non prêt (RNR) sont mises en forme avec les autres données. Specifies whether receiver ready (RR) and receiver not ready (RNR) commands are formatted with other data.

*NO

Les commandes RR et RNR ne sont pas mises en forme avec les autres données. RR and RNR commands are not formatted with other data.

*YES

Les commandes RR et RNR sont mises en forme avec les autres données. RR and RNR commands are formatted with other data.

Mettre en forme les données TCP/IP (FMTTCP)Format TCP/IP data (FMTTCP)

Indique s'il faut mettre en forme les données de protocole de ligne ou les données TCP/IP (Transmission Control Protocol/Internet Protocol). Specifies whether line protocol data or Transmission Control Protocol/Internet Protocol (TCP/IP) data is formatted.

Remarque :Si les données de trace sont mises en forme à partir d'un fichier STREAM (paramètre FROMSTMF), ce paramètre est ignoré et les données TCP/IP sont mises en forme. Remarque :If the trace data is being formatted from a stream file (FROMSTMF parameter), this parameter is ignored and TCP/IP data is formatted.

*LINTYPE

Pour les lignes X.25, Ethernet, DDI, sans fil, Token-Ring et Frame Relay, seules les données de protocole de ligne sont mises en forme. Pour toutes les autres lignes prenant en charge TCP/IP, les données TCP/IP sont mises en forme. For X.25, Ethernet, DDI, wireless, Token-Ring, and Frame Relay lines, only line protocol data is formatted. For all other lines supporting TCP/IP, TCP/IP data is formatted.

*YES

Les données TCP/IP sont mises en forme. TCP/IP data is formatted.

*NO

Les données TCP/IP ne sont pas mises en forme. TCP/IP data is not formatted.

Mettre en forme les données LCP (FMTLCP)Format LCP data (FMTLCP)

Indique si les données LCP (Link Control Protocol) sont incluses dans la trace des communications mise en forme. Specifies whether Link Control Protocol (LCP) data is included in the formatted communications trace.

Remarque :Si FMTLCP, FMTNCP et FMTTCP ont tous pour valeur *NO lors de la mise en forme de données d'une ligne PPP (Point-to-Point Protocol), les données asynchrones et non reconnues seront placées dans le fichier spoule. C'est également le cas si tous ont pour valeur *YES (ou *LINTYPE pour FMTTCP). Dans tous les autres cas, les données asynchrones et non reconnues seront omises. Remarque :If FMTLCP, FMTNCP, and FMTTCP are all specified *NO when formatting data for a Point-to-Point Protocol (PPP) line, then asynchronous and unrecognized data will be placed in the spooled file. This is also the case if all are specified *YES (or *LINTYPE for FMTTCP). In all other cases asynchronous and unrecognized data will be omitted.

*YES

Les données LCP sont mises en forme. LCP data is formatted.

*NO

Les données LCP ne sont pas mises en forme. LCP data is not formatted.

Mettre en forme les données NCP (FMTNCP)Format NCP data (FMTNCP)

Indique si les données NCP (Network Control Protocol) sont incluses dans la trace des communications mise en forme. Specifies whether Network Control Protocol (NCP) data is included in the formatted communications trace.

*YES

Les données NCP sont mises en forme. NCP data is formatted.

*NO

Les données NCP ne sont pas mises en forme. NCP data is not formatted.

Mettre en forme les données TCP/IP par adresse (TCPIPADR)Format TCP/IP data by address (TCPIPADR)

Indique une paire d'adresses Internet pour laquelle les données TCP/IP sont mises en forme. Toute valeur valide pour l'adresse IP 1 l'est également pour l'adresse IP 2. Specifies an internet address pair for which TCP/IP data is formatted. Any values that are valid for IP address 1 are also valid for IP address 2.

L'adresse Internet est indiquée sous la forme nnn.nnn.nnn.nnn, où nnn est un nombre décimal compris entre 0 et 255. Une adresse Internet n'est pas valide si la partie identificateur de réseau ou la partie identificateur d'hôte de l'adresse a pour valeur uniquement des uns binaires ou uniquement des zéros binaires. The internet address is specified in the form, nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the address.

Pour les adresses IPv6 (IP version 6), la forme est xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx, où x est un chiffre hexadécimal valide de 0 à F. For IPv6 (IP version 6) addresses, the form is xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx, where x is any valid hexadecimal digit 0 through F.

Remarque :Les adresses IPv6 ne sont valides que lors de la mise en forme de données de trace à partir d'un fichier STREAM. Remarque :IPv6 addresses are only valid when formatting trace data from a stream file.

Élément 1: Source/destination IP address

*ALL

Les communications entre les systèmes indiqués pour l'élément 2 et tous les autres systèmes sont imprimées. The communications between the systems specified for element 2 and all other systems are printed.

valeur-caractère

Indiquez l'adresse du système pour lequel les communications entre ce système et les systèmes indiqués pour l'élément 2 sont imprimées. Specify the address of the system for which communications between this system and the systems specified for element 2 are printed.

Élément 2: Source/destination IP address

*ALL

Les communications entre les systèmes indiqués pour l'élément 1 et tous les autres systèmes sont imprimées. The communications between the systems specified for element 1 and all other systems are printed.

valeur-caractère

Indiquez l'adresse du système pour lequel les communications entre ce système et les systèmes indiqués pour l'élément 1 sont imprimées. Specify the address of the system for which communications between this system and the systems specified for element 1 are printed.

Numéro de port IP (SLTPORT)IP port number (SLTPORT)

Indique s'il faut mettre en forme les données de tous les ports IP (protocole Internet) ou d'un seul port IP. Specifies whether data for all internet protocol (IP) ports or only a single IP port is formatted.

Remarque :Ce paramètre n'est valide que si FMTTCP(*YES) est indiqué. Remarque :This parameter is valid only if FMTTCP(*YES) is specified.

*ALL

Les données de tous les ports IP sont mises en forme. Data for all IP ports is formatted.

decimal-number

Indiquez le numéro de port IP (1 à 65535) dont les données doivent être mises en forme. Specify the IP port number (1 to 65535) whose data is to be formatted.

Mettre en forme uniquement les données UI (FMTUI)Format UI data only (FMTUI)

Indique s'il faut mettre en forme les données de protocole de ligne ou les données UI (unnumbered information). Specifies whether line protocol data or unnumbered information (UI) data is formatted.

*NO

Toutes les données de protocole de ligne sont mises en forme. All line protocol data is formatted.

*YES

Seules les données UI sont mises en forme. Only UI data is formatted.

Mettre en forme uniquement les données MAC ou SMT (FMTMAC)Format MAC or SMT data only (FMTMAC)

Indique s'il faut mettre en forme les données de protocole de ligne ou les données MAC (medium access control) ou SMT (Station Management). Specifies whether line protocol data or medium access control (MAC) or Station Management (SMT) data is formatted.

*NO

Les données de protocole de ligne (TRLAN ou Ethernet) sont mises en forme. The line protocol data (TRLAN or Ethernet) is formatted.

*YES

Seules les données MAC ou SMT sont mises en forme. Only MAC or SMT data is formatted.

Mettre en forme uniquement les données Ethernet (FMTETH)Format Ethernet data only (FMTETH)

Indique s'il faut mettre en forme les données IEEE 802.3 ou les données Ethernet V2. Specifies whether IEEE 802.3 data or Ethernet V2 data is formatted.

*YES

Les données IEEE 802.3 et les données Ethernet V2 sont toutes deux mises en forme. Both IEEE 802.3 data and Ethernet V2 data are formatted.

*NO

Seules les données IEEE 802.3 sont mises en forme. Only IEEE 802.3 data is formatted.

Mettre en forme les données de contrôle d'appel (FMTCCD)Format call control data (FMTCCD)

Indique s'il faut mettre en forme toutes les données d'interface réseau ou uniquement les données de signalisation RNIS (Integrated Services Digital Network). Specifies whether all network interface data or only Integrated Services Digital Network (ISDN) signalling data is formatted.

*NO

Toutes les données d'interface réseau sont mises en forme. All network interface data is formatted.

*YES

Seules les données de signalisation RNIS sont mises en forme. Only ISDN signaling data is formatted.

Mettre en forme les données de diffusion (FMTBCD)Format broadcast data (FMTBCD)

Indique s'il faut mettre en forme les données de diffusion et les données reçues contenant des adresses MAC de destination. Specifies whether broadcast data and data received containing destination MAC addresses is formatted.

*YES

Les données de diffusion sont mises en forme. Broadcast data is formatted.

*NO

Les données de diffusion ne sont pas mises en forme. Broadcast data is not formatted.

Exclure les données LMI (EXCLMI)Exclude LMI data (EXCLMI)

Indique s'il faut exclure de la sortie formatée les données de l'interface de gestion locale (LMI). Specifies whether to exclude local management interface (LMI) data from the formatted output.

*NO

Les données LMI ne sont pas exclues de la sortie formatée. LMI data is not excluded from the formatted output.

*YES

LMI data is excluded from the formatted output.

Remarque :Vous ne pouvez pas indiquer *YES à la fois pour les paramètres EXCLMI et FMTLMI. Remarque :You cannot specify *YES for both the EXCLMI and FMTLMI parameters.

Formater uniquement les données LMI (FMTLMI)Format LMI data only (FMTLMI)

Indique si les données de l'interface de gestion locale (LMI) sont formatées. Specifies whether local management interface (LMI) data is formatted.

*NO

Les données LMI ne sont pas formatées. LMI data is not formatted.

*YES

LMI data is formatted.

Remarque :Vous ne pouvez pas indiquer *YES à la fois pour les paramètres EXCLMI et FMTLMI. Remarque :You cannot specify *YES for both the EXCLMI and FMTLMI parameters.

Formater uniquement les données HPR sur IP (FMTHPRIP)Format HPR over IP data only (FMTHPRIP)

Indique si les données HPR (High Performance Routing) sur IP sont incluses dans la trace de communications formatée. Specifies whether High Performance Routing Protocol (HPR) over IP data is included in the formatted communications trace.

*NO

Les données HPR sur IP ne sont pas formatées. HPR over IP data is not formatted.

*YES

Seules les données HPR sur IP sont formatées. Only HPR over IP data is formatted.

Formater uniquement les données LDLC sur IP (FMTLDLCIP)Format LDLC over IP data only (FMTLDLCIP)

Indique si les données LDLC (Logical Data Link Control) sur IP sont incluses dans la trace de communications formatée. Specifies whether Logical Data Link Control (LDLC) over IP data is included in the formatted communications trace.

*NO

Les données LDLC sur IP ne sont pas formatées. LDLC over IP data is not formatted.

*YES

Seules les données LDLC sur IP sont formatées. Only LDLC over IP data is formatted.

Exemples

PRTCMNTRC   CFGOBJ(*QESLINE)  CFGTYPE(*LIN)

Cette commande imprime les données de trace de communications de la description de ligne QESLINE. This command prints communications trace data for line description QESLINE.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF2634

Non autorisé à l'objet &1.

CPF39AF

La trace se termine - veuillez patienter Trace is ending - please wait

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

CPF39BA

Options de formatage sélectionnées non valides Formatting options selected not valid

CPF39BB

Données de trace de communications non imprimées Communications trace data not printed

CPF39BC

La demande d'impression de la trace de communications ne peut pas être exécutée Communications trace print request cannot be completed

CPF39B0

Il n'existe aucune trace des communications. No communications traces exist.

CPF39B1

La trace &1 de type &2 n'existe pas Trace &1 type &2 does not exist

CPF39B3

La trace &1 de type &2 ne contient aucune donnée Trace &1 type &2 contains no data

CPF39B4

Les données de trace de &1 de type &2 ne peuvent pas être imprimées Trace data for &1 type &2 cannot be printed

CPF39B5

Données de trace de communications non imprimées Communications trace data not printed

CPF39B6

La fonction de trace des communications ne peut pas être exécutée Communications trace function cannot be performed

CPF39B7

Les données de trace de &1 de type &2 ne peuvent pas être imprimées Trace data for &1 type &2 cannot be printed

CPF39B8

Aucune donnée SNA n'a été trouvée dans la trace &1 de type &2 No SNA data found in trace &1 type &2

CPF39B9

Aucun enregistrement de trace trouvé pour l'impression de la trace &1 de type &2 No trace records found for printing trace &1 type &2

CPF39C4

Adresse IP non valide. IP address not valid.

CPF3CF2

Une ou plusieurs erreurs se sont produites pendant l'exécution de l'API &1. Error(s) occurred during running of &1 API.

CPF9803

Impossible d'allouer l'objet &2 de la bibliothèque &3.

CPF9845

Erreur lors de l'ouverture du fichier &1.

CPF9846

Erreur lors du traitement du fichier &1 de &2.

CPF9847

Erreur lors de la fermeture du fichier &1 de bibliothèque &2.

CPF9860

Erreur lors du traitement du fichier de sortie.

CPF9872

Programme ou programme de service &1 de la bibliothèque &2 arrêté. Code raison : &3.

CPF98A2

Vous n'avez pas les droits sur la commande ou l'API &1. Not authorized to &1 command or API.

CPFA0D4

Une erreur s'est produite dans le système de fichiers. Code erreur &1.