HP 3000 Manuals HP 3000 Manuals
STACKDUMP
NM and CM callable (differences noted below).
Calls the system debugger to send a stack trace to $STDLIST or to the
file specified in the formaldesig parameter. Control then returns to the
calling procedure.
Syntax
(NM and CM)
___________________________________________________
| |
| CA I16V I16V I32 |
| STACKDUMP(formaldesig,idnumber,flags,selec);|
___________________________________________________
(CM: SPL language only)
____________________________________________________
| |
| CA I16V I16V I32 |
| STACKDUMP'(formaldesig,idnumber,flags,selec);|
____________________________________________________
Parameters
formaldesig character array (optional)
Passes the file name of a new output file to be
opened. The name is terminated by any
nonalphanumeric character except a slash (/) or a
period (.). The same restrictions for the
formaldesig parameter in the FOPEN intrinsic apply
to this parameter.
(CM: SPL language only) If the secondary entry
point, STACKDUMP', is used, the first byte of
formaldesig contains the file number that was
successfully opened prior to the call to
STACKDUMP'. In this case, the file is not closed
before returning to the calling program. When a
file number is passed, the record length must be
between 64 bytes and 512 bytes and write access
must be allowed for the file.
Default: Dump is sent to $STDLIST.
idnumber 16-bit signed integer by value (optional)
If the intrinsic fails due to a file system error,
the file system specific error number of the
failure is returned here. Any value passed into
the intrinsic through this parameter is ignored.
flags 16-bit unsigned integer by value (optional)
This parameter is provided for compatibility with
MPE V/E. If it is present, it is ignored and has no
effect.
selec 32-bit integer array by reference (optional)
This parameter is provided for compatibility with
MPE V/E. If it is present in the intrinsic call, it
is ignored and has no effect.
Condition Codes
CCE (2) Request granted.
CCG (0) Request denied. An invalid address for the
location of the formaldesig parameter was detected.
CCL (1) Request denied. File system error occurred during
opening, writing to, or closing the file. The file
error number is returned in idnumber.
Related Information
Intrinsics DEBUG, HPDEBUG, HPRESETDUMP, HPSETDUMP, SETDUMP
Commands SETDUMP
Manuals MPE/iX System Debug Reference Manual (32650-90013)