Profile

Use this command to summarize all Longview Application Framework processes and Smart Client interaction with Application Framework that are run from the time the command is set to ON until it is set to OFF. The summary is output to a text file, delimited with commas. For each command, function, procedure, model, import, export, DataSpec, data query, or Smart Client interaction with Application Framework, the output file indicates how many times it was called and how long it took to process, in seconds.

Note: The PROFILE command does not output values for RUN PROCEDURE commands, however, it does summarize the commands executed by the RUN PROCEDURE commands.

Syntax:

where:

• FileName is the name of a text file that will contain the output data. If the text file does not exist, it is automatically created. It can include a complete or partial folder path in the format C:\...\FileName. If FileName includes spaces, enclose it in double quotation marks; for example:

  "C:\My Documents\My Data.txt"

  Note: If the text file is in the same location as lv_af.exe, you do not need to specify the drive or path.

• APPEND is optional and adds the output to the existing text file.

Caution: If the text file already exists and APPEND is not specified, the existing text file is overwritten and any stored data is lost.

Syntax example:

Output syntax:

where:

• Type can be COMMAND, FUNCTION, PROCEDURE, MODEL, IMPORT, EXPORT, DATASPEC, DATAQUERY, or API.

  Note: API indicates Smart Client interaction with Application Framework.

• Name is the name of the Longview Application Framework process or item as specified by Type.
• TimesCalled is the number of times the process or item was called in all procedures and models executed.
• Duration is the amount of time, in seconds, required to execute the process or item in all procedures and models.
• TotalDuration is the total amount of time, in seconds, between the PROFILE ON and PROFILE OFF commands. This amount of time is approximately equal to the sum of the times for all commands listed in the text file that contains the output data. Times for other item types (such as PROCEDURE or MODEL) are not included in this approximate total, since the Duration time for these items includes the time of the command items that define the item type.

Output example: