Trace

<< Click to Display Table of Contents >>

 

Trace

Trace(MessageText, [LogTimeStamp], [BreakLine])

This method allows registering messages in a text file. These messages are stored in a file with the same name and path of Domain's file, with a .txt extension. Each new message is always added at the end of this file. If there is a failure when saving messages to this file (such as access denied, no space on disk, etc.), a script error occurs. Additionally, this message is registered in E3's log file. This method can be used, for example, to register debugging messages for scripts executed in a server.

Parameters of the Trace method

Parameter

Description

MessageText

A user-defined message

LogTimeStamp

A Boolean indicating whether each record must contain a timestamp. This parameter is optional and, if omitted, assumes a True value

BreakLine

A Boolean indicating whether a line break must exist at the end of each message. If this parameter is set to False, that forces the file to have all records on a single line. This parameter is optional and, if omitted, assumes a True value

Was this page useful?