 |
» |
|
|
|
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 - Manuals
MPE/iX System Debug Reference Manual (32650-90013)
|
