DMPUSRTRC

La commande Vider tampon de trace utilisateur (DMPUSRTRC) formate les enregistrements de trace du tampon de trace utilisateur du travail indiqué. Les enregistrements de trace formatés peuvent être écrits dans un fichier de base de données ou dans le fichier spécial stdout. The Dump User Trace Buffer (DMPUSRTRC) command formats trace records in the user trace buffer for the specified job. The formatted trace records can be written to a database file or to the stdout special file.

Les enregistrements de trace sont écrits dans un tampon de trace utilisateur à l'aide des API Qp0zUprintf, Qp0zDump, Qp0zDumpStack et Qp0zDumpTargetStack. Pour plus d'informations sur les API de détermination des problèmes, consultez l'Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/), UNIX-type APIs. Trace records are written to a user trace buffer using the Qp0zUprintf, Qp0zDump, Qp0zDumpStack, and Qp0zDumpTargetStack APIs. 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/), UNIX-type APIs for more information on the Problem Determination APIs.

Paramètres

Travail (JOB)

Indique le travail dont le tampon de trace utilisateur est vidé. Specifies the job for which the user trace buffer is being dumped.

Les valeurs possibles sont : The possible values are:

*

Le tampon de trace utilisateur du travail dans lequel la commande s'exécute est vidé. The user trace buffer for the job that the command is running in is dumped.

job-name

Indiquez le nom du travail dont le tampon de trace utilisateur est vidé. Si aucun qualificatif de nom d'utilisateur ou de numéro de travail n'est fourni, tous les travaux actuellement présents dans le système sont recherchés à partir du nom de travail simple. Si des doublons du nom indiqué sont trouvés, un nom de travail qualifié doit être indiqué. Specify the name of the job whose user trace buffer is being dumped. If no user name or job number qualifier is given, all of the jobs currently in the system are searched for the simple job name. If duplicates of the specified name are found, a qualified job name must be specified.

user-name

Indiquez le nom de l'utilisateur du travail dont le tampon de trace utilisateur est vidé. Specify the name of the user of the job whose user trace buffer is being dumped.

job-number

Indiquez le numéro à six chiffres du travail dont le tampon de trace utilisateur est vidé. Specify the six-digit number of the job whose user trace buffer is being dumped.

Identificateurs d'enregistrement de trace (TRCRCID)Trace record identifiers (TRCRCID)

Indique les identificateurs d'enregistrement à utiliser dans les enregistrements de point de trace formatés. Vous pouvez indiquer jusqu'à deux identificateurs. Specifies the record identifiers to be used in the formatted tracepoint records. Up to two identifiers can be specified.

Les valeurs possibles sont : The possible values are:

*THD

Des identificateurs d'unités d'exécution sont utilisés. Chaque identificateur contient huit chiffres hexadécimaux. Thread identifiers are used. Each identifier contains eight hexadecimal digits.

*JOB

Des identificateurs de travail sont utilisés. Chaque identificateur contient la partie numéro de travail à six chiffres du nom de travail qualifié. Job identifiers are used. Each identifier contains the six-digit job number portion of the qualified job name.

Sortie (OUTPUT)

Indique la destination de la sortie de la commande. Specifies where the output from the command is directed to.

Les valeurs possibles sont : The possible values are:

*FILE

La sortie est écrite dans le membre QP0Znnnnnn du fichier de base de données QAP0ZDMP de la bibliothèque QTEMP, où « nnnnnn » est la partie numéro de travail à six chiffres du nom de travail qualifié. The output is written to member QP0Znnnnnn in database file QAP0ZDMP in library QTEMP where 'nnnnnn' is the six-digit job number portion of the qualified job name.

*STDOUT

La sortie est écrite dans le fichier spécial stdout. The output is written to the stdout special file.

ID d'unités d'exécution à inclure (SLTTHD)Thread IDs to include (SLTTHD)

Indique une liste de huit unités d'exécution au maximum dont les enregistrements de trace doivent être inclus. Seuls les enregistrements de trace des unités d'exécution ayant les identificateurs indiqués sont inclus. Specifies a list of up to eight threads whose trace records are to be included. Only trace records for threads with the specified thread identifiers are included.

\nRemarque : Ce paramètre et le paramètre OMTTHD s'excluent mutuellement. Remarque :This parameter and the OMTTHD parameter are mutually exclusive.

Les valeurs possibles sont : The possible values are:

*ALL

Tous les enregistrements de trace sont inclus, sauf s'ils sont exclus par une autre valeur de sélection. All trace records are included, unless excluded by another selection value.

thread-identifier

Indiquez les identificateurs de huit unités d'exécution au maximum dont les enregistrements de trace doivent être inclus. Specify the thread identifiers of up to eight threads whose trace records are to be included.

ID d'unités d'exécution à exclure (OMTTHD)Thread IDs to exclude (OMTTHD)

Indique une liste de huit unités d'exécution au maximum dont les enregistrements de trace doivent être exclus. Les enregistrements de trace de toutes les unités d'exécution, sauf celles indiquées, sont inclus. Specifies a list of up to eight threads whose trace records are to be excluded. Trace records for all threads except those specified are included.

\nRemarque : Ce paramètre et le paramètre SLTTHD s'excluent mutuellement. Remarque :This parameter and the SLTTHD parameter are mutually exclusive.

Les valeurs possibles sont : The possible values are:

*NONE

Aucun enregistrement de trace n'est exclu d'après son identificateur d'unité d'exécution. No trace records are excluded based on their thread identifier.

thread-identifier

Indiquez les identificateurs de huit unités d'exécution au maximum dont les enregistrements de trace doivent être exclus. Specify the thread identifiers of up to eight threads whose trace records are to be excluded.

Exemples

Exemple 1 : Vidage des informations de trace utilisateur en cours Example 1: Dumping the Current User Trace Information

DMPUSRTRC

Cette commande formate les informations de trace utilisateur du travail en cours et écrit les enregistrements de trace formatés dans le fichier QAP0ZDMP de la bibliothèque QTEMP. This command formats the user trace information for the current job and writes the formatted trace records to file QAP0ZDMP in library QTEMP.

Exemple 2 : Vidage d'une trace pour un travail donné Example 2: Dumping a Trace for a Specific Job

DMPUSRTRC   JOB(004842/ACCT/WS6)  OUTPUT(*STDOUT)

Cette commande formate les informations de trace utilisateur du travail WS6, associé au profil utilisateur ACCT et portant le numéro de travail 004842, et écrit les enregistrements de trace formatés dans le fichier spécial stdout. This command formats the user trace information for job WS6, which is associated with the user profile ACCT, and has the job number 004842, writing the formatted trace records to the stdout special file.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPFA98B

Le tampon de trace utilisateur associé au travail &3/&2/&1 n'a pas pu être vidé. The User Trace buffer associated with job &3/&2/&1 could not be dumped.

CPFA98C

Le travail &3/&2/&1 n'est pas unique. Job &3/&2/&1 not unique.