Description
Assigns the specified name to a program execution thread. The new thread name appears in all Quantify data windows and views that display thread names.
Syntax
int QuantifySetThreadName (char *ThreadName)
where ThreadName represents a character string.
Returns
0 |
|
Notes
§ This function is especially useful for assigning unique labels to threads whose start function names Quantify cannot determine. Quantify labels these threads .thread_<OrdinalNumber>, where <OrdinalNumber> is a sequence number that is incremented for each new instance of a thread. If your application launches unnamed threads in a non-deterministic order, Quantify may not be able to match identical threads when you compare runs. To ensure that measurement data is correctly compared between program runs, use QuantifySetThreadName in your program code to assign special names to the threads you are interested in.
§ When you rename a thread whose label contains an ordinal number, Quantify resequences the ordinals of all threads. For example, if you rename thread .thread_2., Quantify renames .thread_3. to .thread_2., .thread_4. to .thread_3., and so on.
§ You can use the Rename Thread dialog box to rename active threads.
(C) Copyright IBM Corporation 1993, 2009.