The _PGOPTI_Set_Interval_Prof_Dump() function activates Interval Profile Dumping and sets the approximate frequency at which dumps occur. This function is used in non-terminating applications.
The prototype of the function call is listed below.
Syntax |
|---|
|
void _PGOPTI_Set_Interval_Prof_Dump(int interval); |
This function is used in non-terminating applications.
The interval parameter specifies the time interval at which profile dumping occurs and is measured in milliseconds. For example, if interval is set to 5000, then a profile dump and reset will occur approximately every 5 seconds. The interval is approximate because the time-check controlling the dump and reset is only performed upon entry to any instrumented function in your application.
Setting the interval to zero or a negative number will disable interval profile dumping, and setting a very small value for the interval may cause the instrumented application to spend nearly all of its time dumping profile information. Be sure to set interval to a large enough value so that the application can perform actual work and substantial profile information is collected.
You can use the profmerge tool to merge the .dyn files.
Call this function at the start of a non-terminating user application to initiate Interval Profile Dumping. Note that an alternative method of initiating Interval Profile Dumping is by setting the environment variable, PROF_DUMP_INTERVAL, to the desired interval value prior to starting the application.
The intention of Interval Profile Dumping is to allow a non-terminating application to be profiled with minimal changes to the application source code.