Aller au contenu

STRTRC

Démarrer trace

Start Trace

En bref

La commande Démarrer trace (STRTRC) démarre des traces de programmes du modèle de programme d'origine (OPM), de procédures ILE (Integrated Language Environment) et de programmes Java (compilés et JIT). The Start Trace (STRTRC) command starts traces of original program model (OPM) programs and Integrated Language Environment (ILE) procedures and Java programs (both compiled and JIT).

STRTRC se lit STR (Démarrer) + TRC. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

STRTRC SSNID(…)

Paramètres

  • SSNID ID de session Session ID obligatoire
  • JOB Travaux Jobs
  • JOINTRC Jonction de trace Join trace
  • JOBTYPE Types de travaux
  • MAXSTG Mémoire maxi à utiliser
  • TRCFULL Trace pleine
  • JOBTRCTYPE Type de trace
  • TRCTYPE Type de trace Trace type
  • TRCFTR Filtre de trace Trace filter
  • RESTRIPL Redémarrage après le prochain IPL Restart after next IPL
  • WCHMSG Surveiller un message Watch for message
  • WCHMSGQ File d'attente de messages surveillée Watched message queue
  • WCHJOB Travail surveillé Watched job
  • WCHLICLOG Surveiller une entrée du journal LIC Watch for LIC log entry
  • WCHPAL Surveiller une entrée PAL Watch for PAL entry
  • WCHTIMO Durée de la surveillance Length of time to watch
  • TRCPGM Programme de trace Trace program
  • TRCPGMITV Intervalle
  • RUNPTY Priorité d'exécution

Astuce : dans une session 5250, tapez STRTRC puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande Démarrer trace (STRTRC) démarre des traces de programmes du modèle de programme d'origine (OPM), de procédures ILE (Integrated Language Environment) et de programmes Java (compilés et JIT). La trace peut porter sur plusieurs travaux à l'aide de cette commande. Un nombre quelconque de sessions de trace peut être démarré, mais les identificateurs de sessions de trace actives doivent être uniques dans tout le système. Cette commande peut tracer le flux appel-retour, les données renvoyées par les points de trace définis dans le système d'exploitation, les informations de trace de composant, ou les trois. The Start Trace (STRTRC) command starts traces of original program model (OPM) programs and Integrated Language Environment (ILE) procedures and Java programs (both compiled and JIT). Tracing can be done for multiple jobs using this command. Any number of trace sessions can be started, but active trace session identifiers must be unique across the system. This command can trace call-return flow, data returned by trace points defined in the operating system, component trace information or all three.

La session de trace se poursuit jusqu'à ce qu'elle soit arrêtée par la commande Terminer trace (ENDTRC) ou automatiquement par la fonction de surveillance des événements de trace. Une session de trace peut être arrêtée à partir du même travail ou d'un autre travail. The trace session continues until ended with the End Trace (ENDTRC) command or automatically by the watch for trace event functionality. A trace session can be ended from the same job or a different job.

Restrictions:

  • Cette commande est livrée avec le droit public d'exclusion (*EXCLUDE) et les profils utilisateur QSRV et QSRVBAS sont livrés avec des droits privés pour utiliser cette commande. This command is shipped with exclude (*EXCLUDE) public authority and the QSRV and QSRVBAS user profiles are shipped with private authorities 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.
  • Si vous indiquez un nom d'utilisateur générique pour le paramètre Travail (JOB) ou si vous indiquez *YES dans le paramètre Jonction de trace (JOINTRC), vous devez posséder le droit spécial sur tous les objets (*ALLOBJ) ou être autorisé à la fonction Tracer n'importe quel utilisateur d'IBM i via la prise en charge de l'administration des applications de System i Navigator. La commande Modifier utilisation d'une fonction (CHGFCNUSG), avec l'ID de fonction QIBM_ALLOBJ_TRACE_ANY_USER, peut également être utilisée pour modifier la liste des utilisateurs autorisés à effectuer des opérations de trace. If you specify a generic user name for the Travail (JOB) parameter or you specify *YES in the Join trace (JOINTRC) parameter, you must have all object (*ALLOBJ) special authority, or be authorized to the Trace any user function of IBM i through System i Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_ALLOBJ_TRACE_ANY_USER, can also be used to change the list of users that are allowed to perform trace operations.
  • Une trace ne peut pas être définie pour tracer tous les noms de travaux et tous les utilisateurs. A trace cannot be defined to trace all job names and all users.
  • Une seule commande STRTRC dans tout le système peut indiquer JOINTRC(*YES). Only one STRTRC command across the system is allowed to specify JOINTRC(*YES).
  • Au moins un nom de travail générique doit être indiqué si *YES a été indiqué pour le paramètre Redémarrage après le prochain IPL (RESTRIPL). At least one generic job name must be specified if *YES has been specified for the Restart after next IPL (RESTRIPL) parameter.
  • Les paramètres relatifs à la surveillance ne peuvent pas être indiqués si *YES est indiqué pour le paramètre RESTRIPL. Watch-related parameters cannot be specified if *YES is specified for the RESTRIPL parameter.
  • Une seule commande STRTRC dans tout le système peut être indiquée pour redémarrer après le prochain IPL. Only one STRTRC command across the system can be specified to restart after the next IPL.
  • 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

Mot-clé Description Valeurs possibles Remarques
SSNID ID de sessionSession ID Nom, *GEN Obligatoire, positionnel 1
JOB TravauxJobs Valeurs uniques: *
Autres valeurs (jusqu'à 8 répétitions): Liste d'éléments
Facultatif
Élément 1: Travail Nom de travail qualifié
Qualificatif 1: Travail Nom générique, nom, *ALL
Qualificatif 2: Utilisat Nom générique, nom, *ALL
Qualificatif 3: Numéro 000001-999999, *ALL
Élément 2: Thread ID to include Valeurs uniques: *ALL, *SELECT
Autres valeurs (jusqu'à 20 répétitions): Valeur caractère, *INITIAL
Élément 3: Sous-système Nom générique, nom, *ALLSBS
JOINTRC Jonction de traceJoin trace *NO, *YES Facultatif
JOBTYPE Types de travaux *ALL, *ACTIVE, *NEW Facultatif
MAXSTG Mémoire maxi à utiliser 1024-4000000, 10000 Facultatif
TRCFULL Trace pleine *STOPTRC, *WRAP Facultatif
JOBTRCTYPE Type de trace Values (jusqu'à 2 répétitions): *ALL, *FLOW, *DATA, *TRCTYPE Facultatif
TRCTYPE Type de traceTrace type Valeurs uniques: *NONE
Autres valeurs (jusqu'à 50 répétitions): Liste d'éléments
Facultatif
Élément 1: Composant Valeur caractère, *ASPMGT, *CKMAPI, *CLUSTER, *CMTCTL, *DBDDM, *DBDRDA, *DBHSVR, *DBQRY, *DBSQL, *DBSQLXML, *DEVCFG, *DIRSRV, *EDRSQL, *ENVVAR, *FILESVR, *FLIGHTRCD, *HPT, *HTTP, *IFS, *IFSMFS, *IPC, *IPPDRV, *LOCKSPACE, *LWI, *NETSVR, *NFS, *NPS, *NWSCFG, *NWSSTG, *OBJLCK, *OPASSIST, *OPENSSL, *POSIXMISC, *POSIXPROC, *PRTTFMSRV, *PTHREAD, *QNTC, *QSHELL, *RAS, *RCDLCK, *REGFAC, *REXEC, *ROUTING, *SAVRST, *SECURITY, *SERVICE, *SIGNAL, *SMTPAPI, *SNMP, *SOCKETS, *SPCLCK, *SPOOL, *SRVCFG, *SVRVRY, *TCPIPCFG, *THREADMGT, *WRKMGT, *WSFM
Élément 2: Trace level *ERROR, *INFO, *VERBOSE
TRCFTR Filtre de traceTrace filter Nom, *NONE Facultatif
RESTRIPL Redémarrage après le prochain IPLRestart after next IPL *NO, *YES Facultatif
WCHMSG Surveiller un messageWatch for message Valeurs uniques: *NONE
Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments
Facultatif
Élément 1: Message to watch Nom générique, nom, *ALL, *IMMED
Élément 2: Donnée de comparaison Valeur caractère, *NONE
Élément 3: Compare against *MSGDTA, *FROMPGM, *TOPGM
Élément 4: Type de message *ALL, *COMP, *DIAG, *ESCAPE, *INFO, *INQ, *NOTIFY, *SCOPE, *STATUS
Élément 5: Opérateur relationnel *GE, *EQ, *GT, *LT, *LE
Élément 6: Code gravité 0-99, 00
WCHMSGQ File d'attente de messages surveilléeWatched message queue Values (jusqu'à 3 répétitions): Liste d'éléments Facultatif
Élément 1: File attente messages Valeurs uniques: *SYSOPR, *JOBLOG, *HSTLOG
Autres valeurs: Nom d'objet qualifié
Qualificatif 1: File attente messages Nom
Qualificatif 2: Biblio Nom, *LIBL
WCHJOB Travail surveilléWatched job Valeurs uniques: *
Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments
Facultatif
Élément 1: Travail Nom de travail qualifié
Qualificatif 1: Travail Nom générique, nom
Qualificatif 2: Utilisat Nom générique, nom
Qualificatif 3: Numéro 000001-999999, *ALL
WCHLICLOG Surveiller une entrée du journal LICWatch for LIC log entry Valeurs uniques: *NONE
Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments
Facultatif
Élément 1: Major code Valeur caractère, *ALL
Élément 2: Minor code Valeur caractère, *ALL
Élément 3: Donnée de comparaison Valeur caractère, *NONE
Élément 4: Compare against *ALL, *TDENBR, *TASKNAME, *SVRTYPE, *JOBNAME, *JOBUSR, *JOBNBR, *THDID, *EXCPID, *MODNAME, *MODRUNAME, *MODEPNAME, *MODOFFSET, *MODTSP
WCHPAL Surveiller une entrée PALWatch for PAL entry Valeurs uniques: *NONE
Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments
Facultatif
Élément 1: Code SRC Valeur caractère, *ALL
Élément 2: Donnée de comparaison Valeur caractère, *NONE
Élément 3: Compare against *RSCNAME, *RSCTYPE, *RSCMODEL
WCHTIMO Durée de la surveillanceLength of time to watch 1-43200, *NOMAX Facultatif
TRCPGM Programme de traceTrace program Valeurs uniques: *NONE
Autres valeurs: Nom d'objet qualifié
Facultatif
Qualificatif 1 : Programme de traceQualificatif 1: Trace program Nom
Qualificatif 2: Biblio Nom, *LIBL
TRCPGMITV Intervalle 1-9999, *NONE Facultatif
RUNPTY Priorité d'exécution 1-99, 25 Facultatif

ID de session (SSNID)Session ID (SSNID)

Indique un identificateur de session pour cette trace. Cet identificateur doit être unique parmi toutes les traces actives du système. Specifies a session identifier for this trace. This identifier must be unique across all active traces on the system.

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

*GEN
Le système génère un identificateur de session unique pour cette trace. The system will generate a unique session identifier for this trace.
nom
Indiquez l'identificateur de session de cette trace. Specify the session identifier for this trace.

Travail (JOB)

Indique les travaux à tracer. Si les travaux indiqués se trouvent dans le sous-système indiqué, ces travaux font partie de la collecte de trace et des données sont collectées pour eux. Specifies which jobs are to be traced. If the specified jobs are in the specified subsystem, then those jobs will be part of the trace collection and data will be collected for those jobs.

Valeurs uniques

*
Seul le travail qui émet la commande STRTRC (Démarrer trace) est tracé. Only the job that issues the STRTRC (Start Trace) command is to be traced.

Autres valeurs (jusqu'à 8 répétitions)

Élément 1: Travail

Qualificatif 1: Travail

*ALL
Tous les noms de travaux associés au nom d'utilisateur de travail indiqué sont tracés. *ALL pour le nom de travail est considéré comme une spécification de travail générique car il trace tous les travaux qui répondent aux qualificatifs de nom d'utilisateur de travail que vous avez indiqués. All jobs names with the specified job user name are traced. *ALL for the job name is considered to be a generic job specification because it will trace all jobs that meet the job user name qualifiers that you specified.
nom-générique
Indiquez le nom générique des travaux à tracer. Un nom générique est une chaîne de caractères d'un ou plusieurs caractères suivis d'un astérisque (*) ; par exemple, ABC*. L'astérisque remplace tous les caractères valides. 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 jobs to be traced. 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 à tracer. Jusqu'à huit noms de travaux peuvent être indiqués. Specify the name of the job to be traced. Up to eight job names may be specified.

Qualificatif 2: Utilisat

*ALL
Tous les noms d'utilisateur de travail associés au nom de travail indiqué sont tracés. *ALL pour le nom d'utilisateur de travail est considéré comme une spécification de travail générique car il trace tous les travaux qui répondent aux qualificatifs de nom de travail que vous avez indiqués. All job user names with the specified job name are traced. *ALL for the job user name is considered to be a generic job specification because it will trace all jobs that meet the job name qualifiers that you specified.
nom-générique
Indiquez le nom d'utilisateur générique des travaux dont les enregistrements de trace doivent être collectés. Un nom générique est une chaîne de caractères d'un ou plusieurs caractères suivis d'un astérisque (*) ; par exemple, ABC*. L'astérisque remplace tous les caractères valides. Un nom d'utilisateur générique désigne tous les travaux dont le nom d'utilisateur commence par le préfixe générique. Specify the generic user name of the jobs from which trace records are to be collected. 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 user names that begin with the generic prefix.
nom
Indiquez le nom d'utilisateur du travail à tracer. Specify the user name of the job to be traced.

Qualificatif 3: Numéro

*ALL
Tous les travaux portant le nom de travail et le nom d'utilisateur indiqués sont tracés. *ALL pour le numéro de travail est considéré comme une spécification de travail générique car il trace tous les travaux qui répondent aux qualificatifs de nom de travail et de nom d'utilisateur de travail que vous avez indiqués. All jobs with the specified job name and user name are traced. *ALL for the job number is considered to be a generic job specification because it will trace all jobs that meet the job name and job user name qualifiers that you specified.
000001-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 qualifier or generic user name qualifier is specified.

Élément 2: Thread ID to include

Valeurs uniques

*ALL
Toutes les unités d'exécution du travail portant le nom de travail et le nom d'utilisateur indiqués sont tracées. All threads within the specified job name and user name are traced.
*SELECT
Une liste d'identificateurs d'unités d'exécution est affichée ; l'utilisateur peut en sélectionner jusqu'à vingt à tracer. Cette valeur n'est valide que si la commande est exécutée dans un travail interactif. A list of thread identifiers is shown from which the user can select up to twenty to be traced. This value is only valid if the command is run in an interactive job.

Autres valeurs (jusqu'à 20 répétitions)

*INITIAL
Seule l'unité d'exécution initiale du travail portant le nom de travail et le nom d'utilisateur indiqués est tracée. Only the initial thread within the specified job name and user name is traced.
thread-identifier
Indiquez les identificateurs d'au plus vingt unités d'exécution dont les informations doivent être incluses. Il s'agit de l'ID d'unité d'exécution affiché par la commande Gérer travail (WRKJOB). Specify the identifiers of up to twenty threads whose information is to be included. This is the thread ID as shown by the Work with Job (WRKJOB) command.

Élément 3: Sous-système

*ALLSBS
Les travaux indiqués font partie de la collecte de trace, quel que soit le sous-système dans lequel ils se trouvent. The specified jobs will be part of the trace collection regardless of which subsystem the jobs are in.
nom-générique
Indiquez le nom générique du sous-système qui contient les travaux à inclure dans la collecte de trace. Un nom générique est une chaîne de caractères d'un ou plusieurs caractères suivis d'un astérisque (*) ; par exemple, ABC*. L'astérisque remplace tous les caractères valides. Specify the generic name of the subsystem that contains the jobs to be included in the trace collection. 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.
nom
Indiquez le nom du sous-système qui contient les travaux à inclure dans la collecte de trace. Specify the name of the subsystem that contains the jobs to be included in the trace collection.

Jonction de trace (JOINTRC)Join trace (JOINTRC)

Indique si les travaux indiqués définiront leurs caractéristiques de trace dans un travail ou une unité d'exécution associé, ce qui signifie que le travail ou l'unité d'exécution associé sera ajouté à la collecte de trace. Des exemples d'unités d'exécution associées sont les travaux soumis suite à l'appel de l'API spawn ou les travaux prédémarrés exécutant une tâche pour un travail parent. Specifies if the specified jobs will set their trace characteristics in a related job or thread, meaning that the related job or thread will be added to the trace collection. Examples of related threads are jobs submitted because of spawn API being called or pre-start jobs doing work for a parent job.

Remarque : Une seule commande STRTRC peut être indiquée pour définir les caractéristiques de trace d'un travail dans un travail ou une unité d'exécution associé. Si une autre commande STRTRC a été précédemment indiquée avec JOINTRC(*YES), un message d'erreur est envoyé et la seconde commande STRTRC échoue. Remarque :Only one STRTRC command can be specified to set the trace characteristics of a job in a related job or thread. If another STRTRC command was previously specified with JOINTRC(*YES), an error message is sent and the second STRTRC command fails.

Remarque : Les caractéristiques de trace ne sont définies que sur un seul niveau. Autrement dit, si un travail ou une unité d'exécution associé (qui a déjà adopté les caractéristiques de trace du travail d'origine) génère un second travail ou une seconde unité d'exécution, les caractéristiques de trace ne sont pas définies pour ce travail. Remarque :The trace characteristics will be set only to one level. This is, if a related job or thread (that already adopted the trace characteristics of the original job) generates a second job or thread, the trace characteristics will not be set to this job.

*NO
Les caractéristiques de trace des travaux indiqués ne sont pas définies dans un travail ou une unité d'exécution associé. The trace characteristics of the specified jobs will not be set in a related job or thread.
*YES
Les caractéristiques de trace des travaux indiqués sont définies dans un travail ou une unité d'exécution associé. The trace characteristics of the specified jobs will be set in a related job or thread.

Types de travaux (JOBTYPE)

Indique les types de travaux pour lesquels des données de trace doivent être collectées. Specifies the types of jobs for which trace data is to be collected.

*ALL
Tous les travaux qui répondent aux critères de sélection du nom de travail sont inclus dans cette collecte de trace. Cela comprend les travaux actuellement actifs sur le système. Si un nom de travail générique a été indiqué, les nouveaux travaux qui démarrent après le début de cette session de trace et répondent aux critères de sélection du nom de travail générique sont également inclus dans la collecte de trace. All jobs that meet the job name selection criteria will be included in this trace collection. This includes jobs that are currently active on the system. If a generic job name was specified, new jobs that start after this trace session begins and meet the generic job name selection criteria, will be included in the trace collection as well.
*ACTIVE
Seuls les travaux actuellement actifs au moment de l'activation de cette session de trace et répondant aux critères de sélection du nom de travail sont inclus dans cette collecte de trace. Only jobs that are currently active at the time this trace session is being activated and meet the job name selection criteria will be included in this trace collection.
*NEW
Seuls les nouveaux travaux qui démarrent après l'activation de cette session de trace et répondent aux critères de sélection du nom de travail générique sont inclus dans cette collecte de trace. Only new jobs that begin after this trace session is activated and meet the generic job name selection criteria will be included in this trace collection.

Mémoire maxi à utiliser (MAXSTG)

Indique la quantité maximale de mémoire demandée, en kilooctets (Ko), à utiliser pour les enregistrements de trace collectés. Le système calcule la quantité minimale de mémoire nécessaire pour la trace ; ce calcul dépend de la configuration des processeurs du système. La quantité minimale de mémoire peut être sensiblement supérieure à la taille indiquée pour le paramètre MAXSTG ; le système utilise la plus grande des deux valeurs. Specifies the requested maximum amount of storage, in kilobytes (K), to use for the collected trace records. The system will calculate the minimum amount of storage that is necessary for the trace; this minimum storage size calculation is dependent upon the system's processor configuration. The minimum amount of storage may be significantly larger than the size specified on the MAXSTG parameter; the system will use the larger of the two values.

10000
Jusqu'à 10 000 kilooctets de mémoire sont utilisés. Up to 10,000 kilobytes of storage is used.
1024-4000000
Indiquez la quantité maximale de mémoire, en kilooctets, à utiliser pour stocker les enregistrements de trace (un kilooctet équivaut à 1024 octets). Specify the maximum amount of storage, in kilobytes, to be used to store trace records (one kilobyte equals 1024 bytes).

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 toute la mémoire indiquée par le paramètre MAXSTG a été utilisée. Specifies whether the trace records wrap (replace the oldest records with new records) or whether the trace stops when all of the storage specified by the MAXSTG parameter has been used.

*WRAP
Lorsque la mémoire 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 storage 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 mémoire de trace est pleine d'enregistrements de trace. Tracing stops when the trace storage is full of trace records.

Type de trace (JOBTRCTYPE)

Indique les types de données de trace de travail à stocker dans le fichier de trace. Specifies the types of job trace data to be stored in the trace file.

Vous pouvez indiquer 2 valeurs pour ce paramètre. You can specify 2 values for this parameter.

*ALL
Toutes les données de trace collectées sont stockées dans des enregistrements de trace. Cela comprend la trace du flux de contrôle et les données de trace elles-mêmes. All the trace data collected is stored in trace records. This includes tracing the flow of control and the trace data itself.
*FLOW
Le flux de contrôle est tracé lors des appels et des retours des programmes OPM et des procédures ILE. The flow of control is traced when OPM programs and ILE procedures are called and when they return.
*DATA
Les données fournies aux points de trace prédéfinis dans le système d'exploitation sont stockées dans des enregistrements de trace. Cela comprend les enregistrements de trace des commandes CL qui ont été exécutées. The data that is provided at predefined trace points within the operating system is stored in trace records. This includes trace records for the CL commands that have run.
*TRCTYPE
Trace les composants spécifiques indiqués pour le paramètre Type de trace (TRCTYPE). Trace the specific components specified for the Trace type (TRCTYPE) parameter.

Type de trace (TRCTYPE)Trace type (TRCTYPE)

Indique le composant à tracer et le niveau à utiliser. Vous pouvez indiquer jusqu'à 50 composants de trace. Specifies the component to trace and the level to use. You can specify up to 50 trace components to be traced.

Valeurs uniques

*NONE
Aucune trace de composant n'est indiquée. No component trace is specified.

Élément 1: Composant

Indiquez le composant à tracer. Le composant peut être soit un nom de composant défini par l'utilisateur, généralement défini par un fournisseur d'application, soit une valeur spéciale prédéfinie, définie par le système d'exploitation. Les valeurs spéciales peuvent être sélectionnées dans le tableau suivant : Specify the component to trace. The component can be either a user-defined component name, which is typically defined by an application provider, or a pre-defined special value, which is defined by the operating system. Special value can be selected from the following table:

TRACE DESCRIPTION                             SPECIAL VALUE
ASP Management                                *ASPMGT
Crytographic Key Management APIs              *CKMAPI
Cluster Resource Services                     *CLUSTER
Commitment Control                            *CMTCTL
Distributed Data Management                   *DBDDM
Distributed Relational Database Architecture  *DBDRDA
Database Host Server                          *DBHSVR
Database Query Engine                         *DBQRY
Database SQL                                  *DBSQL
Database SQL XML                              *DBSQLXML
Device Configuration                          *DEVCFG
Directory Services                            *DIRSRV
Extended Dynamic Remote SQL (EDRS)            *EDRSQL
Environment Variable APIs                     *ENVVAR
File Server                                   *FILESVR
Flight Recorder                               *FLIGHTRCD
Host Print Transform                          *HPT
HTTP Server powered by Apache                 *HTTP
Integrated File System                        *IFS
IFS Mutable File Systems                      *IFSMFS
Interprocess Communication APIs               *IPC
Internet Print Protocol Driver                *IPPDRV
Lock Space Management                         *LOCKSPACE
LightWeight Infrastructure                    *LWI
System i5 NetServer                           *NETSVR
Network File System                           *NFS
Network Print Server                          *NPS
Network Server Configuration                  *NWSCFG
Network Server Storage Spaces                 *NWSSTG
Object Locks                                  *OBJLCK
Operational Assistant                         *OPASSIST
OpenSSL APIs                                  *OPENSSL
POSIX Miscellaneous APIs                      *POSIXMISC
POSIX Process-Related APIs                    *POSIXPROC
Print Transform Services                      *PRTTFMSRV
POSIX Thread APIs                             *PTHREAD
QNTC File System                              *QNTC
Qshell                                        *QSHELL
Remote Access Services                        *RAS
Record Locks                                  *RCDLCK
Registration Facility                         *REGFAC
REXEC Server                                  *REXEC
OSPF and RIP protocols server                 *ROUTING
Save/Restore                                  *SAVRST
Software Security                             *SECURITY
Service Facility                              *SERVICE
Signal APIs                                   *SIGNAL
SMTP APIs                                     *SMTPAPI
Simple Network Management Protocol            *SNMP
Sockets APIs                                  *SOCKETS
Space Location Locks                          *SPCLCK
Spool functions                               *SPOOL
Service Configuration                         *SRVCFG
Integrated Server Vary Processing             *SVRVRY
TCP/IP Configuration                          *TCPIPCFG
Thread Management                             *THREADMGT
Work Management                               *WRKMGT
Workstation Function Manager                  *WSFM

Élément 2: Trace level

Indiquez le niveau de trace à utiliser pour le composant indiqué. Specify the trace level to be used for the specified component.

*ERROR
Le niveau de trace ERROR est utilisé. Les composants tracent généralement les codes retour d'erreur, les conditions d'exception et les entrées non valides. La quantité de données est généralement faible. The trace level ERROR will be used. Components typically trace error return codes, exception conditions, and invalid input. The amount of data is usually small.
*INFO
Le niveau de trace INFO est utilisé ; il inclut également les données du niveau de trace ERROR. Les composants tracent généralement l'entrée et la sortie des interfaces, les paramètres et les codes retour, ainsi que les changements majeurs de flux ou de sémantique causés par les entrées ou d'autres décisions. La quantité de données est modérée. The trace level INFO will be used, which also includes ERROR trace level data. Components typically trace entry and exit from interfaces, parameters and return codes, and major changes of flow or semantics caused by input or other decisions. The amount of data is moderate.
*VERBOSE
Le niveau de trace VERBOSE est utilisé ; il inclut également les données des niveaux de trace INFO et ERROR. Les composants tracent généralement des données détaillées pouvant faciliter le débogage du flux de contrôle, de la corruption de données, des structures de données, de l'environnement, des piles d'appels et des allocations de ressources. La quantité de données peut être importante. The trace level VERBOSE will be used, which also includes INFO and ERROR trace level data. Components typically trace detailed data that could assist in debugging control flow, data corruption, data structures, environment, call stacks, and resource allocations. The amount of data can be large.

Filtre de trace (TRCFTR)Trace filter (TRCFTR)

Indique le filtre de trace à utiliser. La commande Ajouter filtre de trace (ADDTRCFTR) doit être émise pour définir le filtre de trace. Le filtre détermine les informations collectées dans la trace en fonction des valeurs de filtre, qui sont comparées aux données de trace réelles. Si aucun filtre n'est indiqué, toutes les informations de trace sont collectées. Specifies the trace filter to be used. The Add Trace Filter (ADDTRCFTR) command must be issued to define the trace filter. The filter determines what information is collected in the trace based on the filter values. The filter values are compared to the actual trace data. If a filter is not specified, then all trace information is collected.

Le paramètre de filtre de trace ne peut être indiqué que si *ALL ou *FLOW a été indiqué pour le paramètre Type de trace (JOBTRCTYPE). Le filtre de trace ne s'applique qu'à la trace *FLOW (appel/retour). The trace filter parameter can only be specified if *ALL or *FLOW has been specified for the Type de trace (JOBTRCTYPE) parameter. The trace filter applies to the *FLOW (call/return) trace only.

*NONE
Aucun filtre de trace n'est utilisé. No trace filter will be used.
nom
Indiquez le nom du filtre de trace à utiliser. Specify the name of the trace filter to be used.

Redémarrage après le prochain IPL (RESTRIPL)Restart after next IPL (RESTRIPL)

Indique si la trace est redémarrée après le prochain chargement du programme initial (IPL) du système d'exploitation. Specifies if the trace will be restarted after the next initial program load (IPL) of the operating system.

Remarque : Une seule commande STRTRC peut être indiquée pour redémarrer après le prochain IPL. Si une autre commande STRTRC a été précédemment indiquée avec RESTRIPL(*YES), un message d'erreur est envoyé et cette commande STRTRC échoue. Ce paramètre ne peut être indiqué que si au moins un nom de travail générique est indiqué dans le paramètre Travail (JOB). Vous devez exécuter la commande Terminer trace (ENDTRC) pour la session de trace qui a indiqué RESTRIPL(*YES) afin de libérer la mémoire utilisée pour conserver la chaîne de la commande STRTRC à redémarrer après un IPL. Ce paramètre ne peut pas être indiqué si des paramètres relatifs à la surveillance ont été indiqués. Remarque :Only one STRTRC command can be specified to restart after the next IPL. If another STRTRC command was previously specified with RESTRIPL(*YES), an error message is sent and this STRTRC command fails. This parameter can be specified only if at least one generic job name is specified in the Travail (JOB) parameter. You must run the End Trace (ENDTRC) command for the trace session which specified RESTRIPL(*YES) to clear the storage used to hold the STRTRC command string to be restarted after an IPL. This parameter cannot be specified if any watch-related parameters have been specified.

Remarque : Si l'IPL est associé à une installation ou à une mise à niveau du système d'exploitation, la trace n'est pas redémarrée. Remarque :If the IPL is associated with an install or upgrade of the operating system, the trace will not be restarted.

*NO
La trace n'est pas redémarrée après un IPL. The trace will not be restarted after an IPL.
*YES
La trace est redémarrée après le prochain IPL. La trace démarrée par cette commande STRTRC prend automatiquement fin si un IPL du système d'exploitation est effectué. La trace démarrée après le prochain IPL est une nouvelle session de trace avec de nouvelles données de trace. Vous pouvez utiliser la commande ENDTRC pour arrêter la trace. The trace will be restarted after the next IPL. The trace being started by this STRTRC automatically ends if an IPL of the operating system is performed. The trace started after the next IPL will be a new trace session with new trace data. You can use the ENDTRC command to end the trace.

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/

Exemples

Exemple 1 : Démarrer une trace sur votre travail Example 1: Start a Trace on Your Job

STRTRC   SSNID(*GEN)

Cette commande démarre une trace sur le travail qui a appelé la commande STRTRC. Un identificateur de session de trace unique est généré. L'identificateur de session est renvoyé dans les données du message de fin envoyé après le démarrage réussi de la session de trace. This command starts a trace on the job that called the STRTRC command. A unique trace session identifier will be generated. The session identifier will be returned in the message data of a completion message sent after the trace session starts successfully.

Exemple 2 : Démarrer la trace d'un autre travail Example 2: Start a Trace of Another Job

STRTRC   JOB(123456/QSYS/QSYSARB)  SSNID(ARBTRACE)

Cette commande démarre une nouvelle trace sur le travail de nom QSYSARB, de nom d'utilisateur de travail QSYS et de numéro de travail 123456. Seul ce travail est tracé. L'identificateur de session de trace est ARBTRACE. This command starts a new trace on the job with job name QSYSARB, job user name of QSYS, and job number of 123456. Only this one job is traced. The trace session identifier is ARBTRACE.

Exemple 3 : Démarrer une trace de travaux génériques Example 3: Start a Generic Job Trace

STRTRC   SSNID(*GEN)  JOB(*ALL/QSYS/QTVTELNET*)  MAXSTG(80000)

Cette commande démarre une nouvelle trace sur tous les travaux du système dont le nom de travail commence par QTVTELNET et qui s'exécutent sous le profil utilisateur QSYS. La mémoire maximale utilisée pour la trace est de 80000 kilooctets. Un identificateur de session unique est généré. This command starts a new trace on all jobs on the system that have a job name that begins with QTVTELNET and are running under the QSYS user profile. The maximum storage used for the trace will be 80000 kilobytes. A unique session identifier will be generated.

Exemple 4 : Démarrer une trace de travail avec un filtre Example 4: Start a Job Trace with a Filter

ADDTRCFTR   FTR(MYFTR)  PGMTRG(*EQ MYLIB/MYPGM *ALL *PGM *ENTRY)
STRTRC   SSNID(MYTRACE)JOB(123456/MYUSER/MYJOB)  TRCFTR(MYFTR)

Ces commandes ajoutent un filtre de trace pour MYPGM dans MYLIB. Lorsque la trace est démarrée, les enregistrements de trace appel/retour ne sont pas collectés tant que MYLIB/MYPGM n'est pas appelé. Une fois MYLIB/MYPGM appelé, la trace collecte les enregistrements de trace appel/retour jusqu'à la fin de la trace. These commands add a trace filter for MYPGM in MYLIB. When the trace is started, call/return trace records will not be collected until MYLIB/MYPGM is called. Once MYLIB/MYPGM is called, the trace will collect call/return trace records until the trace is ended.

Exemple 5 : Démarrer une trace de travail avec un composant défini Example 5: Start a Job Trace with Component Defined

STRTRC   JOB(123456/MYUSER/MYJOB)  SSNID(MYTRACE)
         TRCTYPE(*ENVVAR *VERBOSE)

Cette commande démarre une nouvelle trace sur le travail de nom MYJOB, de nom d'utilisateur de travail MYUSER et de numéro de travail 123456. Seul ce travail est tracé. L'identificateur de session de trace est MYTRACE. La trace collecte les informations de trace appel/retour ainsi que les informations du composant ENVVAR au niveau VERBOSE. This command starts a new trace on the job with job name MYJOB, job user name of MYUSER, and job number of 123456. Only this one job is traced. The trace session identifier is MYTRACE. The trace will collect call/return trace information as well as information for the ENVVAR component at VERBOSE level.

Exemple 6 : Démarrer une trace de travail avec sélection d'unités d'exécution Example 6: Start a Job Trace with Threads Selection

STRTRC   JOB((123456/MYUSER/MYJOB (11111111 22222222)))
         SSNID(MYTRACE)

Cette commande démarre une nouvelle trace sur le travail de nom MYJOB, de nom d'utilisateur de travail MYUSER et de numéro de travail 123456. Seules les unités d'exécution 11111111 et 22222222 sont tracées. L'identificateur de session de trace est MYTRACE. This command starts a new trace on the job with job name MYJOB, job user name of MYUSER, and job number of 123456. Only threads 11111111 and 22222222 are traced. The trace session identifier is MYTRACE.

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

STRTRC   SSNID(*GEN)  WCHMSG((MCH2804))
         WCHMSGQ((*SYSOPR) (*JOBLOG))
         WCHJOB((*ALL/MYUSER/MYJOBNAME))
         TRCPGM(MYLIB/TRCEXTPGM)

Cette commande démarre une trace sur le travail qui a appelé la commande STRTRC. 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 a trace on the job that called the STRTRC command. 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 8 : Démarrer une trace et surveiller une entrée du journal LIC pour l'arrêter Example 8: Start a Trace and Watch for a LIC Log Entry to End the Trace

STRTRC   SSNID(*GEN) WCHLICLOG(('99??' 9932 MYJOBNAME))
         WCHTIMO(*NOMAX)

Cette commande démarre une trace sur le travail qui a appelé la commande STRTRC. 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 ENDTRC soit émise manuellement. This command starts a trace on the job that called the STRTRC command. 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 ENDTRC command is issued manually.

Exemple 9 : Démarrer une trace en indiquant un sous-système Example 9: Start a Trace Specifying a Subsystem

STRTRC   SSNID(MYTRACE)
         JOB((123456/MYUSER/MYJOB (*ALL) *ALLSBS)
             (*ALL/*ALL/QPA* (*ALL) QINTER))

Cette commande démarre une nouvelle trace sur le travail de nom MYJOB, de nom d'utilisateur de travail MYUSER et de numéro de travail 123456, quel que soit le sous-système dans lequel se trouve le travail. Elle trace également tous les travaux dont le nom commence par QPA dans le sous-système QINTER. This command starts a new trace on the job with job name MYJOB, job user name of MYUSER, and job number of 123456 regardless of which subsystem the job is in. It also traces all jobs that have a job name that begins with QPA in the QINTER subsystem.

Exemple 10 : Démarrer une trace en demandant de définir les caractéristiques de trace dans un travail ou une unité d'exécution associé Example 10: Start a Trace Specifying to Set the Trace Characteristics in a Related Job or Thread

STRTRC SSNID(MYTRACE)
       JOB((123456/QUSER/QZRCSRVSD))
       JOINTRC(*YES)

Cette commande démarre une trace sur le travail 123456/QUSER/QZRCSRVSD. Si ce travail effectue un spawn ou génère du travail à exécuter dans l'un des travaux prédémarrés nommés QZRCSRVS, le travail ou l'unité d'exécution enfant hérite des caractéristiques de trace de 123456/QUSER/QZRCSRVSD. This command starts a trace on the job 123456/QUSER/QZRCSRVSD. If this job does a spawn or generates some work to be done in one of the prestart jobs named QZRCSRVS, the child job or thread will inherit the trace characteristics of 123456/QUSER/QZRCSRVSD.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF39C7
L'ID de session STRTRC &1 existe déjà. STRTRC session ID &1 already exists.
CPF39C9
Échec inattendu de STRTRC, voir les messages de bas niveau. Unexpected STRTRC failure, see low-level messages.
CPF39C5
Le nom de travail *ALL et l'utilisateur *ALL ne sont pas autorisés Job name *ALL and user *ALL not allowed
CPF39C6
Vous n'avez pas le droit d'effectuer une trace avec des utilisateurs de travaux génériques. Not authorized to trace with generic job users.
CPF39CC
Aucun travail actif trouvé, la session STRTRC n'a pas été démarrée. No active jobs found, STRTRC session not started.
CPF39F2
Impossible d'allouer la bibliothèque &1 Cannot allocate library &1
CPF98A2
Vous n'avez pas les droits sur la commande ou l'API &1. Not authorized to &1 command or API.
CPF39D3
Impossible de démarrer ou d'arrêter la trace. Unable to start/end the trace.
CPF39D4
Une autre session de trace ayant indiqué RESTRIPL(*YES) est déjà active. Another trace session is already active that specified RESTRIPL(*YES).
CPF39D5
Une autre session de trace ayant indiqué JOINTRC(*YES) est déjà active. Another trace session is already active that specified JOINTRC(*YES).
CPF39D6
Vous n'avez pas le droit de définir les caractéristiques de trace des travaux indiqués dans un travail ou une unité d'exécution associé. Not authorized to set the trace characteristics of the specified jobs in a related job or thread.
CPF9899
Erreur lors du traitement de la commande.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.