I enkeltstående tilstand er profileringsindstillinger angivet i en fil. Følgende beskriver det filformat og de gyldige profileringsindstillinger, der kan bruges i filen.
Kommentarer kan foretages i profilindstillingerne vha. *.
Linjen
* Dette er en kommentar i profilfilen
bliver f.eks. ignoreret af profilprogrammet under behandling af filen.
Alle andre linjer i filen har dette format format:
Parameternøgle |
Parameterværdi |
- MONITOR_MODE
- Denne parameter styrer, om overvågningsaktiviteter vises i sporingen. Overvågningsaktiviteter kan have to typer: Optagede overvågningsaktiviteter og ventende overvågningsaktiviteter. Optagede overvågningsaktiviteter finder sted, når en programdel forsøger at erhverve et overvågningsprogram, der allerede er erhvervet af en anden programdel. Ventende overvågningsaktiviteter finder sted, når en programdel venter på et overvågningsprogram, f.eks. ved at udføre metoden wait().
|
- all
- Alle overvågningsaktiviteter vises i sporingen.
- none
- Ingen overvågningsaktiviteter vises i sporingen.
|
- FILTERS
- Bruges til at angive, om de brugte filtre udskrives i starten af sporingen.
|
- true
- Udskriver filtrene i starten af sporingen.
- false
- Udskriver ikke filtrene i starten af sporingen.
|
- TRACK_GC_EVENT_TYPES
- Bruges til at angive, hvilken type renovationsaktiviteter der skal udskrives til sporingen. De to typer renovationsaktiviteter er objektfrigørelsesaktiviteter og objektflytningsaktiviteter.
|
- none
- Udskriv ikke renovationsaktiviteter.
- deletes
- frees
- Udskriv kun objektfrigørelsesaktiviteter.
- moves
- Udskriv kun objektflytningsaktiviteter.
- deletesAndMoves
- movesAndFrees
- Udskriv både objektfrigørelses- og objektflytningsaktiviteter.
|
- ID_STYLE
- Bruges til at angive de typer objekt-id'er, der udskrives. De mulige typer er Static ID og Relocatable ID.
En Static ID er i virkeligheden en id, der tildeles én gang til et objekt i sporingen, første gang det vises. Desuden ændres id'en ikke under udførelsen (heller ikke selvom JVM'en flytter objektet internt). Static-id'er bruges typisk af profilprogrammet.
En Relocatable ID er den id, som JVM'en knytter til objekter, og den kan ændres under udførelsen (f.eks. hvis der finder en objektflytning sted under renovation).
|
- static
- Udskriv kun Static ID'er
- relocatable
- Udskriv kun Relocatable ID'er
- staticAndRelocatable
- Udskriv både Static og Relocatable ID'er
|
- OPTIONS
- Bruges til at angive, om profileringsindstillingerne skal udskrives til sporingen.
|
- true
- Udskriv profileringsindstillingerne til sporingen.
- false
- Udskriv ikke profileringsindstillingerne til sporingen.
|
- TIMESTAMPS
- Bruges til at angive, om der skal udskrives tidsstempler i sporingen.
|
- true
- Udskriv tidsstempler.
- false
- Udskriv ikke tidsstempler.
|
- METHOD_COUNTS
- Bruges til at angive, om metodeantal skal udskrives efter sporingen.
|
- true
- Udskriv det samlede antal gange, de sporede metoder er kaldt, når sporingen er afsluttet, lige inden JVM'en afsluttes.
- false
- Udskriv ikke sporingsantal.
|
- OBJ_ALLOC_IS_ARRAY
- Bruges til at angive, om attributten isArray skal udskrives for objektallokeringer (dvs. når et objekt allokeres, er det enten et array, eller også er det ikke. Attributten isArray indeholder disse oplysninger).
|
- true
- Udskriv attributten isArray.
- false
- Udskriv ikke attributten isArray.
|
- STACK_INFORMATION
- Denne indstilling bruges til at angive, hvilken type metodesporing der skal udføres.
|
- none
- Udfør ikke nogen metodesporing. Dette svarer til IKKE at vælge Analyse af udførelsestid i profilkonfigurationsvinduet på arbejdsbænken.
- normal
- Spor alle ikke-filtrerede metoder.
- boundary
- Spor alle ikke-filtrerede metoder PLUS alle grænsemetoder. Det svarer til at have valgt Profilkonfiguration > Analyse af udførelsestid > Opsaml grænseklasser, der er ekskluderet af det angivne filter på arbejdsbænken.
- contiguous
- Spor alle ikke-filtrerede metoder PLUS alle filtrerede metoder, der finder sted på metodekaldstakken, der befinder sig mellem to ikke-filtrerede metoder. Lad os f.eks. antage, at metodeA kalder metodeB, som kalder metodeC, som kalder metodeD. Lad os endvidere antage, at metodeA og metodeD ikke er filtrerede, men at metodeB og metodeC er. Da metodeB og metodeC ligger mellem to ikke-filtrerede metoder, bliver de også sporet.
- boundaryAndContiguous
- Samme funktionsmåde som hvis både parameteren contiguous og parameteren boundary er angivet til STACK_INFORMATION.
|
- BOUNDARY_DEPTH
- Bruges til at angive dybden af grænsesporingen, når STACK_INFORMATION=boundary
eller boundaryAndContiguous.
|
- Integer
- Heltalsværdi, der angiver dybden af grænsesporingen.
|
- TICKET
- Bruges til at angive, om attributten ticket skal vises i sporingen.
|
- true
- Attributten ticket skal vises i sporingen.
- false
- Attributten ticket skal ikke vises i sporingen.
|
- TRACE_MODE
- Bruges til at angive sporingstilstanden. Helt grundlæggende angiver sporingstilstanden, om objektoplysningerne (hob) spores eller ej. Værdien "none" har en særlig betydning.
|
- full
- Spor alle mulige objektoplysninger. Det vil sige: Spor objektallokeringer og spor de objekter, der er knyttet til metodestarter, hvis STACK_INFORMATION er angivet til at udføre metodesporing.
- none
- Udfør ingen sporing overhovedet. Hvis værdien er angivet, bliver parameteren STACK_INFORMATION tilsidesat, også selvom den er angivet til at spore metodekald.
- noObjectCorrelation
- Spor ikke objektoplysninger. Dette er anderledes end værdien "none", da sporing af metodekald stadig kan finde sted (hvis STACK_INFORMATION er angivet korrekt), men de objekter, der er knyttet til metodestarter, bliver ikke sporet, og det gør oplysninger om objektallokering heller ikke.
|
- TRACE_ID_REFS
- Bruges til at angive, om den id, der bruges til at referere til sporingen, skal udskrives. Sporings-id'en er entydig for sporingen.
|
- true
- Udskriv sporings-id'en.
- false
- Udskriv ikke sporings-id'en.
|
(C) Copyright IBM Corporation 2000, 2006. All Rights Reserved.