Guardian Procedure Calls Reference Manual

• In addition to placing an explicit call to the PROCESS_DEBUG_ (or DEBUG) procedure in the
source program, you can force a process into the debug state by:
◦ Starting the process using the TACL RUND (RUN DEBUG) command. The process enters
the debug state before the first instruction of the MAIN procedure executes.
◦ Starting the process with a call to PROCESS_CREATE_, PROCESS_SPAWN_,
NEWPROCESS, NEWPROCESSNOWAIT, OSS tdm_fork(), OSS tdm_spawn(), or
one of the OSS tdm_exec set of functions, and setting the appropriate option. The
process enters the debug state before the first instruction of the MAIN procedure executes.
◦ Starting the process from the command interpreter. While the process is executing, press
the BREAK key. The command interpreter returns to the command input mode. Find the
cpu,pin of the process and type in DEBUG cpu,pin, or find the name of the process
(if it is named) and type in DEBUG process-name.
◦ Issuing a DEBUG command to a command interpreter on another local terminal while
the process is executing. Find the cpu,pin of the process and type in DEBUG cpu,pin,
or find the name of the process (if it is named) and type in DEBUG process-name.
◦ Specifying a breakpoint when a process is in the debug state. When the breakpoint is
reached, the process enters the debug state.
◦ Issuing a DEBUG command to a TACL process running at another local terminal.
• You can use Inspect by setting the Inspect attribute associated with a process. The value of a
process' Inspect attribute can be set with:
◦ The ?INSPECT or ?SAVEABEND TAL compiler directive
◦ The nld -SET INSPECT or -SET SAVEABEND flags during a linking session
◦ The Binder SET INSPECT or SET SAVEABEND commands during a binding session
◦ The TACL SET INSPECT command before the RUN command that starts the process
◦ The INSPECT command of the RUN command that starts the process
◦ The appropriate option in the PROCESS_CREATE_, PROCESS_SPAWN_, NEWPROCESS,
NEWPROCESSNOWAIT, OSS tdm_fork(0, OSS tdm_spawn(), or one of the OSS
tdm_exec set of functions.
• Processes inherit the Inspect attribute from their ancestor processes.
• Calling PROCESS_DEBUG_ and passing no parameters (or specifying only the caller's process
handle) is not the exact equivalent of calling the DEBUG procedure. Some processes (in
particular, system processes) would need to specify the now parameter as equal to 1 (the
default is 0). DEBUG, which has no now parameter, functions as if it had a now parameter
set equal to 1.
In general, the preferred method for a process to invoke the debug facility on itself is to call
DEBUG rather than to call PROCESS_DEBUG_.
PROCESS_DEBUG_ Procedure 1001