Guardian Procedure Calls Reference Manual

PROCESS_DEBUG_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
OSS Considerations
Example
Related Programming Manual
Summary
The PROCESS_DEBUG_ procedure invokes the debugging facility on the calling process or on
another process.
The operating system provides a debugging facility that responds to debug events by passing
control to one of two debugging utilities: Debug or Inspect. Debug is a low-level debugger. Inspect
is an interactive symbolic debugger that lets you control program execution, display values, and
modify values in terms of source-language symbols.
Syntax for C Programmers
#include <cextdecs(PROCESS_DEBUG_)>
short PROCESS_DEBUG_ ( [ short *processhandle ]
,[ const char *terminal-name ]
,[ short length ]
,[ short now ] );
• The parameter length specifies the length in bytes of the character string pointed to by
terminal-name. The parameters terminal-name and length must either both be supplied
or both be absent.
Syntax for TAL Programmers
error := PROCESS_DEBUG_ ( [ processhandle ] ! i
,[ terminal-name:length ] ! i:i
,[ now ] ); ! i
Parameters
processhandle
input
INT .EXT:ref:10
is the process handle of the process to be debugged. If processhandle is omitted or null,
the calling process is to be debugged. The null process handle is one which has -1 in each
word. (For details, see the PROCESSHANDLE_NULLIT_ Procedure (page 1140).) However,
PROCESS_DEBUG_ also treats a process handle with -1 in the first word as a null process
handle.
PROCESS_DEBUG_ Procedure 999