DMPCMNTRC

La commande Vider trace des communications (DMPCMNTRC) copie les données de trace non formatées de la ligne, de la description d'interface réseau ou de la description de serveur réseau indiquée dans un fichier STREAM indiqué par l'utilisateur. Les données du fichier STREAM peuvent être formatées ultérieurement, sur le système en cours ou sur un autre système, à l'aide de la commande Imprimer trace des communications (PRTCMNTRC) en indiquant le paramètre FROMSTMF, ou à l'aide d'un formateur personnalisé prenant en charge le format Packet Capture (PCAP). The Dump Communications Trace (DMPCMNTRC) command copies the unformatted trace data for the specified line, network interface description, or network server description to a user-specified stream file. The data in the stream file can be formatted at a later time, either on the current system or a different system, by using the Print Communications Trace (PRTCMNTRC) command and specifying the FROMSTMF parameter, or by using a custom formatter that supports the Packet Capture (PCAP) format.

Restrictions:

• Pour utiliser cette commande, vous devez posséder le droit spécial de service (*SERVICE), ou être autorisé à la fonction de trace de service d'IBM i via la prise en charge de l'administration des applications de System i Navigator. La commande Modifier l'utilisation d'une fonction (CHGFCNUSG), avec l'ID de fonction QIBM_SERVICE_TRACE, peut également servir à modifier la liste des utilisateurs autorisés à effectuer des opérations de trace. To use this command, you must have service (*SERVICE) special authority, or be authorized to the Service trace function of IBM i through System i Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_TRACE, can also be used to change the list of users that are allowed to perform trace operations.

Paramètres

Objet de configuration (CFGOBJ)

Indique l'objet de configuration qui a été tracé. L'objet est soit une description de ligne, soit une description d'interface réseau, soit une description de serveur réseau. Specifies the configuration object that was traced. The object is either a line description, a network interface description, or a network server description.

nom

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

Type (CFGTYPE)

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

*LIN

L'objet de configuration est une description de ligne. The configuration object is a line description.

*NWI

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

*NWS

L'objet de configuration est une description de serveur réseau. The configuration object is a network server description.

Fichier STREAM de destination (TOSTMF)

Indique le fichier STREAM dans lequel les données sont copiées. Tous les répertoires du chemin d'accès doivent exister. Les nouveaux répertoires ne sont pas créés. Si le fichier STREAM n'existe pas, il est créé. Specifies the stream file to which data is copied. All directories in the path name must exist. New directories are not created. If the stream file does not exist, it is created.

chemin-d'accès

Indiquez le chemin d'accès du fichier STREAM à utiliser. Specify the path name for the stream file to be used.

Remplacer fichier (REPLACE)

Indique si l'opération de vidage remplace les enregistrements ou échoue à les copier dans un fichier STREAM lorsqu'un fichier STREAM portant le nom indiqué existe déjà. Si le fichier STREAM n'existe pas, il est créé. Specifies whether the dump operation replaces or fails to copy the records to a stream file if a stream file with the specified name already exists. If the stream file does not exist, it is created.

*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 signalled 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.

Format du fichier STREAM (FORMAT)Stream file format (FORMAT)

Indique le format du fichier de vidage. Specifies the format the dump file will have.

*CMNTRC

Format utilisé par la commande Imprimer trace des communications (PRTCMNTRC). Format used by the Print Communication Trace (PRTCMNTRC) command.

*PCAP

Format Packet Capture (PCAP), utilisé par les analyseurs de protocole réseau d'autres systèmes d'exploitation, tels que Linux et AIX. Packet Capture (PCAP) format, used by network protocol analyzers in other operating systems, such as Linux and AIX.

Exemples

DMPCMNTRC   CFGOBJ(*QESLINE)  CFGTYPE(*LIN)
            TOSTMF('/user/Test.stmf')  REPLACE(*YES)
            FORMAT(*CMNTRC)

Cette commande vide la trace des communications de la description de ligne QESLINE dans le fichier STREAM /user/Test.stmf au format Trace des communications. Si ce fichier STREAM existe déjà, il sera remplacé. This command dumps the communications trace of line description QESLINE to stream file /user/Test.stmf in Communications Trace format. If this stream file already exists, it will be replaced.

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

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

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

CPF39B6

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

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

CPF3CF2

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

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.

CPF9872

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

CPFA0D4

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