System Debug Reference Manual (32650-90888)

Chapter 3 59
System Debug Interface Commands and Intrinsics
HPDEBUG Intrinsic
debug;
END;
HPDEBUG Intrinsic
Enters Debug and optionally executes a specified set of system Debug commands.
Callable from: NM
Syntax
HPDEBUG ( status, cmdstr [,itemnum, item] [...] );
Parameters
status 32-bit signed integer by reference (optional)
The status returned by the HPDEBUG intrinsic call. The variable is a record
containing two 16-bit fields, with the error number in the high-order 16
bits and the intrinsic subsystem number in the low-order 16 bits.
cmdstr character array (optional)
A packed array of characters from 255 to 1024 bytes that contains the
Debug commands to be executed. The first character in the array is
recognized as the command delimiter. The last character in the command
string must be followed immediately by the same delimiter.
itemnum 32-bit signed integer by value (optional)
The item number of an HPDEBUG option as defined in the following HPDEBUG
options.
item type varies by value (optional)
Passes and/or returns the HPDEBUG option indicated by the corresponding
itemnum parameter. The itemnum/item optional parameters must appear
in pairs. You can specify any number of option pairs. Any
itemnum takes
precedence over any previously specified duplicate
itemnum . The following
discussion lists the optional
itemnum/item parameter pairs available to
you.
itemnum =1 Output file number (I32)
Passes an item value specifying an opened file number to
which DEBUG output is sent. The file must be a writeable
ASCII file. The item value 1 is valid and specifies that
$STDLIST will be used. Default: Use terminal LDEV for
sessions and $STDLIST for jobs.
itemnum =2 Welcome Banner Flag (I32)