This section describes commands which do not properly
belong to any other section of the document.


ENDVARS %variable_1 [%variable_2 [...%variable_9] ]

This little-used command informs Scripta that certain
variables are no longer required and that the memory they
occupy may be released for other purposes. No matter what
value is actually stored within a variable, it occupies
200 bytes of memory so even if you used all the available
(300) variables, they would still only occupy 60 Kb. Most
scripts use from zero to ten variables.

The syntax

         ENDVARS ALL

may be used to release all current variable storage.

ENDVARS ALL is executed automatically whenever a top-level
script terminates.


COMMAND

The COMMAND command places Scripta into Modem Command
Mode.

The current script is suspended and any data to be sent to
the remote computer must henceforth be entered manually.

When in Modem Command Mode, you 'talk' directly to your
modem whilst not connected and to the remote computer when
a connection has been made.

You may return to execution of the script by pressing F2.
Pressing Esc quits Scripta and returns to DOS.

F2 is actually a toggle. If you press it when a script is
running, you enter Command Mode; if you press it
subsequently, whilst still in Command Mode, you will
return to script processing.

DEC %int_variable <value>

Subtracts <value> (which may be any expression) from
%int_variable. This is considerably faster than the
equivalent

              %int_variable := %int_variable-<value>

<value> may be any expression, which elaborates to an
INTEGER value, either positive or negative.

If <value> is omitted, it defaults to 1.


PAUSE <duration_in_milliseconds>

Stops script processing for the specified duration.


SHELL <DOS_command>

This command opens a new full-screen window and then
causes DOS to execute <DOS_command>.

If <DOS_command> is omitted, Scripta shells to DOS and
allows you to enter DOS commands manually. When you have
finished, enter the command EXIT to return to your Scripta
script.

If <DOS_command> starts with a ! (exclamation mark)
character then the character is removed before the command
is executed and Scripta waits for a key-press before
closing the shell window when the command finishes
executing.

SOUND <frequency_in_Hertz> <duration_in_milliseconds>

Activates your computer's loudspeaker and issues a sound
at the specified frequency, for the specified duration.

As an example, the Scripta CONNECT beep is equivalent to

                   SOUND 140 100

The lowest frequency usable on most computers is somewhere
between zero and 20. The highest about 8000.

INC %int_variable <value>

Adds <value> (which may be any expression) to
%int_variable. This is considerably faster than the
equivalent

              %int_variable := %int_variable+<value>

<value> may be any expression, which elaborates to an
integer value, either positive or negative.

If <value> is omitted, it defaults to 1.
