Directives and Built-in Functions (Target Language Compiler)

Target Language Compiler

Command Line Arguments

To call the Target Language Compiler, use

tlc [switch1 expr1 switch2 expr2 ...] filename.tlc

This table lists the switches you can use with the Target Language Compiler. Order makes no difference. Note that if you specify a switch more than once, the last one takes precedence.

Table 6-8: Target Language Compiler Switches
Switch
Meaning

-r filename
Reads a database file (such as a .rtw file). Repeat this option multiple times to load multiple database files into the Target Language Compiler. Omit this option for target language programs that do not depend on the database.

-v[number]
Sets the internal verbosity level to <number>. Omitting this option sets the verbosity level to 1.

-Ipath
Adds the specified directory to the list of paths to be searched for TLC files.

-Opath
Specifies that all output produced should be placed in the designated directory, including files opened with %openfile and %closefile, and .log files created in debug mode. To place files in the current directory, use
-O (use the capital letter O, not zero).

-m[number]
Specifies the maximum number of errors to report is <number>. If no -m argument appears on the command line, it defaults to reporting the first five errors. If the <number> argument is omitted on this option, 1 is assumed.

-x0
Parse TLC file only (do not execute).

-lint
Performs some simple checks for performance and deprecated features.

-p[number]
Print a dot ('.') indicating progress for every <number> of TLC primitive operations executed.

-d[a|c|f|n|o]
Invoke the TLC's debug mode.
-da makes TLC execute any %assert directives. However, when building from within RTW, this flag is not needed and will be ignored, as it is superseded by the Enable TLC Assertions check box on the TLC debugging section of the Real-Time Workshop dialog page.
-dc invokes TLC's command line debugger.
-df filename invokes the TLC debugger and runs a debugger script as specified by filename. A debugger script is a text file containing valid debugger commands. TLC searches only the current working directory for the script file.
-dn will cause TLC to produce log files indicating which lines were and were not hit during compilation.
-do will disable TLC's debugging behavior.

-a[ident]=expr
Specifies an initial value, <expr>, for the identifier, <ident>, for some parameters; equivalent to the %assign command.

**Table 6-8: Target Language Compiler Switches**
Switch	Meaning
`-r filename`	Reads a database file (such as a `.rtw` file). Repeat this option multiple times to load multiple database files into the Target Language Compiler. Omit this option for target language programs that do not depend on the database.
`-v[number]`	Sets the internal verbosity level to `<number>.` Omitting this option sets the verbosity level to `1`.
`-Ipath`	Adds the specified directory to the list of paths to be searched for TLC files.
`-Opath`	Specifies that all output produced should be placed in the designated directory, including files opened with `%openfile` and `%closefile`, and `.log` files created in debug mode. To place files in the current directory, use `-O` (use the capital letter O, not zero).
`-m[number]`	Specifies the maximum number of errors to report is `<number>`. If no `-m` argument appears on the command line, it defaults to reporting the first five errors. If the `<number>` argument is omitted on this option, 1 is assumed.
`-x0`	Parse TLC file only (do not execute).
-`lint`	Performs some simple checks for performance and deprecated features.
`-p[number]`	Print a dot (`'.'`) indicating progress for every `<number>` of TLC primitive operations executed.
`-d[a\|c\|f\|n\|o]`	Invoke the TLC's debug mode. `-da` makes TLC execute any `%assert` directives. However, when building from within RTW, this flag is not needed and will be ignored, as it is superseded by the Enable TLC Assertions check box on the TLC debugging section of the Real-Time Workshop dialog page. `-dc` invokes TLC's command line debugger. `-df` `filename` invokes the TLC debugger and runs a debugger script as specified by `filename`. A debugger script is a text file containing valid debugger commands. TLC searches only the current working directory for the script file. `-dn` will cause TLC to produce log files indicating which lines were and were not hit during compilation. `-do` will disable TLC's debugging behavior.
`-a[ident]=expr`	Specifies an initial value, `<expr>`, for the identifier, `<ident>`, for some parameters; equivalent to the `%assign` command.

As an example, the command line

```
tlc -r Demo.rtw -v grt.tlc
```

specifies that Demo.rtw should be read and used to process grt.tlc in verbose mode.

Target Language Functions Filenames and Search Paths