INCLUDE

Action

INCLUDE tells KiXtart to treat the contents of a specified file as if those contents had appeared in the script at the point where INCLUDE appears. You can organize script code into include files and then use INCLUDE to add this code to any script.

Include files can be "nested"; that is, an INCLUDE statement can appear in a file named by another INCLUDE statement. Nesting of include files can continue up to 20 levels.

INCLUDE is most useful when pre-tokenizing files: include-files are effectively merged with the script containing the INCLUDE statements and the end-result is stored as a single pre-tokenized file.

Syntax

INCLUDE "include-scriptname"

Include-scriptname can include an absolute path (“C:\SCRIPTS”) or a relative path (“..\DATA\SCRIPTS”). If you specify a relative path, the path is calculated from the current directory of the KiXtart process.

Remarks

Note that INCLUDE statements are processed during the pre-processing phase of KiXtart at which point macros, variables and functions are not yet available. As such, INCLUDE only supports a single, flat string and you can not use macros, variables or functions in it.