MPE/iX Intrinsics Reference Manual (32650-90905)

340 Chapter7
Command Definitions (HP32208-HPLOACNMPROC)
HPDEBUG
HPDEBUG
NM callable only.
Enters the system debugger and optionally executes a defined set of system debug
commands.
Syntax
I32 CA I32V *
HPDEBUG(
status,cmdstr [, itemnum,item ][...]);
Parameters
status 32-bit signed integer by reference (optional)
Returns the status of the HPDEBUG call. If no errors or warnings are
encountered,
status returns 32-bits of zero. If errors or warnings are
encountered,
status is interpreted as two 16-bit fields:
Bits (0:16) comprise
status.info . A negative value indicates an error
condition, and a positive value indicates a warning condition. Refer to the
MPE/iX Error Message Manual Volumes 1, 2 and 3 for a description of its
value.
Bits (6:16) comprise
status.subsys . The value represents the subsystem
that sets the status information. The subsystem identifier for HPDEBUG is
165.
cmdstr character array (optional)
Passes an array of <=1024 characters containing the system debugger
commands. The first character in the buffer is recognized as the delimiter.
The last character in the command string must be immediately followed
by that same delimiter.
This command string is executed when the system debugger is called:
• For processes in jobs, process execution is resumed when the command
string is exhausted.
• For processes in sessions, control remains in the debugger unless
cmdstr contains a CONTINUE command.
itemnum 32-bit signed integer by value (optional)
Passes an item number indicating the
item , refer to Table 7-11.,
“HPDEBUG Itemnum/Item Value,” on page 341.
item type varies by value (optional)
Passes the information specified in
itemnum , refer to Table 7-11.,
“HPDEBUG Itemnum/Item Value,” on page 341.