SetTraceFileName

Description

Specifies the name of the trace file PocketBuilder will analyze when the BuildModel function is called.

Applies to

Profiling and TraceTree objects

Syntax

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 PocketBuilder will analyze

Returns

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.

Usage

Use this function to specify the trace file PocketBuilder should analyze with the BuildModel function. You call the SetTraceFileName function before calling the BuildModel function.

Examples

Example 1

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()

...