%ESLProfileStart function


Function
The function enables/disables profiling of the ESL script execution.
Declaration
%ESLProfileStart(
   BOOL in init  
 )
Parameters
init@TRUE - enables the acquisition of debugging information.
@FALSE - disables the acquisition of debugging information and writes the intermediate data.
Description
At the moment of calling the function %ESLProfileStart(@TRUE), all lines executed in all running ESL scripts begins to record.

After calling the function %ESLProfileStart(@FALSE), data of the scripts is to be recorded in the file Esl.script_name_instance_id.profiler (e.g. Esl.e.myscript_1250.profiler) in the subdirectory \Log of the installation directory and the acquisition of debugging information is stopped.

The %ESLProfileStart function can be called again with the @TRUE parameter and the debugging information can be acquired again.

Format of written data:

line; count; line duration; action duration; action status; line text; ActionType; Use Pragma ;DataSize ;Use PragmaRPC; DataSizeRPC

lineThe row number.
countThe number of row repetitions.
line durationThe total duration of row execution.
action durationThe duration when inactive action waits for execution of the required activity.
action statusSignalizes the status of action used.
line textThe text of the executed line.
ActionTypeIt is defined if a synchronous action %HI_* is executed on the line..
Use PragmaIt is defined if the action PRAGMA was used.
DataSizeThe size of data that have not been copied among the procedures in one ESL script when using PRAGMA.
Use PragmaRPCIt is defined if PRAGMA was used for RPC procedures.
DataSizeRPCThe size of data that have not been copied among RPC procedures of ESL scripts on the same event handler if PRAGMA was used for RPC procedures.

If some of the scripts is terminated or picture is closed before calling of the %ESLProfileStart(@FALSE) the file *.profiler will be generated immediately.
This mechanism works only for the scripts that were initiated when the debug variable DBG.ACTIONS.ENABLE_PROFILE_INFO had been running. It is disabled by default.
At the start of process it may be activated by parameter /E+DBG.ACTIONS.ENABLE_PROFILE_INFO on the command line, or when the process is run by D2000 System Console.
Napíšte komentár