Specifies the name of the trace file PowerBuilder will analyze when the BuildModel function is called.
Profiling and TraceTree objects
instancename.SetTraceFileName ( tracefilename )
Argument |
Description |
---|---|
instancename |
Instance name of the Profiling or TraceTree object |
tracefilename |
A string that identifies the name of the trace file PowerBuilder will analyze |
ErrorReturn. Returns one of the following values:
Success! – The function succeeded
FileOpenError! – The file could not be opened
FileInvalidFormatError! – The trace file is not in the correct format
ModelExistsError! – A model has already been built
If an error occurs, the name is not set.
Use this function to specify the trace file PowerBuilder should analyze with the BuildModel function. You call the SetTraceFileName function before calling the BuildModel function.
This example provides the name of the trace file for which a performance analysis model is to be built:
Profiling lpro_model
String ls_line
lpro_model = CREATE Profiling
lpro_model.SetTraceFileName (filename)
ls_line = "CollectionTime = " + & String(lpro_model.CollectionTime ) + "~r~n" & + "Num Activities = " & + String(lpro_model.NumberOfActivities) + "~r~n"
lpro_model.BuildModel()
...