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.
AnalyzeSystemModule
Indique que les appels effectués par le module courant ne doivent pas être comptabilisés. Aucune des fonctions appelées depuis ce module, même dans d'autres modules, ne sont comptabilisées.
Cette instruction n'est plus utilisée.
Paramètres dans le registre
Il est possible de positionner les trois valeurs suivantes dans le registre de l'utilisateur (HKEY_CURRENT_USER) au chapitre Analyze :
FiltreModulesSysteme : (valeur par défaut = 1)
0=pas de filtrage des modules marqués par AnalyzeSystemModule.
1=les fonctions des modules marquées par AnalyzeSystemModule sont ignorées.
CompterChargementModules : (valeur par défaut = 0)
0=les temps de chargement des modules ne sont pas comptabilisés
1=les temps de chargement des modules sont comptabilisés.
CompterLinkFonction : ( valeur par défaut : 0)
0=les temps d'édition de lien des fonctions ne sont pas comptabilisés
1=les temps d'édition de lien des fonctions sont comptabilisés.

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

Instructions XPerf en Diva

Exécution des programmes en mode analyse