MPE/iX Intrinsics Reference Manual (32650-90905)

Chapter 10 617
Command Definitions (QUIT-ZSIZE)
STACKDUMP
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.
(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.