include

Execute emulator commands from a text file.

Syntax

include [nolist] filename

Where:

nolist	suppresses the echoing of commands to the Command window.  Nolog has the same effect as nolist.
filename	specifies a filename.  See Filenames for details.

Discussion

Use the include command to cause the emulator input to be taken from the named text file. For example, use the include command to do the following:

• Load debug procedures (procs), such as pre-defined sets of tests

• Create debug variables and execute commands

• Create literally (alias) definitions

The output of the include command is the same as if the commands had been directly entered in the Command window. With the nolist option, command echoing is suppressed, but the responses are still displayed. Error messages are displayed if errors occur while processing a command in the file. If the error is severe, inclusion of the file and any nested include files is terminated.

Press Ctrl-Break to abort execution of an include file.

Note:  If an include command appears on a line with multiple commands, it must be the last command on the line. If an include command appears within a block (for, if, etc.) or proc, it must be the last command in the block.

Note: The emulator displays a syntax error when the include command processes an undefined debug variable. Define all debug variables before referencing.

Example 1

To include a file without echoing commands to the screen:

Command input:

include nolist myfile.mac

Example 2

To include a file and echo the commands to the Command window:

Command input:

include myfile.mac

Related Topics:

Command Window Introduction