Inspect Manual

Debugging Processes and Save Files
Inspect Manual429164-006
4-9
Starting a Debugging Session
A process invokes the DEBUGPROCESS procedure, putting another process in
the hold state.
The process itself invokes the operating system software's Debug procedure,
putting itself in the hold state.
The process encounters a trap for which it does not have a trap handler, putting
the process in the hold state.
RUND, NEWPROCESS, NEWPROCESSNOWAIT,
PROCESS_CREATE_, or PROCESS_LAUNCH_
When you start a process using the TACL RUND command, or when an existing
process starts a process using the NEWPROCESS, NEWPROCESSNOWAIT,
PROCESS_CREATE_, or PROCESS_LAUNCH_ procedure, the operating system
starts the process in the hold state. The system then starts the debugging tool
specified by the Inspect attribute of the process on the process's home terminal. For
more information about debugging attributes and how the operating system sets them,
see The Debugging Attributes of a Process on page 4-4.
When entering the RUND command, you can ensure that the operating system
software selects Inspect as the debugging tool with the Inspect run-option:
You don't need to include this option if the Inspect attribute of the program file is ON, or
if the Inspect state of the command interpreter session is ON or SAVEABEND (you can
check the Inspect state using the command interpreter SHOW INSPECT command).
When invoking NEWPROCESS, NEWPROCESSNOWAIT, PROCESS_CREATE_, or
PROCESS_LAUNCH_, an existing process can ensure that the operating system
selects Inspect as the debugging tool by setting the appropriate bit of the flags
parameter in the call. The process does not need to set this bit if the Inspect attribute
of the program file is ON.
DEBUG Command, #DEBUGPROCESS, and
DEBUGPROCESS
When you enter the command interpreter DEBUG command or use the TACL
#DEBUGPROCESS built-in function, or when a process invokes the
DEBUGPROCESS procedure, a debug event occurs for the specified process.
Note. A process must exit out of system code before it enters the HOLD state.
17> RUND program-file /INSPECT ON/