Debugging TLC Files (Target Language Compiler)

Target Language Compiler

TLC Debugger Command Summary

Table 7-1, TLC Debugger Commands, summarizes the TLC debugger commands.

To obtain more detailed help on individual commands, type

```
help command 
```

from within the TLC debugger, as in this example:

```
TLC-DEBUG> help clear
```

You can abbreviate any TLC debugger command to its shortest unique form. For example,

```
TLC-DEBUG> break warning
```

can be abbreviated to

```
TLC-DEBUG> br warning
```

To view a complete list of TLC debugger commands, type help at the TLC-DEBUG> prompt.

Table 7-1: TLC Debugger Commands
Command
Description

assign variable=value
Change a variable in the running program.

break ["filename":]line|error|warning|trace| function
Set a breakpoint. See also
%breakpoint Directive

clear [breakpoint#|all]
Remove a breakpoint.

condition [breakpoint#] [expression]
Attach a condition to a breakpoint

continue ["filename":]line|function
Continue from a breakpoint.

disable [breakpoint#]
Disable a breakpoint.

down [n]
Move down the stack.

enable [breakpoint#]
Enable a breakpoint.

finish
Break after completing the current function

help [command]
Obtain help for a command.

ignore [breakpoint#]count
Set the ignore count of a breakpoint

iostack
Display contents of I/O stack

list start[,end]
List lines from the file from start to end.

loadstate "filename"
Load debugger breakpoint state from a file

next
Single step without going into functions.

print expression
Print the value of a TLC expression. To print a record, you must specify a fully qualified "scope" such as CompiledModel.System[0].Block[0].

quit
Quit the TLC debugger. You can also exit the debugger by typing Ctrl + C at the prompt.

run "filename"
Run a batch file of command line debugger commands

savestate "filename"
Save debugger breakpoint state to a file

status
Display a list of active breakpoints.

step
Step into.

stop ["filename":]line|error|warning|trace| function
Set a breakpoint (same as break).

tbreak ["filename":]line|function
Set a temporary breakpoint

thread [n]
Change the active thread to thread #n (0 is the main program's thread number).

threads
List the currently active TLC execution threads.

tstop ["filename":]line|function
Set a temporary breakpoint

up [n]
Move up the stack.

where
Show the currently active execution chains.

which name
Look up the name and display what scope it comes from.

whos [::|expression]
List the variables in the given scope.

Table 7-1: **TLC Debugger Commands**
Command	Description
`assign variable=value`	Change a variable in the running program.
`break ["filename":]line\|error\|warning\|trace\| function`	Set a breakpoint. See also %breakpoint Directive
`clear [breakpoint#\|all]`	Remove a breakpoint.
`condition [breakpoint#] [expression]`	Attach a condition to a breakpoint
`continue ["filename":]line\|function`	Continue from a breakpoint.
`disable [breakpoint#]`	Disable a breakpoint.
`down [n]`	Move down the stack.
`enable [breakpoint#]`	Enable a breakpoint.
`finish`	Break after completing the current function
`help [command]`	Obtain help for a command.
`ignore [breakpoint#]count`	Set the ignore count of a breakpoint
`iostack`	`Display contents of I/O stack`
`list start[,end]`	List lines from the file from start to end.
`loadstate "filename"`	`Load debugger breakpoint state from a file`
`next`	Single step without going into functions.
`print expression`	Print the value of a TLC expression. To print a record, you must specify a fully qualified "scope" such as `CompiledModel.System[0].Block[0]`.
`quit`	Quit the TLC debugger. You can also exit the debugger by typing Ctrl + C at the prompt.
`run "filename"`	`Run a batch file of command line debugger commands`
`savestate "filename"`	`Save debugger breakpoint state to a file`
`status`	Display a list of active breakpoints.
`step`	Step into.
`stop ["filename":]line\|error\|warning\|trace\| function`	Set a breakpoint (same as `break`).
`tbreak ["filename":]line\|function`	Set a temporary breakpoint
`thread [n]`	Change the active thread to thread `#n` (0 is the main program's thread number).
`threads`	List the currently active TLC execution threads.
`tstop ["filename":]line\|function`	Set a temporary breakpoint
`up [n]`	Move up the stack.
`where`	Show the currently active execution chains.
`which name`	Look up the name and display what scope it comes from.
`whos [::\|expression]`	List the variables in the given scope.

%breakpoint Directive

As an alternative to the break command, you can embed breakpoints at any point in a TLC file by adding the directive:

```
%breakpoint
```

Usage Notes

When using break or stop, use

error to break or stop on error
warn to break or stop on warning
trace to break or stop on trace

For example, if you need to break in gain.tlc on error, use

```
TLC_DEBUG> break "gain.tlc":error
```

When using clear, get the status of breakpoints using status and clear specific breakpoints. For example:

TLC-DEBUG> break "gain.tlc":46
TLC-DEBUG> break "gain.tlc":25
TLC-DEBUG> status
Breakpoints:
[1] break File: gain.tlc Line: 46
[2] break File: gain.tlc Line: 25
TLC-DEBUG> clear 2

In this example, clear 2 clears the second breakpoint.

Using the TLC Debugger TLC Coverage