STRPFRTRC

Démarrer trace performance

En bref

La commande STRPFRTRC est une interface simplifiée avec la commande TRCINT pour la collection de données de trace MPL (Multiprogramming level) et de transaction.

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

Syntaxe minimale

STRPFRTRC

Paramètres

SIZE Taille de la table de trace Trace table size
OMTTRCPNT Omettre les points de trace Omit trace points
JOBTYPE Types de travaux
JOBTRCITV Intervalle de trace travaux

Astuce : dans une session 5250, tapez STRPFRTRC 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 STRPFRTRC est une interface simplifiée avec la commande TRCINT pour la collection de données de trace MPL (Multiprogramming level) et de transaction. Cette commande collecte les mêmes données de trace de performance que celles collectées dans les éditions précédentes par la commande STRPFRMON (Démarrer moniteur performances).

La trace démarrée par cette commande crée et utilise la table de trace QPM_STRPFRTRC. Si cette dernière existe, toutes les données existantes seront supprimées avant le début de cette trace.

La trace peut être arrêtée et les données peuvent être écrites dans un fichier base de données à l'aide de la commande ENDPFRTRC.

Restrictions :

Cette commande est livrée avec le droit *EXCLUDE public.
Les profils utilisateur suivants sont dotés des droits privés d'utilisation de cette commande :
- QSRV

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
SIZE	Trace table size	Valeurs uniques: CALC, MAX Autres valeurs: Liste d'éléments	Facultatif, positionnel 1
	Élément 1: Nombre d'unités	1-998000
	Élément 2: Unit of measure	KB, MB
OMTTRCPNT	Omit trace points	NONE, RSCMGT	Facultatif
JOBTYPE	Types de travaux	Valeurs uniques: NONE, ALL Autres valeurs (jusqu'à 12 répétitions): DFT, ASJ, BCH, EVK, INT, MRT, RDR, SBS, SYS, WTR, PDJ, PJ, *BCI	Facultatif
JOBTRCITV	Intervalle de trace travaux	0.1-9.9, 0.5	Facultatif

Trace table size (SIZE)

Indique la taille de la table de trace.

Remarque :La mémoire indiquée à ce paramètre est immédiatement allouée à partir du pool de mémoire secondaire système (ASP 1). Pour plus d'informations relatives à la définition de la taille de la table de trace, reportez-vous au paramètre SIZE de la commande TRCINT (Tracer les internes).

Il n'est pas recommandé d'indiquer une taille inférieure à 16 mégaoctets.

Valeurs uniques

*CALC: La taille minimale de la table de trace est déterminée en fonction du groupe du processeur de votre système.
*MAX: La table de trace est définie sur la taille maximum, 258048 mégaoctets.

Elément 1 : Nombre d'unités

Indiquez la taille de la table de trace.

1-998000: Indiquez la taille de la table de trace en kilooctets ou en mégaoctets.

Elément 2 : Unit of measure

Indique si la valeur précisée pour le premier élément de ce paramètre doit être appréhendée comme un nombre de kilo-octets ou de mégaoctets.

*KB: La taille de la table de trace est indiquée en kilo-octets. L'éventail des valeurs est compris entre 128 et 998000.
*MB: La taille de la table de trace est indiquée en mégaoctets. L'éventail des valeurs est compris entre 1 et 258048.

Omit trace points (OMTTRCPNT)

Indique les points de trace dont les enregistrements de trace doivent être exclus.

*NONE: Aucun point de trace ne doit être exclu.
*RSCMGT: Les points de trace de gestion de ressource (données de conflit de verrouillage) seront exclues de la trace.

Types de travaux (JOBTYPE)

Indique les types de travaux pour lesquels les données de trace doivent être collectées pour une utilisation dans le rapport de trace de travail par lots.

Remarque :La valeur *DFT inclut les valeurs *ASJ, *BCH, *EVK, *MRT, *PDJ, *PJ et *BCI. La valeur *BCH inclut les valeurs *EVK, *MRT, *PDJ, *PJ et *BCI.

Valeurs uniques

*NONE: Il n'existe aucun travail à tracer.
*ALL: Tous les types de travaux doivent être tracés.

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

*DFT: Travaux par lots et à démarrage automatique.
*ASJ: Travaux à démarrage automatique.
*BCH: Travaux par lots.
*EVK: Travaux lancés par une demande de démarrage de procédure.
*INT: Travaux interactifs.
*MRT: Travaux de type MRT.
*RDR: Travaux du lecteur.
*SBS: Travaux du moniteur du sous-système.
*SYS: Les travaux systèmes sont tracés.
*WRT: Travaux de l'éditeur.
*PDJ: Travaux d'impression.
*PJ: Travaux à démarrage anticipé.
*BCI: Les travaux immédiats par lots sont tracés.

Intervalle de trace travaux (JOBTRCITV)

Indique l'intervalle de temps (en secondes CPU) à utiliser entre chaque collecte des données de trace du travail.

0,5: La valeur d'intervalle de temps 0,5 UC secondes est utilisée.
0.1-9,9: Indiquez, en secondes CPU, l'intervalle de trace à utiliser.

Exemples

STRPFRTRC   SIZE(*CALC)

Cette commande permet de démarrer la collecte de données de trace de performances. La taille de la table de trace peut être ajustée au minimum calculé. Cet exemple a pour résultat une table de trace de même taille et les mêmes données que la commande STRPFRMON TRACE(*ALL) DMPTRC(*NO).

Messages d'erreur

*ESCAPE Messages

CPF0A2A: Trace de performances déjà démarrée

Pour les autres messages, veuillez également vous reporter à la commande TRCINT.