HP 3000 Manuals HP 3000 Manuals
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
(32650-90066, 32650-90152, and 32650-90368) 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 4-17 .
item type varies by value (optional)
Passes the information specified in itemnum, refer
to Table 4-17 .
Table 4-17. HPDEBUG Itemnum/Item Values
-----------------------------------------------------------------------------------------------
| | | |
| Itemnum | Mnemonic | Item Description |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| 1 | I32 | Output file number: |
| | | |
| | | Passes an opened file number where all output generated by Debug is |
| | | sent. It must be an ASCII file with write access. The value 1 is |
| | | valid and specifies that $STDLIST is used. |
| | | |
| | | Default: Terminal LDEV for sessions and $STDLIST for jobs. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| 2 | I32 | Welcome banner flag: |
| | | |
| | | Passes a value indicating whether the Debug welcome banner is printed |
| | | or not. A value of 0 indicates do not print the welcome banner. Any |
| | | other value causes the welcome banner to be displayed. |
| | | |
| | | Default: Print welcome banner (1) |
| | | |
-----------------------------------------------------------------------------------------------
Operation Notes
The HPDEBUG intrinsic calls the system debugger with an optional
character array containing Debug commands. This option distinguishes
HPDEBUG from the DEBUG intrinsic. If the command list is defined, the
debugger pushes the commands onto its command stack and executes them.
If no command in the command string causes control to be returned to the
calling procedure (for example, a CONTINUE command), the user is left in
the debugger as long as the process is being run from a session
environment. Processes run from a job are not allowed to stop in the
system debugger. If the command string does cause control to return to
the calling procedure, any remaining commands are left pending on the
debugger's command stack to be executed the next time the debugger is
called.
Related Information
Intrinsics DEBUG, HPSETDUMP, STACKDUMP
Commands DEBUG
Manuals MPE/iX System Debug Reference Manual (32650-90013)