 |
» |
|
|
|
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-18 “HPDEBUG Itemnum/Item Values”.
- item
type varies by value (optional) Passes the information specified in itemnum, refer to Table 4-18 “HPDEBUG Itemnum/Item Values”.
Table 4-18 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)
|
