以獨立模式側寫應用程式所用的側寫選項

採用獨立模式時,側寫選項是在檔案中指定。 下面將說明這個檔案格式以及該檔所能使用的有效側寫選項。

您可以使用 *,在側寫選項檔中寫下註解。 比方說,側寫程式在處理該檔時,就會略過
* This is a comment in the profile file
這一行。
該檔中其他的字行,則採用下述格式:

<option_key> = <option_value>
下表將列出側寫的有效選項索引鍵-選項值配對:
選項索引鍵 選項值
MONITOR_MODE
這個選項可以控制監視器事件是否會出現在追蹤當中。 監視器事件有兩種:監視器競爭事件,以及監視器等待事件。監視器競爭事件是在執行緒想要取得已被另一個執行緒取得的監視器時發生。 執行緒在監視器上等待時(例如,執行 wait() 方法),即表示發生監視器等待事件。
all
所有的監視器事件都會出現在追蹤當中。
none
沒有一個監視器事件會出現在追蹤當中。
FILTERS
用來指定是否會在追蹤開始時印出用過的過濾器。
true
在追蹤開始時印出過濾器。
false
不在追蹤開始時印出過濾器。
TRACK_GC_EVENT_TYPES
用來指出要列印哪一類記憶體回收 (GC) 事件到追蹤。GC 事件有兩種類型,一種是物件釋出事件,另一種是物件移動事件。
none
不印出任何 GC 事件。
deletes
frees
只印出物件釋出事件
moves
只印出物件移動事件
deletesAndMoves
movesAndFrees
印出物件釋出和物件移動兩者。
ID_STYLE
用來指定列印的物件 ID 的類型。可能的類型有靜態 ID可重新配置的 ID。 基本上,「靜態 ID」是物件第一次出現在追蹤內時指定給物件的一次式 id。 再者,id 在執行期間不會變動(即使 JVM 在內部移動物件)。 靜態 ID 通常是由側寫程式所使用。
「可重新配置的 ID」是 JVM 和物件建立關聯的 id,在執行期間可能變更(例如,在記憶體回收期間,發生物件移動事件)。
static
只列印靜態 ID
relocatable
只列印可重新配置的 ID
staticAndRelocatable
列印靜態和可重新配置的 ID
OPTIONS
用來指定側寫選項是否應該列印到追蹤。
true
將側寫選項列印到追蹤。
false
不將側寫選項列印到追蹤。
TIMESTAMPS
用來指定是否應該在追蹤當中列印時間戳記。
true
列印時間戳
false
不列印時間戳
METHOD_COUNTS
用來指定是否應該在追蹤結尾列印方法計數。
true
列印被追蹤的方法在追蹤結束時被呼叫的次數,然後立即關閉 JVM。
false
不列印方法計數。
OBJ_ALLOC_IS_ARRAY
用來指定是否要印出物件配置的 isArray 屬性。(也就是說,物件在配置時,可能是呈陣列形式,也可能不是;isArray 屬性含有這項資訊)。
true
列印 isArray 屬性。
false
不列印 isArray 屬性。
STACK_INFORMATION
這個選項用來指定應該執行哪一種類型的方法追蹤。
none
不執行任何方法追蹤。它相當於在工作台的「側寫配置」視窗中,「不」選取執行時間分析
normal
追蹤所有未經過濾的方法。
boundary
追蹤所有未經過濾的方法,以及所有的界限方法。它相當於在工作台選取側寫配置 > 執行時間分析 > 收集被過濾器集排除的界限類別
contiguous
追蹤所有未經過濾的方法,以及在兩個未過濾方法之間,所有在方法呼叫堆疊所發生的已過濾方法。 比方說,假設 methodA 呼叫 methodB,而 methodB 呼叫 methodC,而 methodC 又呼叫 methodD。 更進一步的說,假設 methodA 和 methodD 都未經過濾,但是 methodB 和 methodC 有。 由於 methodB 和 methodC 是介於那兩個未經過濾的方法之間,因此它們也會受到追蹤。
boundaryAndContiguous
作用同於在 STACK_INFORMATION 中設定 contiguous 和 boundary 選項值。
BOUNDARY_DEPTH
在 STACK_INFORMATION=boundary 或 boundaryAndContiguous 時,用來指定界限追蹤深度。
Integer
為一整數值,可指定界限追蹤深度。
TICKET
用來指定 ticket 屬性是否會出現在追蹤當中。
true
Ticket 屬性應該會出現在追蹤當中。
false
Ticket 屬性不應出現在追蹤當中。
TRACE_MODE
用來指定追蹤模式。基本上,追蹤模式可以指定是否要持續追蹤物件(資料堆)資訊。('none' 值具有特殊意義)。
full
追蹤所有可能的物件資訊。 換句話說,追蹤物件配置,以及追蹤與方法呼叫相關的物件(如果 STACK_INFORMATION 設為方法追蹤)。
none
不做任何追蹤。(如果設定了這個值,就會置換 STACK_INFORMATION 選項,即使它被設為追蹤方法呼叫也一樣)。
noObjectCorrelation
不追蹤物件資訊。這與 'none' 值不同,因為它仍然會執行方法呼叫追蹤(如果有妥善設定 STACK_INFORMATION 的話), 只是不追蹤與方法呼叫相關的物件,也不追蹤任何物件配置資訊。
TRACE_ID_REFS
用來指定是否要印出追蹤 ID 參照屬性。追蹤參照 ID 是追蹤的專屬 ID。
true
印出追蹤 ID 參照屬性。
false
不印出追蹤 ID 參照屬性。

相關作業
側寫應用程式
以獨立模式側寫應用程式

相關參照
在 AS/400 側寫應用程式的限制