CHGUSRTRC

La commande Modifier la mémoire tampon de trace utilisateur (CHGUSRTRC) modifie la mémoire tampon de trace utilisateur associée au travail indiqué. Chaque mémoire tampon de trace utilisateur est un objet espace utilisateur (*USRSPC) de la bibliothèque QUSRSYS, portant le nom QP0Znnnnnn, où 'nnnnnn' est le numéro du travail qui utilise la trace utilisateur. The Change User Trace Buffer (CHGUSRTRC) command changes the user trace buffer associated with the specified job. Each user trace buffer is a user space (*USRSPC) object in library QUSRSYS by the name QP0Znnnnnn, where 'nnnnnn' is the job number of the job using the user trace.

La trace utilisateur prend en charge les enregistrements de trace générés par l'utilisateur, écrits à l'aide des API Qp0zUprintf, Qp0zDump, Qp0zDumpStack et Qp0zDumpTargetStack. Voir l'Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/), API de type UNIX, pour plus d'informations sur les API de détermination des incidents. The user trace supports user-generated trace records written 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.

Les enregistrements de trace écrits dans la mémoire tampon de trace utilisateur avec les API de détermination des incidents peuvent être formatés et placés dans un fichier ou écrits dans le fichier stdout à l'aide de la commande CL DMPUSRTRC (Vider la mémoire tampon de trace utilisateur). The trace records written to the user trace buffer with the Problem Determination APIs can be formatted and placed into a file or written to the stdout file by using the DMPUSRTRC (Dump User Trace Buffer) CL command.

Les espaces de mémoire tampon de trace utilisateur peuvent être supprimés à l'aide de la commande CL DLTUSRTRC (Supprimer la mémoire tampon de trace utilisateur). User trace buffer spaces can be deleted by using the DLTUSRTRC (Delete User Trace Buffer) CL command.

Paramètres

Travail (JOB)

Indique le travail dont la mémoire tampon de trace utilisateur est modifiée. Specifies the job for which the user trace buffer is being changed.

Les valeurs possibles sont : The possible values are:

*

La mémoire tampon de trace utilisateur du travail dans lequel la commande s'exécute est modifiée. The user trace buffer for the job that the command is running in is changed.

job-name

Indiquez le nom du travail dont la mémoire tampon de trace utilisateur est modifiée. 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 pour trouver le 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 changed. 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 la mémoire tampon de trace utilisateur est modifiée. Specify the name of the user of the job whose user trace buffer is being changed.

job-number

Indiquez le numéro à six chiffres du travail dont la mémoire tampon de trace utilisateur est modifiée. Specify the six-digit number of the job whose user trace buffer is being changed.

Effacer la mémoire tampon de trace (CLEAR)Clear trace buffer (CLEAR)

Indique si tous les enregistrements de trace actuellement stockés dans l'espace de la mémoire tampon de trace utilisateur doivent être supprimés. Specifies whether all trace records currently stored in the user trace buffer space should be removed.

Les valeurs possibles sont : The possible values are:

*NO

Aucun enregistrement de trace n'est supprimé de la mémoire tampon de trace utilisateur. No trace records are removed from the user trace buffer.

*YES

Tous les enregistrements de trace actuellement stockés dans la mémoire tampon de trace utilisateur sont supprimés. All trace records currently stored in the user trace buffer are removed.

Mémoire maxi à utiliser (MAXSTG)

Indique la taille, en kilo-octets, à laquelle la mémoire tampon de trace utilisateur est créée (si elle n'existe pas) ou redimensionnée (si elle existe). Si ce paramètre est indiqué, *YES doit également être indiqué pour le paramètre CLEAR. Specifies the size, in kilobytes, that the user trace buffer will be created to (if it doesn't exist) or resized to (if it exists). If this parameter is specified, *YES must also be specified for the CLEAR parameter.

Les valeurs possibles sont : The possible values are:

*SAME

La taille de la trace utilisateur n'est pas modifiée. La taille par défaut (300 kilo-octets) est utilisée pour créer la mémoire tampon de trace utilisateur lors du premier appel d'une API de trace utilisateur. The user trace size is not changed. The default size (300 kilobytes) is used to create the user trace buffer when the first user trace API is called.

maximum-kilobytes

Indiquez la quantité maximale de mémoire, en kilo-octets, utilisée pour stocker les enregistrements de trace utilisateur. Un kilo-octet équivaut à 1024 octets. Specify the maximum amount of storage, in kilobytes, used to store user trace records. One kilobyte equals 1024 bytes.

Trace pleine (TRCFULL)

Indique si les enregistrements de trace se rebouclent (les enregistrements les plus anciens sont remplacés par les nouveaux) ou si la trace s'arrête lorsque tout le stockage indiqué par le paramètre MAXSTG a été utilisé. Specifies whether the trace records wrap (replace oldest records with new records) or whether the trace stops when all of the storage specified by the MAXSTG parameter has been used.

Les valeurs possibles sont : The possible values are:

*SAME

L'attribut en cours n'est pas modifié. La valeur par défaut à la création d'un espace de mémoire tampon de trace utilisateur est TRCFULL(*WRAP). The current attribute does not change. The default when a user trace buffer space is created is TRCFULL(*WRAP).

*WRAP

Lorsque le fichier de trace est plein, la trace reboucle 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 file 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 l'espace de la mémoire tampon de trace est plein d'enregistrements de trace. Tracing stops when the trace buffer space is full of trace records.

Exemples

Exemple 1 : Modification de la taille de la mémoire tampon de trace utilisateur du travail en cours Example 1: Changing the User Trace Buffer Size for the Current Job

CHGUSRTRC   JOB(*)  MAXSTG(100)  CLEAR(*YES)

Cette commande porte à 100 kilo-octets la taille de la mémoire tampon de trace utilisateur du travail en cours. This command changes the user trace buffer size for the current job to 100 kilobytes.

Exemple 2 : Effacement de la mémoire tampon de trace utilisateur d'un travail donné Example 2: Clearing the User Trace Buffer for a Specific Job

CHGUSRTRC   JOB(123581/DEPT2/WS1)  CLEAR(*YES)

Cette commande efface la mémoire tampon de trace utilisateur du travail WS1, associé au profil utilisateur DEPT2 et portant le numéro de travail 123581. This command clears the user trace buffer for job WS1, which is associated with the user profile DEPT2, and has the job number 123581.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPFA98A

Une option de trace utilisateur n'a pas pu être modifiée pour le travail &3/&2/&1. A User Trace option could not be changed for job &3/&2/&1.

CPFA98C

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

CPF1070

Travail &3/&2/&1 non trouvé.