Instructions XPerf en Diva

Diva dispose d'instructions pour démarrer, suspendre et reprendre une analyse.

AnalyzeStart ([ NiveauxDePile], [GarderLignes])

Démarrer l'analyse de performances.
Paramètres
Niveaux de pile
Nombre de niveau de piles à conserver. 0 = ne pas garder les piles.
Valeur par défaut : 0
GarderLignes
Booléen indiquant s'il faut garder les numéros de lignes dans les piles.

AnalyzePause
Suspendre l'analyse des performances.

AnalyzeContinue
Reprise de l'analyse des performances.

Exécution des programmes en mode analyse

Lancement depuis Xwin
Dans les paramètres du sous-projet, vous pouvez demander que les programmes soient exécutés "Avec analyseur de performances".
Les paramètres complémentaires sont :

Garder les numéros de ligne

Cette option est liée à la pile. Elle permet de garder le numéro de ligne de l'appel d'une fonction.
Exemple :
1 procedure A
2 beginp
3 endp
4
5 main
6 1 i X
7 A
8 for i = 1 to 2
9 A
10 next
Si les numéros de lignes sont gardés, dans le résultat nous voyons que la procédure A a été appelée depuis Main une fois en ligne 7 et deux fois en ligne 9. Si les numéros de ligne ne sont pas gardés, dans le résultat nous voyons que la procédure A a été appelée trois fois depuis Main.
Le fait de garder les numéros de ligne va augmenter la quantité d'informations gardées par l'analyseur mais offre une plus grande finesse d'analyse.
Cette option nécessite que les objets soient compilés avec l'option Debug.

Nombre de niveau de la pile à garder

Indique combien de niveaux de pile vous voulez garder (0 = ne pas garder les piles).
Le fait de garder les piles ralenti l'exécution du programme, mais ne fausse pas les résultats de l'analyse. Le temps passé dans la gestion du stockage des piles est déduit.

Chaque exécution de programme (F5 ou Ctrl-F5) va alors générer un rapport d'analyse.
Les programmes lancés par ProgramCall ou ProgramGoto généreront également un rapport d'analyse distinct.

Lancement depuis une icône (applications de la version 7)
Dans les paramètres d'une icône du bureau vous pouvez demander à lancer le programme en mode analyse.
Les paramètres à ajouter à la ligne de commande sont :
/div /analyze -n nombre_de_niveaux -l avec_numéros_ligne /enddiv
Nombre_de_niveaux : Nombre de niveaux de la pile que vous désirez garder.
Avec_numéros_ligne : 0 = non 1 = oui

Lancement de l'analyse depuis le programme Diva
L'instruction Diva AnalyzeStart ( [NiveauxDePiles], [GarderLignes]) permet de lancer l'analyse du programme courant.
Voir [Instructions Diva].

Fichier résultat
Pour chaque programme lancé en mode Analyse, un fichier est créé dans le répertoire /divalto/divaltoLog/perf.
Le nom du fichier est composé de la manière suivante : NomDuProgramme_date_heure_utilisateur.xml.
Exemple : harmony-dhop_22-06-2009_09-19-03_bhouver.xml

Remarque
Après l'appel à la fonction de réinitialisation du module Ymig, les noms des fonctions des masques déchargés sont perdus et ne peuvent être affichés.
Voir [Instructions Diva] pour les paramètres qu'il est possible de positionner dans le registre.

Diva xperf

Exécution des programmes en mode analyse