2. Components > 2. EXE-Compiler > 2.1.7 '#SPI:

'#SPI: - Special Instructions

Previous Top Next

Compiler-Directives

'#SPI: - Special Instructions

Used to modify several compile- and unpack behavior

Intention

Compiler-Directives start with the Sequence:

Which is a comment-sign on the left and then the #.

Because of the comment sign, the running script ignores these commands at Runtime (at time of script execution).

Autoinclude

Another feature, "Auto-Include" will automatically include used script files into the compiled "Stand-Alone" package. Files are known if they are used in an JNF.-Command. Also the complete filename must be resolved at compiletime.

Syntax:

'#SPI:[spi-code][|Parameter]

Parameter Explanation:

[spi-code] - a keyword out of the following. This will specify the special instruction.

SPI-Instructions for Compile-Time:

• forcewrite - no parameter, will make the compiler to overwrite already existing executables with that name. If omitted, executables will not be overwritten, but numbered.

• NoExe- no parameter, will make the compiler to skip creation of the executable.

SPI-Instructions that influence Unpack-Time-Action:

• SelfDel - no parameter, will make the Final executable to kill itself after it was started.

• NoWait- no parameter, will make the Final Executable to NOT wait for the script has been ended , and to NOT delete all temporary files.

• NoAPIKey - no parameter, will prevent the API-Keys from AIC.,AIS.,DLT., and SDO. - Command to be included automatically into the executable.

• Startfile= - you can specify another scriptfile as starting point. Needs a starting file as a parameter. Normally this file resides in "?path\".

• ProgressBox= - numeric parameter, will make a Progressbox appear at Unpack-Time.

• ProgressText1= - Textual parameter. Use this Text as headline for the Progressbox.

• ProgressText2= - Textual parameter. Use this Text as textine for the Progressbox.

• Mutex= - (0/1/2) numerical parameter. Specifies the type of Mutex to use.

• NoMutex - no parameter, will make it possible to start the same executable multiple times. This is normally prevented using "Mutexes".

• ShortTmp= -(1/2) Numerical parameter. specifies the path to a temporary folder that is used instead of the default temp-folder. It makes sense, to also use the "'#SPI:UTF"-Option also with this.

1 -> Drive from ?exeloc\

2 -> Drive from Windows-Folder

• UTF - no parameter. Specifies that a unique Temporary folder is been created inside the given Temporary folder, for the Runtime Environment.

• TargetFolder= - Textual parameter. specifies the path to a temporary folder that is used instead of the default temp-folder. Can use special folders. It makes sense, to also use the "'#SPI:UTF"-Option also with this.

• silent- numeric parameter, can be: 0,1 or 2.

0 - display an error message in case of an error before RunTime.

1 - (default mode) write a Textfile at the same location where the executable was started.

2 - complete silent. Does not do anything in case of an error, just ends the process.

• forceupdate - no parameter, will make the compiler to overwrite already existing files that are in the way of files that are being unpacked. This flag is mostly needed if files are being unpacked outside "?path\".

• DiskFree - Numerical parameter that specifies the amount of free Diskspace in MB, that must be free on the target drive, to unpack the Executable.

Some Special Instructions are only for debugging purposes.

These are:

• NoKill - no parameter, will make the compiler to NOT delete the internal compilation files after the compilation.

• TextOn - do not compile an executable, but an textual file that can easily be sent via e-mail. Needs to be decoded before it can be used. This option is not yet available.

Example:

'----------------------------------------

' Special Instructions

'----------------------------------------

' Special Instructions

'#SPI:ForceWrite

'#SPI:ForceUpdate

'#SPI:silent=0

'#SPI:NoExe

EXO.?path\

MBX.!

END.

Remarks:

Limitations:

Smart Package Robot 's "Script to Executable" Compiler

Smart Package Robot 's "Script to Executable" Compiler

'#SPI: - Special Instructions

Previous Top Next