|
|
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.
(NM and CM)
Syntax
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
- Manual
MPE/iX System Debug Reference Manual
|