STRJOBTRC
Démarrer trace de travail
Start Job Trace
En bref
La commande Démarrer trace de travail (STRJOBTRC) démarre la fonction de trace de travail afin de collecter des statistiques de performances pour le travail indiqué. The Start Job Trace (STRJOBTRC) command starts the job tracing function to collect performance statistics for the specified job.
STRJOBTRC se lit STR
(Démarrer) + JOBTRC.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
STRJOBTRC
Paramètres
-
MAXSTGMémoire maximale Maximum storage -
JOBNom du travail Job name -
THDIDID d'unité d'exécution à inclure Thread ID to include
Astuce : dans une session 5250, tapez STRJOBTRC 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 QPFR)
Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non
La commande Démarrer trace de travail (STRJOBTRC) démarre la fonction de trace de travail afin de collecter des statistiques de performances pour le travail indiqué. Elle lance la commande suivante : The Start Job Trace (STRJOBTRC) command starts the job tracing function to collect performance statistics for the specified job. It issues the following command:
STRTRC MAXSTG(maxstg) TRCFULL(*STOPTRC)
La valeur MAXSTG utilisée est soit la valeur par défaut de STRJOBTRC, soit une valeur indiquée. The MAXSTG value used is either the STRJOBTRC default or a specified value.
Une fois la trace de travail démarrée, un enregistrement de trace est généré pour chaque appel et retour externe (programme), exception, message et attente de poste de travail dans le travail. Au moins deux enregistrements de trace, et généralement plus, sont générés pour chaque instruction d'E/S (ouverture, fermeture, lecture, écriture) d'un programme en langage de haut niveau. Once job tracing is started, a trace record is generated for every external (program) call and return, exception, message, and work station wait in the job. At least two, and usually more, trace records are generated for every I/O statement (open, close, read, write) in a high-level language program.
Une fois les programmes cibles exécutés, la commande Terminer trace de travail (ENDJOBTRC) permet de désactiver la trace, d'enregistrer les informations collectées dans un fichier de base de données et, éventuellement, de produire des rapports servant à analyser les données. La commande Imprimer trace de travail (PRTJOBTRC) peut également servir à imprimer le même rapport à tout moment par la suite. Vous pouvez aussi indiquer *DLT pour le paramètre Option de données (DTAOPT) de la commande Terminer trace (ENDTRC) afin d'arrêter la trace de travail (la désactiver sans enregistrer les données collectées). After the target programs have been run, the End Job Trace (ENDJOBTRC) command is used to turn tracing off, record the collected information in a database file, and optionally produce reports used to analyze the data. The Print Job Trace (PRTJOBTRC) command may also be used to print the same report at any time thereafter. Alternatively, specifying *DLT for the Data option (DTAOPT) parameter of the End Trace (ENDTRC) command may be used to stop the job trace (turn it off without recording any collected data).
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| MAXSTG | Mémoire maximaleMaximum storage | 1-4000000, 10000 | Facultatif, positionnel 1 |
| JOB | Nom du travailJob name | Valeurs uniques: * Autres valeurs: Nom de travail qualifié |
Facultatif |
| Qualificatif 1 : Nom du travailQualificatif 1: Job name | Nom | ||
| Qualificatif 2 : UtilisateurQualificatif 2: User | Nom | ||
| Qualificatif 3: NuméroQualificatif 3: Number | 000000-999999 | ||
| THDID | ID d'unité d'exécution à inclureThread ID to include | Values (jusqu'à 20 répétitions): Valeur hexadécimale, *ALL | Facultatif |
Mémoire maximale (MAXSTG)Maximum storage (MAXSTG)
Indique la quantité maximale de mémoire à allouer à la mémoire tampon interne dans laquelle chaque enregistrement de trace généré est stocké. Si le nombre d'enregistrements de trace collectés suffit à remplir la mémoire tampon, la trace est automatiquement désactivée. Specifies the maximum amount of storage to allocate to the internal buffer in which every trace record generated is stored. If enough trace records are collected to fill the buffer, tracing is automatically turned off.
- 10000
- Une mémoire tampon de trace de 10 000 kilooctets est utilisée. A 10,000 kilobyte trace buffer is used.
- 1-16000
- Indiquez la taille de la mémoire tampon de trace, en kilooctets. Specify the size of the trace buffer, in kilobytes.
Nom du travail (JOB)Job name (JOB)
Indique le travail à tracer. Specifies the job to be traced.
Valeurs uniques
- *
- Le travail en cours est tracé. The current job is traced.
Qualificatif 1: Nom du travail Qualificatif 1: Job name
- nom
- Indiquez le nom du travail à tracer. Specify the name of the job to be traced.
Qualificatif 2: Utilisateur Qualificatif 2: User
- nom
- Indiquez le nom d'utilisateur du travail à tracer. Specify the user name of the job to be traced.
Qualificatif 3: Numéro Qualificatif 3: Number
- 000000-999999
- Indiquez le numéro à 6 chiffres du travail à tracer. Les 6 chiffres doivent être indiqués, zéros compris. Specify the 6-digit number of the job to be traced. All 6 digits must be specified, including zeros.
ID d'unité d'exécution à inclure (THDID)Thread ID to include (THDID)
Indique une liste d'au plus vingt unités d'exécution dont les appels et retours sont inclus dans la trace. Seuls les enregistrements de trace des identificateurs d'unité d'exécution indiqués sont inclus. Specifies a list of up to twenty threads whose calls and returns are included in the trace. Only trace records for the specified thread identifiers are included.
Valeurs uniques
- *ALL
- Les appels et retours de toutes les unités d'exécution sont inclus dans la trace. The calls and returns for all threads are included in the trace.
Autres valeurs (jusqu'à 20 répétitions)
- hexadecimal-value
- Indiquez les identificateurs d'au plus vingt unités d'exécution dont les enregistrements de trace doivent être inclus. Specify the identifiers of up to twenty threads whose trace records are to be included.
Exemples
STRJOBTRC MAXSTG(512)
Cette commande démarre la collecte des données de trace pour le travail en cours. Elle utilise une mémoire tampon de trace de 512 kilooctets (Ko). This command starts collecting trace data for the current job. It uses a 512 kilobyte (KB) trace buffer.
Messages d'erreur
Aucun None
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.