SQeeL program consists of one or more SQeeL source files.
SQeeL source file is provided in text format, which enables you creating and editing a file.
SQeeL source file name contains .eel and .eht as its extension.
SQeeL command automatically creates a binary file based on the source file.
Binary file is created only if necessary. SQeeL command checks the relationship between the source file and the existing binary file to determine whether executing the existing binary file or creating a new binary file.
You do not need to convert the file.
- Binary file does not exist
If the binary file does not exist, new binary file is created based on the source file.
- Binary file exists
If the latest binary file exists, SQeeL command executes the binary file.
- Binary file is older than the source file
If the existing binary file is older than the source file, new binary file is created.
- Source file does not exist
If the source file does not exist but the binary file exists, binary file is executed.
There are two types of executing SQeeL program.
- Execute a program in command prompt
- Execute a program in Web browser
This section describes a method of executing a program in a command prompt.
You can specify an option to execute SQeeL program.
sqeel [option[, option 2, ..]] file name
Following are list of option types and descriptions.
| SQeeL option |
| Option |
Argument |
Description |
| -c |
|
Convert a source file (.eel) to a binary file (.eex) to execute a program. |
| -l |
|
Execute a binary file. Source file is not converted to a binary file. |
| -e |
|
Execute a binary file if it is newer than a source file. If not, convert a source file to a binary file. (default) |
| -f |
func_name |
Execute func_name |
| -m |
memory_size |
Specify a memory size.32,000 is set to the default. Size is counted per the number of objects. |
| -s |
stack_size |
Specify stack size. 10,000 is set to the default. Size is counted per number of objects. |
| -C |
|
Run a program as CGI. |
| -L |
file_path |
Set a log file in file_path.If STDERR is set, logs are output at normal error. |
| -T |
level |
Set a trace level to any one of 0 to 6. Trace level controls the log output. If you set the trace level to larger number, detailed log will be output. If you set the trace level to 0, no logs will be output. |
| -H |
home_dir |
Set a home directory in home_dir. |
| -h |
|
List the usage instruction of the command line. |
UNIX environment enables you to directly launch eel program by inserting an interpreter line at the top of the program file.
In this case, follow the instruction below to specify the option.
| Example: Insert interpreter line in SQeeL program |
di#!/usr/local/bin/sqeel -Llog.txt,T5,m100000
global var1, var2
・
・
・ |
Enter a hyphen before the first option, and separate the rest of the options by comma.
SQeeL outputs a log when a source file is converted to a binary file, and when a program is being executed.
These logs can be used to debug the program.
- Log at binary conversion
When SQeeL detects an error in a source file while the source file is being converted to the binary file, SQeeL outputs a log at binary conversion process.
Log is named as the same source file name in the same directory but has different extension (.err).
If a directory already contains the same file name, it will be overwritten.
Logs are output only when an error is found in the source file.
- Log at execution
SQeeL outputs a log containing information regarding error and execution status of a program.
Normally, log file is named as eellog.txt in a current directory when SQL command launches.
If the directory already contains a log file, new log information will be added in the log file.
You can change a destination log file and log information by specifying an option.
- -L option
If you want to change the destination log file, use -L option.
-L option enables you to set a log file name.
If you specify STDERR in stead of the file name, logs are output at normal error.
- -T option
If you want to change the log information, use -T option.
-T option enables you to set the trace level to any one of 0 to 6.
If you set the trace level to larger, more detailed information will be output.
Top