SIGNAL -- Simulates a fault.
FORMAT
SIGnal status
REQUIRED ARGUMENTS
none If you do not specify an argument, DEBUG supplies the default
status code which equals a quit fault.
OPTIONAL ARGUMENTS
status the numeric status code for the fault to be simulated. By
default, DEBUG assumes that you are entering a decimal
(base 10) integer. However, you can enter a number in
octal or hexadecimal by preceding it with 8# or 16#, re-
spectively.
DESCRIPTION
Use this command to simulate a particular fault at the current point of
execution. DEBUG responds with its normal fault message and invokes the
`FAULT_ACTION macro (if it is defined). If you continue execution with
the GO -Cleanup command, DEBUG will invoke program fault handling for
the specified fault as described in the "Faults" section of the manual.
DEBUG signals an error if you issue this command while the target program
is stopped for a fault.
For full details, see Chapter 3 of the DOMAIN Language Level Debugger
Reference manual.