Command: exec

Syntax

exec { <file> }

Description

Execute a command macro.

Parameters

• <file>
  The file name of the macro to be executed. The default file extension is .cmd. Parameters may be passed to the macro within parentheses.

• none
  When in keyboard interrupt mode, continue execution of the currently suspended macro, otherwise take no action.

Switches

• -ca
  Enter the macro in the macro cache. Once a macro is resident in the cache it will execute more quickly. If the macro is already in the cache this switch is ignored.

• -e
  Echo commands as they are processed. If omitted, echoing will be inherited from the currently executing macro.

• -r
  Replace mode. If the macro is currently resident in the macro cache, that version is overwritten by a new version. This is only useful when the macro has been externally edited and the cached version needs to be updated. If the macro is not currently in the cache, this switch is ignored.

• -sc
  Maintain the local scope of the currently executing macro. If omitted, the new macro will have its own local scope.

• -st
  Step through commands as they are processed. If omitted, stepping will be inherited from the currently executing macro.

Notes

Echoing and stepping can also be switched on and off by the system numerics echoing and stepping.

A macro may be removed from the macro cache by the uncache command.

Examples

Execute a macro (my_macro.cmd).

exec my_macro

Execute a macro (determine.cmd) with parameters.

exec determine(x,y)

Return to a suspended macro (when in interrupt mode).

exec

Execute with command echoing.

exec state2, -e

Execute with no command stepping.

exec state2, -no_st

See Also