COMMAND NAME:

        ON

USAGE:

        ON <exception> <action>

        where <exception> is one of ERROR, BREAKPOINT or CONTENTION and
        <action> is one of PAUSE, STOP, NEXT or CONTINUE.

        The ON statement lets you specify how the SCL interpreter is to
        handle certain exception conditions.  The default action for all
        exceptions is CONTINUE.

        exceptions:

                ERROR

                    An error is any syntax or runtime error

                BREAKPOINT

                    A breakpoint exception occurs any time a breakpoint
                    condition becomes true.  This can only happen when a
                    SIMULATE command is executing.

                CONTENTION

                    A contention exception occurs whenever the simulator
                    determines a net is being driven by more than one driver
                    simultaneously.  See the SET CONTENTION command for
                    details on how the simulator deals with net contention.

        actions:

                PAUSE

                    A pause action is the same as a pause command.  An
                    interactive context is pushed on the context stack
                    thereby returning control to the keyboard.  

                STOP

                    The interpreter will kill the executing script and
                    return control to the previous interactive context.
                    It's like executing a POP command.

                NEXT

                    The interpreter will continue execution with the next
                    statement in the script.

                CONTINUE

                    The interpreter will attempt to continue execution with
                    the same statement.  This doesn't mean that it will
                    re-execute the statement only that it will attempt to
                    keep going to finish the work initiated by the current
                    statement.  For example, the SIMULATE command will
                    continue simulating the remainder of the time interval.

SEE ALSO:

        SET CONTENTION
        RESUME
        POP
        SCRIPT
