7.0;dq (debug_quit) *DM*, revision 7.0, 83/08/10
DQ (DEBUG_QUIT) -- Generate a quit fault in a process.
usage: dq [-c | -s | -b]
FORMAT
DQ [options]
The DQ command generates a quit fault, which normally interrupts execution of
the current program and returns the process to the calling program (usually
the Shell). This command affects the process associated with the window that
contains the cursor. By default, CTRL/Q invokes DQ without options to
generate a normal quit fault in the program currently running.
OPTIONS
If no options are specified, then DQ generates a normal quit fault and halts
whatever program is currently running.
-C nn Generate an arbitrary asynchronous fault with the specified
hexadecimal status (nn).
-S Stop entire process in a controlled way, if possible.
Close open streams, files, pads, etc. The Shell's parent
process is stopped and closed, too.
-B Blast process; do not execute further user mode
instructions.
NOTE: If you are trying to stop a Shell's parent process (as opposed to some
program running within a Shell), there is an easier method than typing
DQ -S. Position the cursor in the Shell's process input window and
issue an EEF (END_OF_FILE) command (by default, CTRL/Z). This signals
completion of input, and stops both the Shell and the process. Type
HELP EEF for more information.
RELATED TOPICS
More information is available. Type:
- HELP DS
for details about suspending a process
- HELP DC
for details about restarting a suspended process
- HELP EEF
for details about stopping a Shell and its process