Command Files

Command files are text files containing multiple commands.  Creating command files helps to automate oft repeated operations.  Command files are also referred to as macro files, script files or include files.  There are several ways to execute a command file:

1. Use the include command in the Command window.

2. Drag and drop a command file from Windows Explorer to the Command window.

3. Select File | Macro | Load Macro from the main menu.

4. Select File | Macro | Configure Macros to attach a command file to a user-defined toolbar button, and then press the button.

5. Select File | Macro | Configure Macros to attach a command file to an event.  Examples of events include: go, stop, project load, power cycle, etc.  When the event occurs the macro will automatically execute.

6. Define a breakpoint and specify a command file to execute when the breakpoint hits.

Recently executed macro files are shown in File | Recent Macros.  Selecting a command file from this list will re-execute the file.  Breakpoint and event macros are excluded from this list.

When a command file is executing, the name of the file is shown in the SourcePoint Status bar (at the bottom of the SourcePoint window).

Note:  When SourcePoint finishes executing a command from a file, it immediately begins to execute the next command.  In the case of the go command this may not be desired.  To delay execution of the command file until a breakpoint hits, you must use the wait command.