EC - execute a file of TSS commands.

A better idea is to use EXEC. See "expl exec" and "expl _sysfiles convert".

EC <pathname> arg1 arg2 ... arg20

optional arguments arg1,...,arg20 are parameter strings separated by blanks.

The EC command is useful for grouping commands to form a macro command. The following directives may be placed in the file and acted on by EC:

&print

print remainder of line as comment

&list

print commands before execution

&nlist

don't print commands (default)

&quit

terminate execution

&begin

rewind file before searching for label

&rest

don't rewind file before search (default)

&label

define label

&catch

define a label to match anything (i.e. force here)

&goto

transfer to label card

&read

read argument nn from terminal; for example,

read 2

will read a string from the terminal and this string may thereafter be referred to as "&2".

&ifeq

compare two strings (one may be &nn) and if equal go to label; for example,

&ifeq &1 linked label1

compares arg1 to "linked" and if equal, transfers to label "label1".

&break on

stop the user from breaking out of the command

&break off

allow the user to break out

Any other line with an & will be ignored. The character sequence &nn will be treated as an argument to be replaced by "argnn" from the command line.

There are two commands intended to aid debugging of "ec" files:

&trace: prints the expanded version of the command line before it is executed.
&notrace: disables tracing