Clarion Community Help

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
| **Navigation:**  [[introduction.htm|Language Reference]] > [[chapter runtime properties.htm|App C - PROP: Runtime Properties]] > Runtime VIEW and FILE Properties >====== PROP:Profile ====== | [[prop maxstatements.htm|{{btn_prev_n.gif|Previous page}}]][[chapter runtime properties.htm|{{btn_home_n.gif|Return to chapter overview}}]][[prop progressevents.htm|{{btn_next_n.gif|Next page}}]] |
|  ||

Property of a FILE that toggles logging out (profiling) all file I/O calls and errors returned by the file driver to a specified text file. Assigning a filename to PROP:Profile initiates profiling, while assigning an empty string ("") turns off profiling. Querying this property returns the name of the current logfile, and an empty string ("") if profiling is turned off.

**Example:**
<code>
filelabel{PROP:Profile} = 'TraceLog.txt' !turn ON logging and write to file: Tracelog.txt
filelabel{PROP:Details} = True           !turn ON logging record buffer contents/ details
filelabel{PROP:LogSQL}  = True           !turn ON logging of calls to the backend for SQL drivers

!File Access Code to be Logged
filelabel{PROP:Log} = 'Access Records for Vendor'  !PROP:Log writes a string value to the log file

filelabel{PROP:Profile} = ''             !turn OFF logging
</code>

Profile logging may be sent to the System Debugger or Debug View by specifying PROP:Profile as ** 'DEBUG:' **. This is only documented in the help topic [[Debugging your SQL application.htm|Debugging your SQL Application]].  

<code>
filelabel{PROP:Profile} = 'DEBUG:'   !turn ON logging to Debug View via OutputDebugString()

filelabel{PROP:Profile} = ''         !turn OFF logging
</code>

**See Also:** [[prop details 1.htm|PROP:Details]] , [[prop log 1.htm|PROP:LOG]] , [[prop logsql.htm|PROP:LOGSQL]] , [[prop profile 1.htm|PROP:Profile (SQL)]] , [[Debugging your SQL application.htm|Debugging your SQL Application]]