|
|
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".
- item
type varies by value (optional)
Passes the information specified in itemnum, refer to
Table 7-11 "HPDEBUG Itemnum/Item
Value".
Table 7-11 HPDEBUG Itemnum/Item Value
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
|