SET PROFILE

From Recital Documentation Wiki
Jump to: navigation, search

Purpose

Control profiling


Syntax

SET PROFILE TO <command>, <id> [, <description>]

SET PROFILE ON | OFF


See Also

CLEAR PROFILE, DEBUG, DISPLAY PROFILE, DO, LIST PROFILE, PROFILE, SET COMPILE, SET DCACHE, SET DEVELOPMENT, SET ICACHE, SET IOLOGGING, SET IOSTATS, SET LOCKTYPE, SET NETWORK, SET REPLICATION, SET SYSLOGGING


Description

The SET PROFILE command controls Recital's profiling functionality. Profiling produces input/output, locking and procedure call statistics for a particular application or part of an application. This information can be used for analysis to enable application optimization and general performance tuning. The profiling information can be output to the screen, a file or a printer using the LIST PROFILE and DISPLAY PROFILE commands.


TO <command>, <id> [, <description>]

SET PROFILE TO <command>, <id> [, <description>] is used to start, stop or update the profiling statistics.


Keyword Description
<command> "start" - start a new profile for this <id>

"stop" - stop the profile for this <id>

"update" - update an existing profile for this <id>

<id> a unique reference for the profile of up to 10 characters.
<description> optional descriptive comment


ON | OFF

SET PROFILE ON | OFF enables or disables profiling. When SET PROFILE is OFF, no statistics are logged.


The PROFILE command can also be used to log statistics for a particular command or an entire program or application and will automatically list the statistics to the screen. CLEAR PROFILE is used to reset the log.


Example

set profile on
set profile to "start", "myapp", "Start of update section"
//...


Products

Recital Server, Recital