Inspect Manual

Debugging Processes and Save Files
Inspect Manual—429164-006
4-8
Preparing and Configuring for Process Debugging
RUN[D] and #NEWPROCESS. When you start a process using the RUN[D] command
or the #NEWPROCESS built-in function, the Inspect state of the command interpreter
session determines the attribute values of the start-up command. The Inspect state
has one of three values: OFF, ON, or SAVEABEND. These state values correspond to
these debugging attribute values:
You can control the value of the Inspect state using the SET INSPECT command, or
you can override the default state value in the RUN command itself with the Inspect
run-option. For more information, see the TACL Reference Manual.
NEWPROCESS, NEWPROCESSNOWAIT, PROCESS_CREATE_, and
PROCESS_LAUNCH_. These system procedure calls enable an existing process to
create a process. All these procedures include a parameter that contains bits
corresponding to the INSPECT and SAVEABEND debugging attributes for the call. To
find out how to set these bits, see the Guardian Procedure Calls Reference Manual.
Preparing and Configuring for Process Debugging
To use all the symbolic debugging capabilities of Inspect, you must ensure that your
program file includes symbol information. Consequently, you must include the
SYMBOLS compiler directive in the source code or on the command line when you
compile the source code.
Starting a Debugging Session
A process debugging session can start in several ways, as shown in the following list.
The first two methods shown start a process in the hold state. All the other methods
put a running process in the hold state.

You enter a command interpreter RUND command, starting the process in the hold
state.

An existing process invokes the NEWPROCESS, NEWPROCESSNOWAIT,
PROCESS_CREATE_, or PROCESS_LAUNCH_ procedure with the debug bit set,
starting the process in the hold state.

You enter a command interpreter DEBUG command, putting a running process in
the hold state.

You use the TACL #DEBUGPROCESS built-in function, putting a running process
in the hold state.
Inspect State Debugging Attribute Values
OFF INSPECT OFF, SAVEABEND OFF
ON INSPECT ON, SAVEABEND ON
SAVEABEND INSPECT ON, SAVEABEND ON