Scripting Methods → Resultcodes/Logfile

Each command in a script generates a result code and an optional explanation. Result codes are categorized in the following ranges:

100-199 : Intermediate result, eventually followed by an final resultcode of 200 or higher.
200-299 : Successful operation
400-499 : Temporary failure of operation (e.g. phone busy)
500-599 : Fatal faliure (e.g. file not found, number not available, etc)

Any result code higher than 299 will normally terminate the script. However, if you want to continue with a script, regardless of a certain command's result, you can either use the OnError command or prefix a single command with a dash ("-") to ignore a potential error. (This will override the current OnError setting.)
 

All commands and their result codes will be listed in the log file. Since log files will often be analyzed by other applications, log file entries are clearly structured:

ssss.tt - cxxxxxxxxxxxxxxxxxxxxxxxx
4 digits time in seconds since starting the program
a decimal point
two digits 1/100 seconds
two space characters
a dash character
two space characters
one class-character of "%", "$" or "#"
more data depending on the class of entry

There are three classes of logfile entries:
% : Informational (date, time, script name, computer generated commands, etc)
$ : Executed command (the commands from your script)
# : command results (followed by the three digit result code)

Here is a typical example:

 
← Back to Scripting Methods